chrome.bluetoothLowEnergy

説明

chrome.bluetoothLowEnergy API は、汎用属性プロファイル（GATT）を使用して Bluetooth Smart（低エネルギー）デバイスと通信するために使用されます。

マニフェスト

この API を使用するには、次のキーをマニフェストで宣言する必要があります。

"bluetooth"

型

Advertisement

Chrome 47 以降

プロパティ

  • manufacturerData

    ManufacturerData[] 省略可

    広告データの [Manufacturer Specific Data] フィールドに含めるメーカー固有のデータのリスト。

  • serviceData

    ServiceData[] 省略可

    広告データの [サービスデータ] フィールドに含めるサービスデータのリスト。

  • serviceUuids

    string[] 省略可

    広告データの [サービス UUID] フィールドに含める UUID のリスト。これらの UUID は 16 ビット、32 ビット、128 ビットのいずれかの形式になります。

  • solicitUuids

    string[] 省略可

    広告データの [Solicit UUIDs] フィールドに含める UUID のリスト。これらの UUID は 16 ビット、32 ビット、128 ビットのいずれかの形式になります。

  • 広告の種類。

AdvertisementType

Chrome 47 以降

広告の種類。「ブロードキャスト」を選択すると、送信されるアドバタイズメント タイプは ADV_NONCONN_IND になり、デバイスはランダムな MAC アドレスでブロードキャストします。「peripheral」に設定すると、アドバタイズ タイプは ADV_IND または ADV_SCAN_IND になり、デバイスは実際の Bluetooth アダプタの MAC アドレスでブロードキャストします。

列挙型

"broadcast"

"peripheral"

Characteristic

プロパティ

  • instanceId

    文字列 省略可

    この特性に割り当てられた識別子を返します。インスタンス ID を使用して、同じ UUID を持つ周辺機器の特性を区別し、特性識別子を受け取る関数呼び出しを行います。このインスタンスがリモート特性を表す場合は存在します。

  • プロパティ

    CharacteristicProperty[]

    この特性のプロパティ。

  • サービス

    Service optional

    この特性が属する GATT サービス。

  • uuid

    文字列

    特性の UUID（例: 00002a37-0000-1000-8000-00805f9b34fb）。

  • 値

    ArrayBuffer 省略可

    現在キャッシュに保存されている特性値。この値は、通知または指示を介して特性の値が読み取られるか更新されると更新されます。

CharacteristicProperty

特性の可能なプロパティを表す値。特性の権限は、これらのプロパティから推測されます。各プロパティの意味については、Bluetooth 4.x の仕様をご覧ください。

列挙型

"broadcast"

"read"

"writeWithoutResponse"

"write"

"notify"

"indicate"

"authenticatedSignedWrites"

"extendedProperties"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

プロパティ

  • 永続

    ブール値

    アプリケーションのイベントページがアンロードされたときに、デバイスへの接続を開いたままにするかどうかを示すフラグ（アプリのライフサイクルを管理するを参照）。デフォルト値は false. です。

Descriptor

プロパティ

  • 特性

    特性（省略可）

    このディスクリプタが属する GATT 特性。

  • instanceId

    文字列 省略可

    この記述子に割り当てられた識別子を返します。インスタンス ID を使用して、同じ UUID を持つ周辺機器の記述子を区別し、記述子識別子を受け取る関数呼び出しを行います。このインスタンスがリモート特性を表す場合は存在します。

  • Chrome 52 以降

    この記述子の権限。

  • uuid

    文字列

    特性記述子の UUID（00002902-0000-1000-8000-00805f9b34fb など）。

  • 値

    ArrayBuffer 省略可

    現在キャッシュに保存されている記述子の値。この値は、ディスクリプタの値が読み取られると更新されます。

DescriptorPermission

Chrome 52 以降

記述子の可能な権限を表す値。個々の権限の意味については、Bluetooth 4.x の仕様をご覧ください。

