Wi-Fi Aware の機能は、Android 8.0（API レベル 26）および 他の種類の API を使わずに互いに直接接続して、 内部 IP アドレスを使用して相互に通信できますWi-Fi Aware は、近接認識ネットワーキング（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() を呼び出す
呼び出しごとに異なるセッションを受信し、それぞれ異なるセッションを
Namespace があります。これは複雑なシナリオでは役立つ可能性がありますが、通常は避けてください。
サービスを公開する
サービスを検出可能にするには、次のパラメータを取る 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()
実装する必要があります。kubectl の「get」コマンドや
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 デバイス間のクライアント サーバー ネットワークをサポートします。
クライアント サーバー接続の設定手順は次のとおりです。
サブスクライバーがパブリッシャーを検出したら、サブスクライバーからパブリッシャーにメッセージを送信します。
パブリッシャーで
ServerSocketを開始する ポートを設定または取得します。Kotlin
val ss = ServerSocket(0) val port = ss.localPort
Java
ServerSocket ss = new ServerSocket(0); int port = ss.getLocalPort();
ConnectivityManagerを使用してパブリッシャーに Wi-Fi Aware ネットワークをリクエストします。WifiAwareNetworkSpecifierを使用し、また検出セッションと、サブスクライバーによって送信されたメッセージから取得したサブスクライバーの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 をリクエストします。 パブリッシャーと同じメソッドを使用するサブスクライバー上の認識ネットワーク。推奨 作成時にポートを指定せずに、
NetworkSpecifier。ネットワーク接続が利用可能なとき、変更されたとき、または失われたときに、該当するコールバック メソッドが呼び出されます。サブスクライバーで
onAvailable()メソッドが呼び出されると、パブリッシャーのServerSocketと通信するためにSocketを開くことができるNetworkオブジェクトが利用可能になります。ただし、ServerSocketの IPv6 アドレスとポートが既知である必要があります。これらはNetworkCapabilitiesオブジェクトonCapabilitiesChanged()コールバックで指定: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 の検出は、組織内のサービスのみが検出されるように制限できます。
特定できます。たとえば、3 メートル（3,000 mm として指定）より近くなく、10 m（10,000 mm として指定）より遠くない、"Aware_File_Share_Service_Name" サービスを公開しているデバイスを検出できるようにジオフェンスを設定できます。
ジオフェンスを有効にするには、パブリッシャーとサブスクライバーの両方で対応する必要があります。
パブリッシャーは、setRangingEnabled(true) を使用して、公開されたサービスで距離測定を有効にする必要があります。
パブリッシャーが距離測定を有効にしていない場合、ジオフェンスの制約は 無視され、通常の検出が実行されます。 距離は無視します。
サブスクライバーは、以下の組み合わせを使用してジオフェンスを指定する必要があります。 setMinDistanceMm および setMaxDistanceMm。
どちらの値でも、距離が指定されていない場合は制限がないことを意味します。指定のみ 最大距離は最小距離が 0 であることを意味します。Pod の 最小距離は最大値がないことを意味します
ジオフェンス内でピアサービスが検出されると、ピアとの距離を測定する onServiceDiscoveredWithinRange コールバックがトリガーされます。これにより、必要に応じてダイレクト Wi-Fi RTT API を呼び出し、後で距離を測定できます。