index :: net

net.mdns

обнаружение служб MDNS

доступно с версии: 0.9.8

---

информация

Service '.local.' domain suffix is optional and can be omitted. There are service aliases: #osc - instead of '_osc._udp.local', #http - '_http._tcp.local', #all - to subscribe to all available services on the network. Note: on close object will automatically unregister any previously registered services. Note: the #all service is the special case - it will output all available network service names with format [service SERVICE(

методы:

• ifaces output available network interfaces and their info
  

• register register MDNS service instance. Instance will be available with DNS name NAME.local
  параметры:

  • SERVICE service name, for example: _osc._tcp, or alias: #osc
    тип: symbol
    обязательно: True
    

  • NAME instance name, for example: MY_SUPER_SERVER
    тип: symbol
    обязательно: True
    

  • PORT instance port
    тип: int
    обязательно: True
    

  • [PROPS] list of text props (TXT record), for example: @prop1 FOO @prop2 BOO will have TXT records prop1=FOO prop2=BAR
    тип: list
    

• resolve does mDNS name resolving: get service information: host, ip, port etc by SERVICE type and INSTANCE name
  параметры:

  • SERVICE service name, for example: _osc._tcp, or alias: #osc or #http
    тип: symbol
    обязательно: True
    

  • NAME instance name, for example: MY_SUPER_SERVER
    тип: symbol
    обязательно: True
    

• subscribe subscribe to service events: add, remove and resolve
  параметры:

  • SERVICE service name, for example: _osc._tcp, or alias: #osc or #all
    тип: symbol
    обязательно: True
    

  • [ON=true] if true: subscribe, false: unsubscribe
    тип: bool
    

• unregister manually unregister service instance.
  параметры:

  • SERVICE service name, for example: _osc._tcp, or alias: #osc
    тип: symbol
    обязательно: True
    

  • NAME instance name, for example: MY_SUPER_SERVER
    тип: symbol
    обязательно: True
    

• unsubscribe unsubscribe from specified service events
  параметры:
  • SERVICE service name, for example: _osc._tcp, or alias: #osc or #all
    тип: symbol
    обязательно: True
    

свойства:

• @fullname Запросить/установить if true: output full instance name (with service and domain suffix), for ex.: 'THE_SERVICE.xx.local.' format
  _тип: bool
  по умолчанию: 1
  

• @ip Запросить/установить restrict addresses by type
  тип: symbol
  варианты: v4, v6, any
  по умолчанию: v4
  

входы:

• input
  тип: control

выходы:

• add SERVICE NAME, remove SERVICE NAME, service add|remove SERVICE, resolve SERVICE NAME HOST PORT IP PROPERTIES
  тип: control

ключевые слова:

net zeroconf bonjour avahi mdns service discovery

Авторы: Serge Poltavsky

Лицензия: GPL3 or later