列挙型

"read"

"write"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome 52 以降

プロパティ

  • 住所

    文字列

    デバイスのアドレス（「XX:XX:XX:XX:XX:XX」形式）。

  • deviceClass

    number 省略可

    デバイスのクラス。http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband で定義されたビットフィールド。

  • name

    文字列 省略可

    人が読める形式のデバイス名。

ManufacturerData

Chrome 47 以降

プロパティ

  • データ

    number[]

  • id

    数値

Notification

Chrome 52 以降

プロパティ

  • shouldIndicate

    ブール値（省略可）

    通知ではなくインジケーターを送信するためのオプション フラグ。

  • 値

    ArrayBuffer

    特性の新しい値。

NotificationProperties

プロパティ

  • 永続

    ブール値

    アプリケーションのイベントページがアンロードされたときにアプリが通知を受け取るかどうかを示すフラグ（アプリのライフサイクルを管理するを参照）。デフォルト値は false です。

Request

Chrome 52 以降

プロパティ

  • デバイス

    デバイス

    このリクエストを送信したデバイス。

  • requestId

    数値

    このリクエストの一意の ID。このリクエストへの対応には、この ID を使用してください。

  • 値

    ArrayBuffer 省略可

    書き込む値（書き込みリクエストの場合）。

Response

Chrome 52 以降

プロパティ

  • isError

    ブール値

    これがエラー レスポンスの場合、この値は true になります。

  • requestId

    数値

    このレスポンスが対応するリクエストの ID。

  • 値

    ArrayBuffer 省略可

    レスポンス値。書き込みリクエストとエラー レスポンスでは、このパラメータは無視されます。

Service

プロパティ

  • deviceAddress

    文字列 省略可

    GATT サービスが属するリモート ペリフェラルのデバイス アドレス。このインスタンスがリモート サービスを表す場合は存在します。

  • instanceId

    文字列 省略可

    このサービスに割り当てられた識別子を返します。インスタンス ID を使用して、同じ UUID を持つ周辺機器のサービスを区別し、サービス ID を受け取る関数呼び出しを行います。このインスタンスがリモート サービスを表す場合は存在します。

  • isPrimary

    ブール値

    このサービスのタイプがプライマリかセカンダリかを示します。

  • uuid

    文字列

    サービスの UUID（例: 0000180d-0000-1000-8000-00805f9b34fb）。

ServiceData

Chrome 47 以降

プロパティ

  • データ

    number[]

  • uuid

    文字列

メソッド

connect()

Promise 
chrome.bluetoothLowEnergy.connect(
  deviceAddress: string,
  properties?: ConnectProperties,
  callback?: function,
): Promise<void>

指定されたアドレスのアプリケーションとデバイス間の接続を確立します。デバイスがすでに接続されていて、connect を呼び出さなくても GATT サービスが利用可能な場合もありますが、デバイスの GATT サービスにアクセスしたいアプリは、この関数を呼び出して、デバイスへの接続が維持されていることを確認する必要があります。デバイスが接続されていない場合、connect の呼び出しが成功すると、デバイスのすべての GATT サービスが検出されます。

パラメータ

  • deviceAddress

    文字列

    GATT 接続を開くリモート デバイスの Bluetooth アドレス。

  • プロパティ

    ConnectProperties 省略可

    接続プロパティ（省略可）。

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    Chrome 91 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

createCharacteristic()

Promise Chrome 52 以降 
chrome.bluetoothLowEnergy.createCharacteristic(
  characteristic: Characteristic,
  serviceId: string,
  callback?: function,
): Promise<string>

ローカルでホストされる GATT 特性を作成します。この特性は、有効なサービスでホストする必要があります。サービス ID が有効でない場合、lastError が設定されます。この関数は、アプリで bluetooth:low_energy と bluetooth:peripheral の両方の権限が true に設定されている場合にのみ使用できます。周辺機器の権限は、すべてのアプリで利用できるわけではありません。

