Bluetooth の権限

アプリで Bluetooth 機能を使用するには、複数の権限を宣言する必要があります。また、アプリで Bluetooth クラシックまたは Bluetooth Low Energy（BLE）のサポートお使いの 従来の Bluetooth や BLE は不要ですが、引き続き利用できます。 実行時に可用性を確認できます。

権限を宣言する

アプリで宣言する権限のセットは、アプリのターゲット SDK バージョンによって異なります。

Android 12 以降をターゲットとする

Android 12（API レベル 31）以降をターゲットとするアプリの場合は、以下を宣言します。 権限を宣言する必要があります。

1. アプリで Bluetooth が必要な場合 デバイスを BLE 周辺機器を使用するには、 BLUETOOTH_SCAN 付与します。
2. アプリが現在のデバイスを他の Bluetooth デバイスから検出可能にする場合は、BLUETOOTH_ADVERTISE 権限を宣言します。
3. アプリがすでにペア設定されている Bluetooth と通信する場合 、 BLUETOOTH_CONNECT 付与します。
4. Bluetooth 関連の従来の権限宣言では、android:maxSdkVersion を 30 に設定します。このアプリの互換性に関する手順により、システムは アプリのインストール時に必要な Bluetooth 権限のみをアプリに付与する Android 12 以降を搭載したデバイス
5. アプリが Bluetooth のスキャン結果を使用して物理的な位置情報を取得する場合は、 ACCESS_FINE_LOCATION 付与します。それ以外の場合は、アプリが物理的な位置情報を取得しないことを強く主張できます。

BLUETOOTH_ADVERTISE、BLUETOOTH_CONNECT、BLUETOOTH_SCAN の各権限は実行時の権限です。そのため、ユーザー グループに明示的にリクエストを アプリを実際に承認してから、 Bluetooth デバイスへの接続、他のデバイスからのデバイスの検出を可能にする、通信を可能にする ペア設定済みの Bluetooth デバイスとペア設定されたデバイスのことです。アプリがこれらの権限の少なくとも 1 つをリクエストすると、図 1 に示すように、アプリが付近のデバイスにアクセスすることを許可するよう求めるプロンプトが表示されます。

次のコード スニペットは、Bluetooth 関連の宣言方法を示しています。 Android 12 以降をターゲットとしているアプリに付与する必要があります。

<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>

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

アプリが物理的な位置情報を取得するために Bluetooth スキャン結果を使用しない場合は、 アプリが Bluetooth 権限を使用しないことを強く主張できる 物理的な現在地を導き出しますそのための手順は次のとおりです。

1. android:usesPermissionFlags 属性を BLUETOOTH_SCAN 権限宣言に追加し、この属性の値を 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 は必須です リクエストなど、Bluetooth のクラシック通信または BLE 通信を 接続の受け入れ データの転送などがあります
• ACCESS_FINE_LOCATION を必要とするのは、Android 11 以前では Bluetooth スキャンが 場所に関する情報を収集するために使用できます。 できます。

位置情報の利用許可は実行時の権限であるため、 実行時にこれらの権限をリクエストする必要があります。 マニフェストで宣言することもできます。

ローカルの Bluetooth デバイスを検出する

アプリでデバイスの検出を開始したり Bluetooth の設定を操作する場合は、BLUETOOTH_ADMIN 権限を宣言する必要があります。ほとんどのアプリは、ローカル Bluetooth デバイスを検出するためだけにこの権限が必要です。この機能により付与される他の能力は使用しない アプリが「電源マネージャー」権限の場合を除き、Bluetooth 設定を変更する 作成できます。アプリのマニフェスト ファイルで権限を宣言します。次に例を示します。

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

アプリがサービスをサポートし、Android 10（API レベル 29）または Android 11 では、 ACCESS_BACKGROUND_LOCATION Bluetooth デバイスの検出を許可します。このモジュールの 要件については、アクセス ロケーション（ バックグラウンドをご覧ください。

次のコード スニペットは、ACCESS_BACKGROUND_LOCATION を宣言する方法を示しています。 権限:

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

<uses-permission> をご覧ください。 をご覧ください。

Bluetooth 機能の使用を指定

Bluetooth がアプリの重要な要素である場合は、この要件を示すフラグをマニフェスト ファイルに追加できます。「 <uses-feature> 要素を使用すると、 アプリで使用するハードウェアのタイプと、そのタイプと 必要ありません。

この例では、Bluetooth クラシックが 。

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

アプリが Bluetooth Low Energy を利用している場合は、以下を使用できます。

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

アプリに必要な機能として宣言すると、それらの機能が搭載されていないデバイスのユーザーには Google Play ストアでアプリが表示されなくなります。このため、 必須の属性を true に設定するのは、必須でないとアプリが動作しない場合のみです。 おすすめします。

実行時に機能の可用性を確認する

Bluetooth クラシックまたは 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);