藍牙權限

如要使用應用程式的藍牙功能，您必須宣告多項 權限。此外，您也應指定應用程式是否需要 支援經典藍牙或藍牙低功耗 (BLE)。如果您的 應用程式不需要經典藍牙或 BLE，但仍可使用以下功能 您可以在執行階段檢查可用性。

宣告權限

您在應用程式中宣告的權限組合取決於應用程式的目標 SDK 版本。

指定 Android 12 以上版本

如果應用程式指定 Android 12 (API 級別 31) 以上版本，請宣告以下內容 將權限套用至應用程式的資訊清單檔案：

1. 如果您的應用程式需要藍牙 裝置，例如 BLE 週邊裝置，宣告 BLUETOOTH_SCAN敬上 權限。
2. 如果您的應用程式需要透過其他藍牙偵測到目前裝置 裝置 宣告 BLUETOOTH_ADVERTISE敬上 權限。
3. 如果您的應用程式與已配對的藍牙通訊 裝置，請宣告 BLUETOOTH_CONNECT敬上 權限。
4. 針對舊版藍牙相關權限聲明，請設定 android:maxSdkVersion到 30。這項應用程式相容性步驟可協助系統 僅授予應用程式安裝時所需的藍牙權限 搭載 Android 12 以上版本的裝置。
5. 如果應用程式會使用藍牙掃描結果判斷實際位置，請宣告 這個 ACCESS_FINE_LOCATION敬上 權限。否則，您可以明確聲明應用程式不會衍生出 實際位置。

BLUETOOTH_ADVERTISE、BLUETOOTH_CONNECT 和 BLUETOOTH_SCAN 權限 則為執行階段權限。 因此，你必須明確請求使用者 才能修正應用程式的問題 藍牙裝置、讓其他裝置可供偵測，或是與其他裝置通訊 與已配對的藍牙裝置。應用程式要求至少一個 這些權限，系統會提示使用者允許您的應用程式存取 鄰近裝置：如圖 1 所示。

下列程式碼片段說明如何宣告藍牙相關 權限：

<manifest>
    <!-- Request legacy Bluetooth permissions on older devices. -->
    <uses-permission android:name="android.permission.BLUETOOTH"
                     android:maxSdkVersion="30" />
    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"
                     android:maxSdkVersion="30" />

    <!-- Needed only if your app looks for Bluetooth devices.
         If your app doesn't use Bluetooth scan results to derive physical
         location information, you can
         <a href="#assert-never-for-location">strongly assert that your app
         doesn't derive physical location</a>. -->
    <uses-permission android:name="android.permission.BLUETOOTH_SCAN" />

    <!-- Needed only if your app makes the device discoverable to Bluetooth
         devices. -->
    <uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE" />

    <!-- Needed only if your app communicates with already-paired Bluetooth
         devices. -->
    <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

    <!-- Needed only if your app uses Bluetooth scan results to derive physical location. -->
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    ...
</manifest>

嚴格宣告應用程式不會衍生實體位置

如果您的應用程式無法透過藍牙掃描結果取得實際位置， 可做出強烈斷言，讓應用程式永不使用藍牙權限 以取得實際位置若要這樣做，請完成下列步驟：

1. 在 BLUETOOTH_SCAN 中加入 android:usesPermissionFlags 屬性 權限，然後將此屬性的值設為 neverForLocation。

2. 如果應用程式不需要位置資訊，請移除 ACCESS_FINE_LOCATION 權限。

下列程式碼片段說明如何更新應用程式的資訊清單檔案：

<manifest>
    <!-- Include "neverForLocation" only if you can strongly assert that
         your app never derives physical location from Bluetooth scan results. -->
    <uses-permission android:name="android.permission.BLUETOOTH_SCAN"
                     android:usesPermissionFlags="neverForLocation" />

    <!-- Not needed if you can strongly assert that your app never derives
         physical location from Bluetooth scan results and doesn't need location
         access for any other purpose. -->
    <strike><uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /></strike>
    ...
</manifest>

指定 Android 11 以下版本

如果應用程式指定 Android 11 (API 級別 30) 以下版本，請宣告以下內容 將權限套用至應用程式的資訊清單檔案：

• 必須提供 BLUETOOTH 執行任何藍牙或 BLE 通訊，例如要求 連線、接受連線，以及轉移資料。
• ACCESS_FINE_LOCATION敬上 。 可用於收集 內容。

位置存取權屬於執行階段權限， 必須在執行階段要求這些權限 並在資訊清單中宣告這些權限

尋找本機藍牙裝置

如果您希望應用程式啟動探索裝置功能或操控藍牙功能 就必須宣告 BLUETOOTH_ADMIN敬上 權限。大多數應用程式都需要這項權限才能偵測 和本機藍牙裝置一樣。請勿使用 權限除非應用程式為「電源管理員」修改藍牙設定 能直接回應使用者要求在應用程式資訊清單檔案中宣告權限。例如：

<manifest>
...
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
...
</manifest>

如果您的應用程式支援某項服務，且可在 Android 10 (API 級別 29) 或 Android 裝置中執行 Android 11，您也必須宣告 ACCESS_BACKGROUND_LOCATION敬上 權限可搜尋藍牙裝置。如要進一步瞭解 請參閱存取位置的 背景。

下列程式碼片段說明如何宣告 ACCESS_BACKGROUND_LOCATION 權限：

<manifest>
...
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
...
</manifest>

請參閱 <uses-permission> 進一步瞭解如何宣告應用程式權限。

指定藍牙功能使用情形

如果藍牙對應用程式至關重要，您可以在資訊清單中加入標記 檔案。 <uses-feature> 元素允許 您可以指定應用程式使用的硬體類型，以及應用程式是否會 這通常代表交易 不會十分要求關聯語意

本例說明如何表明手錶需要經典藍牙 應用程式。

<uses-feature android:name="android.hardware.bluetooth" android:required="true"/>

如果您的應用程式需要藍牙低功耗，您可以使用下列服務：

<uses-feature android:name="android.hardware.bluetooth_le" android:required="true"/>

如果您表示應用程式需要這項功能，Google Play 商店就會顯示 無法在缺少這些功能的裝置上隱藏應用程式。因此，您 只有在沒有必要屬性的情況下，應用程式才能運作時，才應將必要屬性設為 true 這項功能

在執行階段查看功能可用性

如要讓應用程式用於不支援藍牙傳統版的裝置，或 BLE，您仍應在應用程式的<uses-feature> 而是設定 required="false"在執行階段中 功能可用性 PackageManager.hasSystemFeature():

// Check to see if the Bluetooth classic feature is available.
val bluetoothAvailable = packageManager.hasSystemFeature(PackageManager.FEATURE_BLUETOOTH)

// Check to see if the BLE feature is available.
val bluetoothLEAvailable = packageManager.hasSystemFeature(PackageManager.FEATURE_BLUETOOTH_LE)

// Use this check to determine whether Bluetooth classic is supported on the device.
// Then you can selectively disable BLE-related features.
boolean bluetoothAvailable = getPackageManager().hasSystemFeature(PackageManager.FEATURE_BLUETOOTH);

// Use this check to determine whether BLE is supported on the device. Then
// you can selectively disable BLE-related features.
boolean bluetoothLEAvailable = getPackageManager().hasSystemFeature(PackageManager.FEATURE_BLUETOOTH_LE);