パラメータ

  • 特性

    特性

    作成する特性。

  • serviceId

    文字列

    この特性を作成するサービスの ID。

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    (characteristicId: string) => void

    • characteristicId

      文字列

戻り値

  • Promise<string>

    Chrome 91 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

createDescriptor()

Promise Chrome 52 以降 
chrome.bluetoothLowEnergy.createDescriptor(
  descriptor: Descriptor,
  characteristicId: string,
  callback?: function,
): Promise<string>

ローカルでホストされる GATT 記述子を作成します。この記述子は有効な特性の下にホストする必要があります。特性 ID が有効でない場合、lastError が設定されます。この関数は、アプリで bluetooth:low_energy と bluetooth:peripheral の両方の権限が true に設定されている場合にのみ使用できます。周辺機器の権限は、すべてのアプリで利用できるわけではありません。

パラメータ

  • 記述子

    Descriptor

    作成する記述子。

  • characteristicId

    文字列

    このディスクリプタを作成する特性の ID。

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    (descriptorId: string) => void

    • descriptorId

      文字列

戻り値

  • Promise<string>

    Chrome 91 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

createService()

Promise Chrome 52 以降 
chrome.bluetoothLowEnergy.createService(
  service: Service,
  callback?: function,
): Promise<string>

ローカルでホストされる GATT サービスを作成します。このサービスは、ローカル GATT サーバーで利用できるように登録できます。この関数は、アプリで bluetooth:low_energy と bluetooth:peripheral の両方の権限が true に設定されている場合にのみ使用できます。周辺機器の権限は、すべてのアプリで利用できるわけではありません。

パラメータ

  • サービス

    サービス

    作成するサービス。

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    (serviceId: string) => void

    • serviceId

      文字列

戻り値

  • Promise<string>

    Chrome 91 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

disconnect()

Promise 
chrome.bluetoothLowEnergy.disconnect(
  deviceAddress: string,
  callback?: function,
): Promise<void>

指定されたアドレスのデバイスへのアプリの接続を閉じます。接続を開いている他のアプリが存在する可能性があるため、この操作で物理リンク自体が常に破棄されるとは限りません。

パラメータ

  • deviceAddress

    文字列

    リモート デバイスの Bluetooth アドレス。

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    Chrome 91 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

getCharacteristic()

Promise 
chrome.bluetoothLowEnergy.getCharacteristic(
  characteristicId: string,
  callback?: function,
): Promise<Characteristic>

指定された GATT サービスに属する、指定されたインスタンス ID を持つ GATT 特性を取得します（特性が存在する場合）。

パラメータ

  • characteristicId

    文字列

    リクエストされた GATT 特性のインスタンス ID。

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    (result: Characteristic) => void

戻り値

  • Promise<Characteristic>

    Chrome 91 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

getCharacteristics()

Promise 
chrome.bluetoothLowEnergy.getCharacteristics(
  serviceId: string,
  callback?: function,
): Promise<Characteristic[]>

指定されたサービスに属する検出されたすべての GATT 特性のリストを取得します。

パラメータ

  • serviceId

    文字列

    特性を返す GATT サービスのインスタンス ID。

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    (result: Characteristic[]) => void

戻り値

  • Promise<Characteristic[]>

    Chrome 91 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

getDescriptor()

Promise 
chrome.bluetoothLowEnergy.getDescriptor(
  descriptorId: string,
  callback?: function,
): Promise<Descriptor>

指定されたインスタンス ID の GATT 特性記述子を取得します。

パラメータ

  • descriptorId

    文字列

    リクエストされた GATT 特性記述子のインスタンス ID。

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    (result: Descriptor) => void

戻り値

  • Promise<Descriptor>

    Chrome 91 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

getDescriptors()

