要求存取鄰近 Wi-Fi 裝置的權限

如果應用程式指定 Android 13 (API 級別 33) 以上版本為目標，且會管理 Wi-Fi 連線，則應要求 NEARBY_WIFI_DEVICES 執行階段權限。這項權限可讓您更輕鬆地證明應用程式存取附近 Wi-Fi 裝置的合理性；在舊版 Android 中，這類應用程式必須改為宣告 ACCESS_FINE_LOCATION 權限。

權限屬於鄰近裝置群組

「NEARBY_WIFI_DEVICES」權限屬於「鄰近裝置」權限群組。這個群組是 Android 12 (API 級別 31) 中新增的群組，也包含與藍牙和超寬頻相關的權限。當您要求這個權限群組中的任何權限組合時，系統會顯示單一執行階段對話方塊，並要求使用者核准應用程式存取鄰近裝置。在系統設定中，使用者必須啟用及停用「鄰近裝置」權限群組；舉例來說，使用者無法停用 Wi-Fi 存取權，但可為特定應用程式啟用藍牙存取權。

強烈聲明應用程式不會推導實際位置

指定 Android 13 以上版本時，請考量應用程式是否曾透過 Wi-Fi API 衍生位置資訊；如果沒有，強烈建議您聲明這點。如要進行這項判斷，請在應用程式的資訊清單檔案中，將 usesPermissionFlags 屬性設為 neverForLocation，如以下程式碼片段所示。這個程序與您聲明藍牙裝置資訊絕不會用於定位時執行的程序類似：

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

舊版和部分 API 需要位置存取權

即使應用程式指定 Android 13 以上版本，部分 Wi-Fi API 仍需要 ACCESS_FINE_LOCATION 權限。範例包括 WifiManager 類別的下列方法：

• getScanResults()
• startScan()

此外，由於 NEARBY_WIFI_DEVICES 權限僅適用於 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 以上版本，您必須宣告 NEARBY_WIFI_DEVICES 權限，才能呼叫下列任何 Wi-Fi API：

• 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 存取工作流程。請注意，只要您聲明應用程式不會從 Wi-Fi 裝置資訊推導出實際位置，就不再需要聲明 ACCESS_FINE_LOCATION 權限：

圖 2 顯示搭載 12L 以下版本的裝置 Wi-Fi 存取工作流程。請注意，這項功能需要 ACCESS_FINE_LOCATION 權限。