要求存取鄰近 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 類別的方法:

此外,由於 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:

Wi-Fi 存取工作流程

圖 1 顯示在搭載 Android 13 以上版本的裝置上,適用於指定 Android 13 以上版本應用程式的 Wi-Fi 存取工作流程。請注意,只要宣告應用程式不會從 Wi-Fi 裝置資訊取得實際位置,就不再需要宣告 ACCESS_FINE_LOCATION 權限:

圖 1 流程圖,用於判斷指定 Android 13 (API 級別 33) 以上版本的應用程式能否存取 Wi-Fi 資訊。

圖 2 顯示搭載 12L 以下版本裝置的 Wi-Fi 存取工作流程。請注意依賴 ACCESS_FINE_LOCATION 權限。

圖 2. 流程圖,用於判斷指定 12L (API 級別 32) 以下版本的應用程式能否存取 Wi-Fi 資訊。