Promise 
chrome.bluetoothLowEnergy.getDescriptors(
  characteristicId: string,
  callback?: function,
): Promise<Descriptor[]>

指定された特性に属する GATT 特性記述子のリストを取得します。

パラメータ

  • characteristicId

    文字列

    ディスクリプタを返す GATT 特性のインスタンス ID。

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    (result: Descriptor[]) => void

戻り値

  • Promise<Descriptor[]>

    Chrome 91 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

getIncludedServices()

Promise 
chrome.bluetoothLowEnergy.getIncludedServices(
  serviceId: string,
  callback?: function,
): Promise<Service[]>

指定されたサービスに含まれる GATT サービスのリストを取得します。

パラメータ

  • serviceId

    文字列

    含まれるサービスを返す GATT サービスのインスタンス ID。

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    (result: Service[]) => void

戻り値

  • Promise<Service[]>

    Chrome 91 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

getService()

Promise 
chrome.bluetoothLowEnergy.getService(
  serviceId: string,
  callback?: function,
): Promise<Service>

指定されたインスタンス ID の GATT サービスを取得します。

パラメータ

  • serviceId

    文字列

    リクエストされた GATT サービスのインスタンス ID。

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    (result: Service) => void

戻り値

  • Promise<Service>

    Chrome 91 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

getServices()

Promise 
chrome.bluetoothLowEnergy.getServices(
  deviceAddress: string,
  callback?: function,
): Promise<Service[]>

指定されたデバイス アドレスを持つリモート デバイスで検出されたすべての GATT サービスを取得します。

注: デバイスでサービス検出がまだ完了していない場合、この API はサービスのサブセット（空の場合もあります）を返します。回避策として、時間ベースの遅延を追加するか、必要な数のサービスが返されるまで繰り返し呼び出します。

パラメータ

  • deviceAddress

    文字列

    GATT サービスを返すリモート デバイスの Bluetooth アドレス。

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    (result: Service[]) => void

戻り値

  • Promise<Service[]>

    Chrome 91 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

notifyCharacteristicValueChanged()

Promise Chrome 52 以降 
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
  characteristicId: string,
  notification: Notification,
  callback?: function,
): Promise<void>

特性の新しい値をリモート デバイスに通知します。通知オブジェクトの shouldIndicate フラグが true の場合、通知ではなくインジケーターが送信されます。なお、この呼び出しを成功させるには、作成時に特性で「notify」または「indicate」プロパティを正しく設定する必要があります。この関数は、アプリで bluetooth:low_energy と bluetooth:peripheral の両方の権限が true に設定されている場合にのみ使用できます。周辺機器の権限は、すべてのアプリで利用できるわけではありません。

パラメータ

  • characteristicId

    文字列

    通知を送信する特性。

  • 通知

    通知

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    Chrome 91 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

readCharacteristicValue()

Promise 
chrome.bluetoothLowEnergy.readCharacteristicValue(
  characteristicId: string,
  callback?: function,
): Promise<Characteristic>

リモート周辺機器から指定された特性の値を取得します。

パラメータ

  • characteristicId

    文字列

    リモート デバイスから値を読み取る GATT 特性のインスタンス ID。

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    (result: Characteristic) => void

戻り値

  • Promise<Characteristic>

    Chrome 91 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

readDescriptorValue()

Promise 
chrome.bluetoothLowEnergy.readDescriptorValue(
  descriptorId: string,
  callback?: function,
): Promise<Descriptor>

リモート周辺機器から指定された特性記述子の値を取得します。

パラメータ

  • descriptorId

    文字列

    リモート デバイスから値を読み取る GATT 特性記述子のインスタンス ID。

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    (result: Descriptor) => void

戻り値

  • Promise<Descriptor>

    Chrome 91 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

registerAdvertisement()

Promise Chrome 47+ 
chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
): Promise<number>

