付近の Wi-Fi デバイスにアクセスする権限をリクエストする

Android 13（API レベル 33）以降をターゲットとし、Wi-Fi 接続を管理するアプリ が NEARBY_WIFI_DEVICES 実行時の権限。この 付近の Wi-Fi デバイスにアプリがアクセスする正当な理由を簡単に説明できるようにする 使用する場合、これらのアプリでは ACCESS_FINE_LOCATION 権限を使用してください。

注意: アプリが適切な権限なしで Wi-Fi API を呼び出そうとすると、SecurityException が発生します。

権限は「付近のデバイス」グループに含まれる

NEARBY_WIFI_DEVICES 権限は、付近のデバイス権限グループに含まれます。このグループは Android 12（API レベル 31）で追加されており、Bluetooth と超広帯域無線に関連する権限も含まれています。リクエストを 組み合わせると、システムによって 1 つのロールが 付近のデバイスへのアプリのアクセスを承認するようユーザーに求めるメッセージが表示されます。 システム設定で、[付近のデバイス] を有効または無効にする必要があります。 グループとしての権限。たとえば、ユーザーは Wi-Fi アクセスを無効にすることはできませんが、 特定のアプリで有効になっている Bluetooth アクセス。

アプリが物理的な位置情報を取得しないことを強く表明する

Android 13 以降をターゲットとする場合は、アプリが Wi-Fi API から位置情報を取得すること。そうでない場合は、 アサートできます。この表明を行うには、次のコード スニペットに示すように、アプリのマニフェスト ファイルで usesPermissionFlags 属性を neverForLocation に設定します。この手順は、Bluetooth デバイスの情報が位置情報に使用されないことを表明する場合と同様です。

<manifest ...>
    <uses-permission android:name="android.permission.NEARBY_WIFI_DEVICES"
                     android:usesPermissionFlags="neverForLocation" />
    <application ...>
        ...
    </application>
</manifest>

以前のバージョンや一部の API では位置情報の利用許可が必要です

一部の Wi-Fi API は、ACCESS_FINE_LOCATION 許可が必要です。 Android 13 以降をターゲットとするアプリ。以下に例を示します。 WifiManager クラスのメソッドを使用できます。

• getScanResults()
• startScan()

また、NEARBY_WIFI_DEVICES 権限は VPC ネットワークでのみ利用できるため、 Android 13 以降では、 ACCESS_FINE_LOCATION アプリに下位互換性を持たせます。ただし、アプリが インフラストラクチャの 正確な位置情報を 次に示すように、この権限の最大 SDK バージョンを 32 に設定します。 次のコード スニペット:

<manifest ...>
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"
                     android:maxSdkVersion="32" />
    <application ...>
        ...
    </application>
</manifest>

権限を必要とする API を確認する

Android 13 以上をターゲットとするアプリの場合、次の Wi-Fi API を呼び出すには NEARBY_WIFI_DEVICES 権限の宣言が必要です。

• WifiManager
  • startLocalOnlyHotspot()
• WifiAwareManager
  • attach(AttachCallback attachCallback, IdentityChangedListener identityChangedListener, Handler handler)
• WifiAwareSession
  • publish()
  • subscribe()
• WifiP2pManager
  • addLocalService()
  • connect()
  • createGroup()
  • discoverPeers()
  • discoverServices()
  • requestDeviceInfo()
  • requestGroupInfo()
  • requestPeers()
• WifiRttManager
  • startRanging()

Wi-Fi アクセスのワークフロー

図 1 は、 Android 13 以降（以下をターゲットとするアプリの場合） Android 13 以降。なお、アプリが Wi-Fi デバイス情報から物理的な位置情報を取得しないと表明する場合、ACCESS_FINE_LOCATION 権限を宣言する必要はありません。

図 1. フローチャート Android 13（API レベル 33）以降をターゲットとするアプリが Wi-Fi 情報にアクセスできます。

図 2 は、 12L 以下。ACCESS_FINE_LOCATION 権限への依存に注意してください。

図 2. フローチャート 12L（API レベル 32）以下をターゲットとするアプリが Wi-Fi 情報にアクセスできます。