chrome/common/extensions/api/mdns.idl

   1 // Copyright 2013 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 // Use the <code>chrome.mdns</code> API to discover services over mDNS.
   6 // This comprises a subset of the features of the NSD spec:
   7 // http://www.w3.org/TR/discovery-api/
   8 namespace mdns {
   9
  10   // Represents a mDNS/DNS-SD service.
  11   dictionary MDnsService {
  12     // The service name of an mDNS advertised service,
  13     // <instance_name>.<service_type>.
  14     DOMString serviceName;
  15
  16     // The host:port pair of an mDNS advertised service.
  17     DOMString serviceHostPort;
  18
  19     // The IP address of an mDNS advertised service.
  20     DOMString ipAddress;
  21
  22     // Metadata for an mDNS advertised service.
  23     DOMString[] serviceData;
  24   };
  25
  26   interface Properties {
  27     // The maximum number of service instances that will be included in
  28     // onServiceList events.  If more instances are available, they may be
  29     // truncated from the onServiceList event.
  30     [value=64] static long MAX_SERVICE_INSTANCES_PER_EVENT();
  31   };
  32
  33   interface Events {
  34     // Event fired to inform clients of the current complete set of known
  35     // available services. Clients should only need to store the list from the
  36     // most recent event. The service type that the extension is interested in
  37     // discovering should be specified as the event filter with the
  38     // 'serviceType' key. Not specifying an event filter will not start any
  39     // discovery listeners.
  40     [supportsFilters=true, maxListeners=10] static void onServiceList(MDnsService[] services);
  41   };
  42 };