広告を作成し、広告用に登録します。この関数を呼び出すには、アプリの bluetooth:low_energy 権限と bluetooth:peripheral 権限を true に設定する必要があります。また、この API はキオスクモードで自動起動するアプリでのみ使用できます。または、コマンドライン スイッチ「--enable-ble-advertising-in-apps」を設定することでも使用できます。https://developer.chrome.com/apps/manifest/bluetooth を参照してください。注: 一部のハードウェアでは、セントラル モードとペリフェラル モードを同時にサポートしていますが、この機能をサポートしていないハードウェアでこの呼び出しを行うと、デバイスがペリフェラル モードに切り替わります。セントラル モードとペリフェラル モードの両方をサポートしていないハードウェアの場合、両方のモードでデバイスを使用しようとすると、未定義の動作が発生したり、他のセントラル ロール アプリケーションが正しく動作しなくなったりします（Bluetooth Low Energy デバイスの検出など）。

パラメータ

  • 広告

    広告

    宣伝する広告。

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    (advertisementId: number) => void

    • advertisementId

      数値

戻り値

  • Promise<number>

    Chrome 91 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

registerService()

Promise Chrome 52 以降 
chrome.bluetoothLowEnergy.registerService(
  serviceId: string,
  callback?: function,
): Promise<void>

指定されたサービスをローカル GATT サーバーに登録します。サービス ID が無効な場合、lastError が設定されます。この関数は、アプリで bluetooth:low_energy と bluetooth:peripheral の両方の権限が true に設定されている場合にのみ使用できます。周辺機器の権限は、すべてのアプリで利用できるわけではありません。

パラメータ

  • serviceId

    文字列

    作成されたサービスの一意の ID。

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    Chrome 91 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

removeService()

Promise Chrome 52 以降 
chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
): Promise<void>

指定されたサービスを削除します。登録されている場合は登録を解除します。サービス ID が無効な場合、lastError が設定されます。この関数は、アプリで bluetooth:low_energy と bluetooth:peripheral の両方の権限が true に設定されている場合にのみ使用できます。周辺機器の権限は、すべてのアプリで利用できるわけではありません。

パラメータ

  • serviceId

    文字列

    現在登録されているサービスの一意の ID。

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    Chrome 91 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

resetAdvertising()

Promise Chrome 61 以降 
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
): Promise<void>

現在のデバイスの広告をリセットします。登録が解除され、既存の広告はすべて停止されます。

パラメータ

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    Chrome 91 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

sendRequestResponse()

Chrome 52 以降 
chrome.bluetoothLowEnergy.sendRequestResponse(
  response: Response,
): void

特性またはディスクリプタの読み取り/書き込みリクエストに対するレスポンスを送信します。この関数は、アプリで bluetooth:low_energy と bluetooth:peripheral の両方の権限が true に設定されている場合にのみ使用できます。周辺機器の権限は、すべてのアプリで利用できるわけではありません。

パラメータ

  • レスポンス

    レスポンス

    リクエストに対するレスポンス。

setAdvertisingInterval()

Promise Chrome 55 以降 
chrome.bluetoothLowEnergy.setAdvertisingInterval(
  minInterval: number,
  maxInterval: number,
  callback?: function,
): Promise<void>

2 つの連続する広告の間隔を設定します。注: これはベスト エフォートです。実際の間隔は、リクエストされた間隔と大きく異なる場合があります。ハードウェアによっては、最小間隔が 100 ミリ秒になります。最小値と最大値は、Bluetooth 4.2 仕様で許容される範囲を超えることはできません。

パラメータ

  • minInterval

    数値

    広告間の最小間隔（ミリ秒単位）。仕様により、20 ミリ秒未満にすることはできません。

  • maxInterval

    数値

    アドバタイズメント間の最大間隔（ミリ秒単位）。これは 10240 ミリ秒を超えることはできません（仕様に準拠）。

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    Chrome 91 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

startCharacteristicNotifications()

