Training->Using Network Service Discovery

在你的应用中增加Network Service Discovery(NSD), 可以让你的用户在同一个网络中找到需求的服务。这对各种点对点的应用非常有用，例如文件共享或者多人一起游戏。Android  NSD的API可以让你轻易的实现这些功能

这一课教大家如何去广播自己设备服务的名字和网络信息，如何去获取其他设备服务的名字和网络信息。最后讲的是，如何使用不同的设备连接到同一个使用中。

Register Your Service on the Network

 注：这一步是可选的。如果你不需要广播你的服务信息，可以跳过这一步，直接到下一个章节Discover Services on the Network.

要在局域网络中，注册一个服务，首先要创建一个NsdServiceInfo 对象，这个对象为其他设备提供连接信息，如服务名、IP和端口号。

public void registerService(int port) {    // Create the NsdServiceInfo object, and populate it.    NsdServiceInfo serviceInfo  = new NsdServiceInfo();    // The name is subject to change based on conflicts    // with other services advertised on the same network.    serviceInfo.setServiceName("NsdChat");    serviceInfo.setServiceType("_http._tcp.");    serviceInfo.setPort(port);    ....}

这个代码片段把服务的名字设成NsdChat。这个名字对局域网中其他使用NSD查找设备的服务是可见的。在局域网中，这个名字是唯一的，Android会自动处理名字冲突。如果两个名字冲突，例如两个名字都位NsdChart，其中一个就会被改成NsdChart(1)
第二个参数设置服务的类型，指定服务使用哪种协议和传输层。语法是"_<protocol>._<transportlayer>。在上面的代码片段中，服务使用的是TCP HTTP协议。如果一个提供打印服务的应用，它的类型将会设成 "_ipp._tcp".

注：国际号码分配机构（IANA）负责管理NSD和Bonjour发现协议的所有服务类型。可以到 theIANA list of service names and port numbers下载服务类型的列表。如果你需要使用一个新的服务类型，你应该通过填写IANA端口和服务登记表保留它。

当为你的服务设置端口号时，不要使用硬编码，才不会和其他应用冲突。例如，假设你的应用一直使用1337端口，万一别的应用也使用了这个端口，那么这两个应用就会冲突。所以，要使用设备的自动分配的空闲端口。因为端口的信息是通过广播告知其他设备服务的，所以端口号不需要在代码编译的时候就确定好。其他应用可以通过你发送的服务广播，获取端口信息，然后再连接你的服务。

如果你使用socket，把参数设为0系统就会自动分配一个可用的端口号。

public void initializeServerSocket() {    // Initialize a server socket on the next available port.    mServerSocket = new ServerSocket(0);    // Store the chosen port.    mLocalPort =  mServerSocket.getLocalPort();    ...}

至此，你已经定义了 NsdServiceInfo对象，你需要实现 RegistrationListener。这个接口在服务注册成功或失败的时候，会回调给你。

public void initializeRegistrationListener() {    mRegistrationListener = new NsdManager.RegistrationListener() {        @Override        public void onServiceRegistered(NsdServiceInfo NsdServiceInfo) {            // Save the service name.  Android may have changed it in order to            // resolve a conflict, so update the name you initially requested            // with the name Android actually used.            mServiceName = NsdServiceInfo.getServiceName();        }        @Override        public void onRegistrationFailed(NsdServiceInfo serviceInfo, int errorCode) {            // Registration failed!  Put debugging code here to determine why.        }        @Override        public void onServiceUnregistered(NsdServiceInfo arg0) {            // Service has been unregistered.  This only happens when you call            // NsdManager.unregisterService() and pass in this listener.        }        @Override        public void onUnregistrationFailed(NsdServiceInfo serviceInfo, int errorCode) {            // Unregistration failed.  Put debugging code here to determine why.        }    };}

现在你已经拥有了注册服务的所有信息了，调用registerService()方法进行注册。
注意，这个方法是异步的，所以，所有需要在服务注册成功后的方法调用，需要在onServiceRegistered()中调用。

public void registerService(int port) {    NsdServiceInfo serviceInfo  = new NsdServiceInfo();    serviceInfo.setServiceName("NsdChat");    serviceInfo.setServiceType("_http._tcp.");    serviceInfo.setPort(port);    mNsdManager = Context.getSystemService(Context.NSD_SERVICE);    mNsdManager.registerService(            serviceInfo, NsdManager.PROTOCOL_DNS_SD, mRegistrationListener);}

Discover Services on the Network

在生活中的很多方面，都有网络的身影，如网络打印机、网络摄像头等功能生态系统。让你的应用发现这个充满活力的生态系统的关键是发现服务。你的应用需要监听网络中服务的广播，才能知道哪些服务可用，并过滤掉你不需要的服务。

服务发现和服务注册一样，有两步：实现一个监听回调接口；调用异步API discoverServices().

实现使用一个匿名类实现 NsdManager.DiscoveryListener。下面的代码片段是一个简单的例子。

public void initializeDiscoveryListener() {    // Instantiate a new DiscoveryListener    mDiscoveryListener = new NsdManager.DiscoveryListener() {        //  Called as soon as service discovery begins.        @Override        public void onDiscoveryStarted(String regType) {            Log.d(TAG, "Service discovery started");        }        @Override        public void onServiceFound(NsdServiceInfo service) {            // A service was found!  Do something with it.            Log.d(TAG, "Service discovery success" + service);            if (!service.getServiceType().equals(SERVICE_TYPE)) {                // Service type is the string containing the protocol and                // transport layer for this service.                Log.d(TAG, "Unknown Service Type: " + service.getServiceType());            } else if (service.getServiceName().equals(mServiceName)) {                // The name of the service tells the user what they'd be                // connecting to. It could be "Bob's Chat App".                Log.d(TAG, "Same machine: " + mServiceName);            } else if (service.getServiceName().contains("NsdChat")){                mNsdManager.resolveService(service, mResolveListener);            }        }        @Override        public void onServiceLost(NsdServiceInfo service) {            // When the network service is no longer available.            // Internal bookkeeping code goes here.            Log.e(TAG, "service lost" + service);        }        @Override        public void onDiscoveryStopped(String serviceType) {            Log.i(TAG, "Discovery stopped: " + serviceType);        }        @Override        public void onStartDiscoveryFailed(String serviceType, int errorCode) {            Log.e(TAG, "Discovery failed: Error code:" + errorCode);            mNsdManager.stopServiceDiscovery(this);        }        @Override        public void onStopDiscoveryFailed(String serviceType, int errorCode) {            Log.e(TAG, "Discovery failed: Error code:" + errorCode);            mNsdManager.stopServiceDiscovery(this);        }    };}

NSD的API在这个接口的方法中，告诉你何时开始查找设备，何时开始查找失败，何时找到服务，何时失去服务等。注意到，在找到服务的时候，上面的代码片段做了很多比较。

1、找到的服务名称和自己的服务名称作比较，看看收到的是否是自己的服务。

2、检查服务类型，看看是否是自己需要的类型

3、检查服务名字，看看是否是需要的服务名。

检查服务的名字不是必要的，只有你要连接到一个特别的应用的时候，才需要检查。例如，服务想要连接到跑在其他设备的同一个应用。

如果应用想要连接到一个打印机，检查类型"_ipp._tcp"就够了。



实现回调接口后，调用discoverServices()，传给它你需要的服务类型，使用的发现协议和你实现的回调对象。

mNsdManager.discoverServices(        SERVICE_TYPE, NsdManager.PROTOCOL_DNS_SD, mDiscoveryListener);

Connect to Services on the Network

当你的应用找到一个可以连接的服务，首先要解析出服务的连接信息，使用resolveService()方法。实现一个NsdManager.ResolveListener作为resolveService()的参数，用它来获取包含连接信息的NsdServiceInfo。

public void initializeResolveListener() {    mResolveListener = new NsdManager.ResolveListener() {        @Override        public void onResolveFailed(NsdServiceInfo serviceInfo, int errorCode) {            // Called when the resolve fails.  Use the error code to debug.            Log.e(TAG, "Resolve failed" + errorCode);        }        @Override        public void onServiceResolved(NsdServiceInfo serviceInfo) {            Log.e(TAG, "Resolve Succeeded. " + serviceInfo);            if (serviceInfo.getServiceName().equals(mServiceName)) {                Log.d(TAG, "Same IP.");                return;            }            mService = serviceInfo;            int port = mService.getPort();            InetAddress host = mService.getHost();        }    };}

当解析完成后，就可以获取到连接的详细信息，如IP和端口号。这是连接到其他服务需要的所有信息。

Unregister Your Service on Application Close

在应用的生命周期中，要在适当的时间打开和关系NSD功能。在应用关闭的时候取消注册，可以防止其他应用连接到关闭的服务。另外，发现服务是一个开销很大的操作，所以在Activity paused的时候，也要停止搜索；当Activityresumed的时候，再重新搜索。重载主Activity的生命周期的方法，在合适的地方插入开始和停止服务的广播、开始和停止搜索服务。

//In your application's Activity    @Override    protected void onPause() {        if (mNsdHelper != null) {            mNsdHelper.tearDown();        }        super.onPause();    }    @Override    protected void onResume() {        super.onResume();        if (mNsdHelper != null) {            mNsdHelper.registerService(mConnection.getLocalPort());            mNsdHelper.discoverServices();        }    }    @Override    protected void onDestroy() {        mNsdHelper.tearDown();        mConnection.tearDown();        super.onDestroy();    }    // NsdHelper's tearDown method        public void tearDown() {        mNsdManager.unregisterService(mRegistrationListener);        mNsdManager.stopServiceDiscovery(mDiscoveryListener);    }