NsdManager クラス

定義

[Android.Runtime.Register("android/net/nsd/NsdManager", DoNotGenerateAcw=true)]
public sealed class NsdManager : Java.Lang.Object

[<Android.Runtime.Register("android/net/nsd/NsdManager", DoNotGenerateAcw=true)>]
type NsdManager = class
    inherit Object

継承

Object

JavaObject

Object

NsdManager

属性

RegisterAttribute

注釈

Network Service Discovery Manager クラスは、ネットワーク上のサービスを検出するための API を提供します。 たとえば、デバイス A とデバイス B が Wi-Fi ネットワーク経由で接続されている場合、デバイス A に登録されているゲームは、デバイス B 上のゲームによって検出できます。もう 1 つのユース ケースは、ネットワーク上のプリンターを検出するアプリケーションです。

現在、この API は DNS ベースのサービス検出をサポートしており、検出は現在、マルチキャスト DNS 経由のローカル ネットワークに制限されています。 DNS サービスの検出については、 http://files.dns-sd.org/draft-cheshire-dnsext-dns-sd.txt

API は非同期であり、アプリケーションからの要求への応答は、別の内部スレッドのリスナー コールバックにあります。

API でサポートされる 3 つの主要な操作 (登録、検出、解決) があります。

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

他のアプリケーションが検出するためにネットワーク経由で自身をアドバタイズする必要があるアプリケーションは、 #registerServiceの呼び出しでこれを行うことができます。 Example がピア サービスに HTML データを提供できる http ベースのアプリケーションの場合は、サービスの種類 "_http._tcp" に名前 "Example" を登録できます。 登録が成功すると、 RegistrationListener#onServiceRegistered するコールバックが通知され、登録の失敗が通知されます。 RegistrationListener#onRegistrationFailed

http サービスを探しているピア アプリケーションは、 #discoverServicesの呼び出しで "_http._tcp" の検出を開始できます。 見つかったサービスは DiscoveryListener#onServiceFound するコールバックで通知され、失われたサービスは DiscoveryListener#onServiceLostに通知されます。

ピア アプリケーションが "Example" http サービスを検出し、サービスの属性を読み取る必要があるか、"Example" アプリケーションからデータを受信する必要がある場合は、 #resolveService を使用して解決を開始して、属性、ホスト、ポートの詳細を解決できます。 正常な解決は ResolveListener#onServiceResolved に通知され、エラーは ResolveListener#onResolveFailedに通知されます。

アプリケーションは、次のサービスの種類を予約できます。 http://www.iana.org/form/ports-service. 既存のサービスは、次の場所にあります。 http://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.xml

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。