Promise 
chrome.bluetoothLowEnergy.startCharacteristicNotifications(
  characteristicId: string,
  properties?: NotificationProperties,
  callback?: function,
): Promise<void>

指定された特性から値の通知/指示を有効にします。有効にすると、アプリケーションは onCharacteristicValueChanged イベントを使用して通知をリッスンできます。

パラメータ

  • characteristicId

    文字列

    通知を有効にする GATT 特性のインスタンス ID。

  • プロパティ

    NotificationProperties 省略可

    通知セッションのプロパティ（省略可）。

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    Chrome 91 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

stopCharacteristicNotifications()

Promise 
chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
  characteristicId: string,
  callback?: function,
): Promise<void>

指定された特性からの値の通知/指示を無効にします。呼び出しが成功すると、アプリはこの特性からの通知/指示を受信しなくなります。

パラメータ

  • characteristicId

    文字列

    このアプリの通知セッションを停止する GATT 特性のインスタンス ID。

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    Chrome 91 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

unregisterAdvertisement()

Promise Chrome 47+ 
chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
): Promise<void>

広告の登録を解除し、広告を停止します。広告の登録解除に失敗した場合、広告を停止する唯一の方法はデバイスを再起動することです。

パラメータ

  • advertisementId

    数値

    登録を解除する広告の ID。

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    Chrome 91 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

unregisterService()

Promise Chrome 52 以降 
chrome.bluetoothLowEnergy.unregisterService(
  serviceId: string,
  callback?: function,
): Promise<void>

指定されたサービスをローカル GATT サーバーから登録解除します。サービス ID が無効な場合、lastError が設定されます。この関数は、アプリで bluetooth:low_energy と bluetooth:peripheral の両方の権限が true に設定されている場合にのみ使用できます。周辺機器の権限は、すべてのアプリで利用できるわけではありません。

パラメータ

  • serviceId

    文字列

    現在登録されているサービスの一意の ID。

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    Chrome 91 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

writeCharacteristicValue()

Promise 
chrome.bluetoothLowEnergy.writeCharacteristicValue(
  characteristicId: string,
  value: ArrayBuffer,
  callback?: function,
): Promise<void>

リモート周辺機器から指定された特性の値を書き込みます。

パラメータ

  • characteristicId

    文字列

    値を書き込む GATT 特性のインスタンス ID。

  • 値

    ArrayBuffer

    書き込みリクエストの一部としてリモート特性に送信される値。

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    Chrome 91 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

writeDescriptorValue()

Promise 
chrome.bluetoothLowEnergy.writeDescriptorValue(
  descriptorId: string,
  value: ArrayBuffer,
  callback?: function,
): Promise<void>

リモート周辺機器から指定された特性記述子の値を書き込みます。

パラメータ

  • descriptorId

    文字列

    値を書き込む GATT 特性記述子のインスタンス ID。

  • 値

    ArrayBuffer

    書き込みリクエストの一部としてリモート記述子に送信される値。

  • callback

    関数 省略可

    callback パラメータは次のようになります。 

    () => void

戻り値

  • Promise<void>

    Chrome 91 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。

イベント

onCharacteristicReadRequest

Chrome 52 以降 
chrome.bluetoothLowEnergy.onCharacteristicReadRequest.addListener(
  callback: function,
)

接続されたセントラル デバイスが、ローカル GATT サーバーに登録された特性の値を読み取るようリクエストしたときに発生します。このリクエストに長時間応答しないと、接続が切断されることがあります。このイベントは、アプリの bluetooth:low_energy と bluetooth:peripheral の両方の権限が true に設定されている場合にのみ使用できます。周辺機器の権限は、すべてのアプリで利用できるわけではありません。

パラメータ

  • callback

    関数

    callback パラメータは次のようになります。 

    (request: Request, characteristicId: string) => void

onCharacteristicValueChanged

