如需在应用中使用蓝牙功能，您必须声明多项权限。您还应指定应用是否需要支持传统蓝牙或低功耗蓝牙 (BLE)。如果您的应用不需要传统蓝牙或 BLE，但仍可受益于这些技术，您可以在运行时检查可用性。
声明权限
您在应用中声明的权限集取决于应用的目标 SDK 版本。
以 Android 12 或更高版本为目标平台
注意： 在 Android 8.0（API 级别 26）及更高版本中，与本部分介绍的权限相比，配套设备管理器 (CDM) 提供了一种更精简的方法来连接到配套设备。CDM 系统会代表您的应用提供配对界面，并且不需要位置权限。
如果您想要更好地控制配对和连接体验，请使用本部分中介绍的权限。
系统权限对话框，要求用户授予应用权限以发现、通告和连接到附近的设备。
如果您的应用以 Android 12（API 级别 31）或更高版本为目标平台，请在应用的清单文件中声明以下权限：
如果您的应用查找蓝牙设备（如 BLE 外围设备），请声明 BLUETOOTH_SCAN 权限。
如果您的应用使当前设备可被其他蓝牙设备检测到，请声明 BLUETOOTH_ADVERTISE 权限。
如果您的应用与已配对的蓝牙设备通信，请声明 BLUETOOTH_CONNECT 权限。
对于旧版蓝牙相关的权限声明，请将 android:maxSdkVersion 设为 30。此应用兼容性步骤有助于系统仅向您的应用授予在搭载 Android 12 或更高版本的设备上安装时所需的蓝牙权限。
如果您的应用使用蓝牙扫描结果来推导物理位置，请声明 ACCESS_FINE_LOCATION 权限。否则，您可以坚定地断言您的应用不会推导物理位置，并将 ACCESS_FINE_LOCATION 权限的 android:maxSdkVersion 设置为 30。
BLUETOOTH_ADVERTISE、BLUETOOTH_CONNECT 和 BLUETOOTH_SCAN 权限是运行时权限。因此，您必须先在应用中明确请求用户批准，然后才能查找蓝牙设备、使某个设备可被其他设备检测到，或者与已配对的蓝牙设备通信。当您的应用请求其中至少一项权限时，系统会提示用户允许您的应用访问附近的设备，如图 1 所示。
以下代码段演示了如何声明应用中与蓝牙相关的权限（如果应用以 Android 12 或更高版本为目标平台）：
android:maxSdkVersion="30" /> android:maxSdkVersion="30" /> ... 坚定地声明您的应用不会推导物理位置 如果您的应用不使用蓝牙扫描结果来推导物理位置，那么您可以坚定地断言您的应用绝不会使用蓝牙权限来推导物理位置。为此，请完成以下步骤： 将 android:usesPermissionFlags 属性添加到 BLUETOOTH_SCAN 权限声明，并将此属性的值设为 neverForLocation。 注意：如果 android:usesPermissionFlags 中包含 neverForLocation，则会从扫描结果中过滤出某些 BLE 信标。 如果您的应用不需要位置信息，请从应用的清单中移除 ACCESS_FINE_LOCATION 权限。 以下代码段展示了如何更新应用的清单文件： android:usesPermissionFlags="neverForLocation" /> android:maxSdkVersion="30" /> ... 以 Android 11 或更低版本为目标平台 如果您的应用以 Android 11（API 级别 30）或更低版本为目标平台，请在应用的清单文件中声明以下权限： BLUETOOTH 是执行任何蓝牙传统或 BLE 通信（例如请求连接、接受连接和传输数据）所必需的权限。 ACCESS_FINE_LOCATION 是必需的，因为在 Android 11 及更低版本中，蓝牙扫描可能会被用来收集有关用户位置的信息。 注意 ：在搭载 Android 8.0 或更高版本的设备上，您可以使用 CompanionDeviceManager 代表应用对附近的配套设备执行扫描，而不需要位置权限。如需详细了解此选项，请参阅配套设备配对。 由于位置信息权限属于运行时权限，因此您必须在运行时请求这些权限，同时在清单中声明这些权限。 发现本地蓝牙设备 如果您希望应用启动设备发现或操纵蓝牙设置，则必须声明 BLUETOOTH_ADMIN 权限。大多数应用需要此权限只是为了能够发现本地蓝牙设备。除非应用是“电源管理器”，会在用户请求时修改蓝牙设置，否则请勿使用此权限授予的其他功能。在应用清单文件中声明相应权限。例如： ... ... 如果您的应用支持某项服务，并且可以在 Android 10（API 级别 29）或 Android 11 上运行，那么您还必须声明 ACCESS_BACKGROUND_LOCATION 权限才能发现蓝牙设备。如需详细了解此要求，请参阅在后台访问位置信息。 以下代码段展示了如何声明 ACCESS_BACKGROUND_LOCATION 权限： ... ... 如需详细了解如何声明应用权限，请参阅 指定蓝牙功能使用情况 如果蓝牙是应用的关键组成部分，您可以在清单文件中添加标志来指明此要求。借助 此示例展示了如何指明您的应用需要使用蓝牙传统模式。 如果您的应用依赖于蓝牙低功耗，则可以使用以下功能： 如果您声明应用需要某项功能，那么 Google Play 商店就会向缺少这些功能的设备上的用户隐藏您的应用。因此，只有当应用没有相应功能便无法正常运行时，您才应将必需属性设置为 true。 在运行时检查功能可用性 为了让不支持传统蓝牙或 BLE 的设备也能使用您的应用，您仍应在应用的清单中添加 Kotlin // 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) Java // 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);