NsdManager

public final class NsdManager
extends Object

网络服务发现管理器类提供API来发现网络上的服务。 例如，如果设备A和设备B通过Wi-Fi网络连接，则设备A上注册的游戏可以通过设备B上的游戏发现。另一个示例用例是发现网络上打印机的应用程序。

该API当前支持基于DNS的服务发现，并且发现目前仅限于通过多播DNS的本地网络。 在http://files.dns-sd.org/draft-cheshire-dnsext-dns-sd.txt中描述了DNS服务发现

API是异步的，对来自应用程序的请求的响应是在单独线程上的侦听器回调。

API支持三种主要操作 - 注册，发现和解析。

                          Application start
                                 |
                                 |
                                 |                  onServiceRegistered()
                     Register any local services  /
                      to be advertised with       \
                       registerService()            onRegistrationFailed()
                                 |
                                 |
                          discoverServices()
                                 |
                      Maintain a list to track
                        discovered services
                                 |
                                 |--------->
                                 |          |
                                 |      onServiceFound()
                                 |          |
                                 |     add service to list
                                 |          |
                                 |<----------
                                 |
                                 |--------->
                                 |          |
                                 |      onServiceLost()
                                 |          |
                                 |   remove service from list
                                 |          |
                                 |<----------
                                 |
                                 |
                                 | Connect to a service
                                 | from list ?
                                 |
                          resolveService()
                                 |
                         onServiceResolved()
                                 |
                     Establish connection to service
                     with the host and port information

 

查找http服务的对等应用程序可以通过调用discoverServices(String, int, NsdManager.DiscoveryListener)来启动“_http._tcp”的发现。 找到的服务将通过回拨通知到onServiceFound(NsdServiceInfo)并通过onServiceLost(NsdServiceInfo)通知服务丢失。

一旦对等应用程序发现“示例”http srevice并需要从“示例”应用程序接收数据，它就可以通过resolveService(NsdServiceInfo, NsdManager.ResolveListener)解析主机和端口详细信息以建立连接。 一个成功的决心通知上onServiceResolved(NsdServiceInfo)和故障通知上onResolveFailed(NsdServiceInfo, int) 。 应用程序可以在http://www.iana.org/form/ports-service预订服务类型。 可以在http://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.xml找到现有的服务。通过调用Context.getSystemService(Context.NSD_SERVICE)获得此类的一个实例。

Summary

Inherited methods

From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法，或者其他某个线程中断当前线程或经过一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法或经过了指定的时间量。 final void wait() 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法。

Constants

String ACTION_NSD_STATE_CHANGED

String EXTRA_NSD_STATE

int FAILURE_ALREADY_ACTIVE

int FAILURE_INTERNAL_ERROR

int FAILURE_MAX_LIMIT

int NSD_STATE_DISABLED

int NSD_STATE_ENABLED

int PROTOCOL_DNS_SD

Public methods

void discoverServices (String serviceType, 
                int protocolType, 
                NsdManager.DiscoveryListener listener)

void registerService (NsdServiceInfo serviceInfo, 
                int protocolType, 
                NsdManager.RegistrationListener listener)

void resolveService (NsdServiceInfo serviceInfo, 
                NsdManager.ResolveListener listener)

void stopServiceDiscovery (NsdManager.DiscoveryListener listener)

void unregisterService (NsdManager.RegistrationListener listener)