chrome.bluetoothLowEnergy.onCharacteristicValueChanged.addListener(
  callback: function,
)

リモート GATT 特性の値が変更されたときに発生します。読み取りリクエストの結果として変更された場合と、値変更の通知/指示として変更された場合があります。このイベントは、アプリが startCharacteristicNotifications を呼び出して通知を有効にした場合にのみ送信されます。

パラメータ

  • callback

    関数

    callback パラメータは次のようになります。 

    (characteristic: Characteristic) => void

onCharacteristicWriteRequest

Chrome 52 以降 
chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
  callback: function,
)

接続されたセントラル デバイスが、ローカル GATT サーバーに登録された特性の値を書き込むようリクエストしたときに発生します。このリクエストに長時間応答しないと、接続が切断されることがあります。このイベントは、アプリの bluetooth:low_energy と bluetooth:peripheral の両方の権限が true に設定されている場合にのみ使用できます。周辺機器の権限は、すべてのアプリで利用できるわけではありません。

パラメータ

  • callback

    関数

    callback パラメータは次のようになります。 

    (request: Request, characteristicId: string) => void

onDescriptorReadRequest

Chrome 52 以降 
chrome.bluetoothLowEnergy.onDescriptorReadRequest.addListener(
  callback: function,
)

接続されたセントラル デバイスがローカル GATT サーバーに登録されたディスクリプタの値を読み取るようリクエストしたときに発生します。このリクエストに長時間応答しないと、接続が切断されることがあります。このイベントは、アプリの bluetooth:low_energy と bluetooth:peripheral の両方の権限が true に設定されている場合にのみ使用できます。周辺機器の権限は、すべてのアプリで利用できるわけではありません。

パラメータ

  • callback

    関数

    callback パラメータは次のようになります。 

    (request: Request, descriptorId: string) => void

onDescriptorValueChanged

chrome.bluetoothLowEnergy.onDescriptorValueChanged.addListener(
  callback: function,
)

通常、読み取りリクエストの結果として、リモート GATT 特性記述子の値が変更されたときに発生します。このイベントは主に便宜上のもので、readDescriptorValue の呼び出しが成功した後に必ず送信されます。

パラメータ

  • callback

    関数

    callback パラメータは次のようになります。 

    (descriptor: Descriptor) => void

onDescriptorWriteRequest

Chrome 52 以降 
chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
  callback: function,
)

接続されたセントラル デバイスがローカル GATT サーバーに登録されたディスクリプタの値を書き込むようリクエストしたときに発生します。このリクエストに長時間応答しないと、接続が切断されることがあります。このイベントは、アプリの bluetooth:low_energy と bluetooth:peripheral の両方の権限が true に設定されている場合にのみ使用できます。周辺機器の権限は、すべてのアプリで利用できるわけではありません。

パラメータ

  • callback

    関数

    callback パラメータは次のようになります。 

    (request: Request, descriptorId: string) => void

onServiceAdded

chrome.bluetoothLowEnergy.onServiceAdded.addListener(
  callback: function,
)

リモート デバイスで新しい GATT サービスが検出されたときに発生します。

パラメータ

  • callback

    関数

    callback パラメータは次のようになります。 

    (service: Service) => void

onServiceChanged

chrome.bluetoothLowEnergy.onServiceChanged.addListener(
  callback: function,
)

リモート GATT サービスのステータスが変更されたときに発生します。これには、サービスに追加または削除される特性や記述子、リモート デバイスからの「ServiceChanged」通知が含まれます。

パラメータ

  • callback

    関数

    callback パラメータは次のようになります。 

    (service: Service) => void

onServiceRemoved

chrome.bluetoothLowEnergy.onServiceRemoved.addListener(
  callback: function,
)

リモート デバイスで以前に検出された GATT サービスが削除されたときに発生します。

パラメータ

  • callback

    関数

    callback パラメータは次のようになります。 

    (service: Service) => void