Wi-Fi Aware 機能により、Android 8.0（API レベル 26）以降を搭載したデバイスは、他の種類の接続を介さずに、相互に直接検出して接続できます。Wi-Fi Aware は、Neighbor Awareness Networking（NAN）とも呼ばれます。
Wi-Fi Aware ネットワーキングは、近隣のデバイスとクラスタを形成するか、デバイスがエリア内で最初のデバイスである場合は新しいクラスタを作成することで機能します。このクラスタリング動作はデバイス全体に適用され、Wi-Fi Aware システム サービスによって管理されます。アプリはクラスタリング動作を制御できません。アプリは Wi-Fi Aware API を使用して Wi-Fi Aware システム サービスと通信します。このサービスは、デバイス上の Wi-Fi Aware ハードウェアを管理します。
Wi-Fi Aware API を使用すると、アプリで次のオペレーションを実施できます。
他のデバイスを検出する: この API には、近くにある他のデバイスを検出するメカニズムがあります。このプロセスは、1 台のデバイスが 1 つ以上の検出可能なサービスを公開すると開始されます。その後、デバイスが 1 つ以上のサービスにサブスクライブし、パブリッシャーの Wi-Fi 範囲に入ると、サブスクライバーは一致するパブリッシャーが検出されたという通知を受け取ります。サブスクライバーは、パブリッシャーを検出すると、短いメッセージを送信するか、検出されたデバイスとのネットワーク接続を確立できます。デバイスは、同時にパブリッシャーとサブスクライバーの両方になれます。
ネットワーク接続を作成する: 2 台のデバイスが相互に検出されると、アクセス ポイントなしで双方向の Wi-Fi Aware ネットワーク接続を作成できます。
Wi-Fi Aware ネットワーク接続は、Bluetooth 接続よりも長い距離で高いスループットをサポートします。このタイプの接続は、写真共有アプリなど、ユーザー間で大量のデータを共有するアプリに役立ちます。
Android 13（API レベル 33）の機能強化
インスタント通信モードをサポートする Android 13（API レベル 33）以降を搭載したデバイスでは、アプリは PublishConfig.Builder.setInstantCommunicationModeEnabled() メソッドと SubscribeConfig.Builder.setInstantCommunicationModeEnabled() メソッドを使用して、パブリッシャーまたはサブスクライバーのディスカバリ セッションでインスタント通信モードを有効または無効にできます。インスタント通信モードでは、メッセージ交換、サービス ディスカバリ、パブリッシャーまたはサブスクライバーのディスカバリ セッションの一部として設定されたデータパスが高速化されます。デバイスがインスタント通信モードをサポートしているかどうかを判断するには、isInstantCommunicationModeSupported() メソッドを使用します。
Android 12（API レベル 31）の機能強化
Android 12（API レベル 31）では、Wi-Fi Aware にいくつかの機能強化が追加されています。
- Android 12（API レベル 31）以降を搭載したデバイスでは、
onServiceLost()コールバックを使用して、サービスが停止したか、範囲外に移動したために、アプリが検出されたサービスを失ったときにアラートを受け取ることができます。 - Wi-Fi Aware データパスの設定が簡素化されました。以前のバージョンでは、L2 メッセージを使用してイニシエーターの MAC アドレスを提供していたため、レイテンシが発生していました。Android 12 以降を搭載したデバイスでは、レスポンダー（サーバー）を、任意のピアを受け入れるように構成できます。つまり、イニシエーターの MAC アドレスを事前に把握する必要はありません。これにより、データパスの起動が高速化され、1 つのネットワーク リクエストだけで複数のポイントツーポイント リンクが可能になります。
- Android 12 以降で動作するアプリは、
WifiAwareManager.getAvailableAwareResources()メソッドを使用して、現在利用可能なデータパス、パブリッシュ セッション、サブスクライブ セッションの数を取得できます。これにより、アプリは、目的の機能を実行するのに十分なリソースがあるかどうかを判断できます。
初期設定
Wi-Fi Aware の検出とネットワーキングを使用するようにアプリをセットアップする手順は次のとおりです。
アプリのマニフェストで次の権限をリクエストします。
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" /> <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" /> <uses-permission android:name="android.permission.INTERNET" /> <!-- If your app targets Android 13 (API level 33) or higher, you must declare the NEARBY_WIFI_DEVICES permission. --> <uses-permission android:name="android.permission.NEARBY_WIFI_DEVICES" <!-- If your app derives location information from Wi-Fi APIs, don't include the "usesPermissionFlags" attribute. --> android:usesPermissionFlags="neverForLocation" /> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" <!-- If any feature in your app relies on precise location information, don't include the "maxSdkVersion" attribute. --> android:maxSdkVersion="32" />
以下に示すように、
PackageManagerAPI を使用して、デバイスが Wi-Fi Aware に対応しているかどうかを確認します。Kotlin
context.packageManager.hasSystemFeature(PackageManager.FEATURE_WIFI_AWARE)
Java
context.getPackageManager().hasSystemFeature(PackageManager.FEATURE_WIFI_AWARE);
Wi-Fi Aware が現在利用できるかどうかを確認します。Wi-Fi Aware がデバイスに存在していても、ユーザーが Wi-Fi または位置情報を無効にしているため、現在利用できない場合があります。ハードウェアとファームウェアの機能によっては、Wi-Fi Direct、SoftAP、テザリングが使用されている場合、Wi-Fi Aware をサポートしないデバイスもあります。Wi-Fi Aware が現在利用可能かどうかを確認するには、
isAvailable()を呼び出します。Wi-Fi Aware を利用できるかどうかは、いつでも変更される可能性があります。アプリは、
BroadcastReceiverを登録して、可用性が変更されるたびに送信されるACTION_WIFI_AWARE_STATE_CHANGEDを受信する必要があります。アプリがブロードキャスト インテントを受信すると、既存のセッションをすべて破棄し（Wi-Fi Aware サービスが中断されたと想定）、現在の可用性の状態を確認して、それに応じて動作を調整する必要があります。次に例を示します。Kotlin
val wifiAwareManager = context.getSystemService(Context.WIFI_AWARE_SERVICE) as WifiAwareManager? val filter = IntentFilter(WifiAwareManager.ACTION_WIFI_AWARE_STATE_CHANGED) val myReceiver = object : BroadcastReceiver() { override fun onReceive(context: Context, intent: Intent) { // discard current sessions if (wifiAwareManager?.isAvailable) { ... } else { ... } } } context.registerReceiver(myReceiver, filter)
Java
WifiAwareManager wifiAwareManager = (WifiAwareManager)context.getSystemService(Context.WIFI_AWARE_SERVICE) IntentFilter filter = new IntentFilter(WifiAwareManager.ACTION_WIFI_AWARE_STATE_CHANGED); BroadcastReceiver myReceiver = new BroadcastReceiver() { @Override public void onReceive(Context context, Intent intent) { // discard current sessions if (wifiAwareManager.isAvailable()) { ... } else { ... } } }; context.registerReceiver(myReceiver, filter);
詳細については、ブロードキャストをご覧ください。
セッションを取得する
Wi-Fi Aware の使用を開始するには、アプリで attach() を呼び出して WifiAwareSession を取得する必要があります。このメソッドは次の処理を行います。
- Wi-Fi Aware ハードウェアをオンにする。
- Wi-Fi Aware クラスタに参加、または Wi-Fi Aware クラスタを形成する。
- 一意の名前空間を持つ Wi-Fi Aware セッションを作成します。この名前空間は、その中で作成されたすべての検出セッションのコンテナとして機能します。
アプリが正常にアタッチされると、システムは onAttached() コールバックを実行します。このコールバックは、アプリが以降のすべてのセッション オペレーションで使用する必要がある WifiAwareSession オブジェクトを提供します。アプリは、セッションを使用してサービスを公開したり、サービスに登録したりできます。
アプリは attach() を 1 回だけ呼び出す必要があります。アプリが attach() を複数回呼び出すと、アプリは呼び出しごとに異なるセッションを受け取り、それぞれに独自の名前空間が割り当てられます。これは複雑なシナリオで役立つことがありますが、通常は避ける必要があります。
サービスを公開する
サービスを検出可能にするには、次のパラメータを受け取る publish() メソッドを呼び出します。
PublishConfigには、サービスの名前と、一致フィルタなどのその他の構成プロパティを指定します。DiscoverySessionCallbackは、サブスクライバーがメッセージを受信したときなど、イベントが発生したときに実行するアクションを指定します。
次の例をご覧ください。
Kotlin
val config: PublishConfig = PublishConfig.Builder() .setServiceName(AWARE_FILE_SHARE_SERVICE_NAME) .build() awareSession.publish(config, object : DiscoverySessionCallback() { override fun onPublishStarted(session: PublishDiscoverySession) { ... } override fun onMessageReceived(peerHandle: PeerHandle, message: ByteArray) { ... } })
Java
PublishConfig config = new PublishConfig.Builder() .setServiceName(“Aware_File_Share_Service_Name”) .build(); awareSession.publish(config, new DiscoverySessionCallback() { @Override public void onPublishStarted(PublishDiscoverySession session) { ... } @Override public void onMessageReceived(PeerHandle peerHandle, byte[] message) { ... } }, null);
パブリッシュが成功すると、onPublishStarted() コールバック メソッドが呼び出されます。
パブリッシュ後、一致するサブスクライバー アプリを実行しているデバイスがパブリッシュ デバイスの Wi-Fi 範囲に移動すると、サブスクライバーはサービスを検出します。サブスクライバーがパブリッシャーを検出しても、パブリッシャーは通知を受け取りません。ただし、サブスクライバーがパブリッシャーにメッセージを送信すると、パブリッシャーは通知を受け取ります。その場合、onMessageReceived() コールバック メソッドが呼び出されます。このメソッドの PeerHandle 引数を使用して、サブスクライバーにメッセージを送信したり、サブスクライバーへの接続を作成したりできます。
サービスの公開を停止するには、DiscoverySession.close() を呼び出します。ディスカバリー セッションは、親 WifiAwareSession に関連付けられます。親セッションが閉じられると、関連付けられている検出セッションも閉じられます。破棄されたオブジェクトも閉じられますが、スコープ外のセッションがいつ閉じられるかはシステムによって保証されないため、close() メソッドを明示的に呼び出すことをおすすめします。
サービスに登録する
サービスに登録するには、次のパラメータを受け取る subscribe() メソッドを呼び出します。
-
SubscribeConfigは、サブスクライブするサービスの名前と、一致フィルタなどのその他の構成プロパティを指定します。 DiscoverySessionCallbackは、パブリッシャーが検出されたときなど、イベントが発生したときに実行するアクションを指定します。
次の例をご覧ください。
Kotlin
val config: SubscribeConfig = SubscribeConfig.Builder() .setServiceName(AWARE_FILE_SHARE_SERVICE_NAME) .build() awareSession.subscribe(config, object : DiscoverySessionCallback() { override fun onSubscribeStarted(session: SubscribeDiscoverySession) { ... } override fun onServiceDiscovered( peerHandle: PeerHandle, serviceSpecificInfo: ByteArray, matchFilter: List<ByteArray> ) { ... } }, null)
Java
SubscribeConfig config = new SubscribeConfig.Builder() .setServiceName("Aware_File_Share_Service_Name") .build(); awareSession.subscribe(config, new DiscoverySessionCallback() { @Override public void onSubscribeStarted(SubscribeDiscoverySession session) { ... } @Override public void onServiceDiscovered(PeerHandle peerHandle, byte[] serviceSpecificInfo, List<byte[]> matchFilter) { ... } }, null);
登録オペレーションが成功すると、システムはアプリの onSubscribeStarted() コールバックを呼び出します。アプリがパブリッシャーを検出した後に、コールバックの SubscribeDiscoverySession 引数を使用してパブリッシャーと通信できるため、この参照を保存する必要があります。ディスカバリー セッションで updateSubscribe() を呼び出すことで、サブスクライブ セッションをいつでも更新できます。
この時点で、サブスクリプションは一致するパブリッシャーが Wi-Fi 範囲内に入るのを待機します。この場合、システムは onServiceDiscovered() コールバック メソッドを実行します。このコールバックの PeerHandle 引数を使用して、メッセージを送信したり、そのパブリッシャーへの接続を作成したりできます。
サービスの登録を停止するには、DiscoverySession.close() を呼び出します。ディスカバリー セッションは、親 WifiAwareSession に関連付けられます。親セッションが閉じられると、関連付けられている検出セッションも閉じられます。破棄されたオブジェクトも閉じられますが、スコープ外のセッションがいつ閉じられるかはシステムによって保証されないため、close() メソッドを明示的に呼び出すことをおすすめします。
メッセージを送信する
別のデバイスにメッセージを送信するには、次のオブジェクトが必要です。
DiscoverySession。このオブジェクトを使用すると、sendMessage()を呼び出すことができます。アプリは、サービスを公開するか、サービスに登録することで、DiscoverySessionを取得します。メッセージをルーティングするための、他のデバイスの
PeerHandle。アプリは、次の 2 つの方法のいずれかで別のデバイスのPeerHandleを取得します。- アプリがサービスを公開し、サブスクライバーからメッセージを受信します。アプリは、
onMessageReceived()コールバックからサブスクライバーのPeerHandleを取得します。 - アプリがサービスに登録します。一致するパブリッシャーが検出されると、アプリは
onServiceDiscovered()コールバックからパブリッシャーのPeerHandleを取得します。
- アプリがサービスを公開し、サブスクライバーからメッセージを受信します。アプリは、
メッセージを送信するには、sendMessage() を呼び出します。この場合、次のコールバックが発生する可能性があります。
- ピアがメッセージを正常に受信すると、システムは送信側アプリの
onMessageSendSucceeded()コールバックを呼び出します。 - ピアがメッセージを受信すると、システムは受信側アプリの
onMessageReceived()コールバックを呼び出します。
PeerHandle はピアとの通信に必要ですが、ピアの永続的な識別子として依存しないでください。上位レベルの識別子は、ディスカバリ サービス自体または後続のメッセージに埋め込まれたアプリケーションで使用できます。PublishConfig または SubscribeConfig の setMatchFilter() メソッドまたは setServiceSpecificInfo() メソッドを使用して、検出サービスに識別子を埋め込むことができます。setMatchFilter() メソッドは検出に影響しますが、setServiceSpecificInfo() メソッドは検出に影響しません。
メッセージに識別子を埋め込むとは、識別子（最初の数バイトなど）を含めるようにメッセージのバイト配列を変更することを意味します。
接続を作成する
Wi-Fi Aware は、2 つの Wi-Fi Aware デバイス間のクライアント サーバー ネットワークをサポートします。
クライアント サーバー接続の設定手順は次のとおりです。
Wi-Fi Aware ディスカバリを使用して、サービスを公開（サーバー上）し、サービスに登録（クライアント上）します。
サブスクライバーがパブリッシャーを検出したら、サブスクライバーからパブリッシャーにメッセージを送信します。
パブリッシャー デバイスで
ServerSocketを起動し、そのポートを設定または取得します。Kotlin
val ss = ServerSocket(0) val port = ss.localPort
Java
ServerSocket ss = new ServerSocket(0); int port = ss.getLocalPort();
ConnectivityManagerを使用して、WifiAwareNetworkSpecifierを使用してパブリッシャーに Wi-Fi Aware ネットワークをリクエストします。ディスカバリ セッションと、サブスクライバーから送信されたメッセージから取得したサブスクライバーのPeerHandleを指定します。Kotlin
val networkSpecifier = WifiAwareNetworkSpecifier.Builder(discoverySession, peerHandle) .setPskPassphrase("somePassword") .setPort(port) .build() val myNetworkRequest = NetworkRequest.Builder() .addTransportType(NetworkCapabilities.TRANSPORT_WIFI_AWARE) .setNetworkSpecifier(networkSpecifier) .build() val callback = object : ConnectivityManager.NetworkCallback() { override fun onAvailable(network: Network) { ... } override fun onCapabilitiesChanged(network: Network, networkCapabilities: NetworkCapabilities) { ... } override fun onLost(network: Network) { ... } } connMgr.requestNetwork(myNetworkRequest, callback);
Java
NetworkSpecifier networkSpecifier = new WifiAwareNetworkSpecifier.Builder(discoverySession, peerHandle) .setPskPassphrase("somePassword") .setPort(port) .build(); NetworkRequest myNetworkRequest = new NetworkRequest.Builder() .addTransportType(NetworkCapabilities.TRANSPORT_WIFI_AWARE) .setNetworkSpecifier(networkSpecifier) .build(); ConnectivityManager.NetworkCallback callback = new ConnectivityManager.NetworkCallback() { @Override public void onAvailable(Network network) { ... } @Override public void onCapabilitiesChanged(Network network, NetworkCapabilities networkCapabilities) { ... } @Override public void onLost(Network network) { ... } }; ConnectivityManager connMgr.requestNetwork(myNetworkRequest, callback);
パブリッシャーがネットワークをリクエストしたら、サブスクライバーにメッセージを送信する必要があります。
サブスクライバーがパブリッシャーからメッセージを受信したら、パブリッシャーと同じ方法を使用して、サブスクライバーで Wi-Fi Aware ネットワークをリクエストします。
NetworkSpecifierの作成時にポートを指定しないでください。ネットワーク接続が利用可能、変更、または失われたときに、適切なコールバック メソッドが呼び出されます。サブスクライバーで
onAvailable()メソッドが呼び出されると、Networkオブジェクトが利用可能になります。このオブジェクトを使用してSocketを開き、パブリッシャーのServerSocketと通信できますが、ServerSocketの IPv6 アドレスとポートを知る必要があります。これらは、onCapabilitiesChanged()コールバックで提供されるNetworkCapabilitiesオブジェクトから取得します。Kotlin
val peerAwareInfo = networkCapabilities.transportInfo as WifiAwareNetworkInfo val peerIpv6 = peerAwareInfo.peerIpv6Addr val peerPort = peerAwareInfo.port ... val socket = network.getSocketFactory().createSocket(peerIpv6, peerPort)
Java
WifiAwareNetworkInfo peerAwareInfo = (WifiAwareNetworkInfo) networkCapabilities.getTransportInfo(); Inet6Address peerIpv6 = peerAwareInfo.getPeerIpv6Addr(); int peerPort = peerAwareInfo.getPort(); ... Socket socket = network.getSocketFactory().createSocket(peerIpv6, peerPort);
ネットワーク接続が完了したら、
unregisterNetworkCallback()を呼び出します。
ピアの距離測定と位置情報に基づく検出
Wi-Fi RTT 位置情報機能を備えたデバイスは、ピアまでの距離を直接測定し、この情報を使用して Wi-Fi Aware サービス ディスカバリを制限できます。
Wi-Fi RTT API を使用すると、MAC アドレスまたは PeerHandle を使用して、Wi-Fi Aware ピアへの直接測距を行うことができます。
Wi-Fi Aware の検出は、特定のジオフェンス内のサービスのみを検出するように制限できます。たとえば、"Aware_File_Share_Service_Name" サービスを公開しているデバイスを検出するジオフェンスを設定して、3 メートル（3,000 mm と指定）以上 10 メートル（10,000 mm と指定）以下の範囲にあるデバイスを検出できます。
ジオフェンスを有効にするには、パブリッシャーとサブスクライバーの両方で対応する必要があります。
パブリッシャーは、setRangingEnabled(true) を使用して、公開されたサービスでレンジングを有効にする必要があります。
パブリッシャーがレンジングを有効にしていない場合、サブスクライバーが指定したジオフェンスの制約は無視され、距離を無視して通常の検出が行われます。
サブスクライバーは、setMinDistanceMm と setMaxDistanceMm の組み合わせを使用してジオフェンスを指定する必要があります。
どちらの値でも、距離が指定されていない場合は制限がないことを意味します。最大距離のみを指定すると、最小距離は 0 になります。最小距離のみを指定すると、最大距離は指定されません。
ジオフェンス内でピアサービスが検出されると、onServiceDiscoveredWithinRange コールバックがトリガーされ、ピアまでの測定距離が提供されます。その後、必要に応じて直接 Wi-Fi RTT API を呼び出して、後で距離を測定できます。