chrome.bluetoothLowEnergy

說明

chrome.bluetoothLowEnergy API 的用途是透過一般屬性設定檔 (GATT) 與藍牙智慧型 (低功耗) 裝置通訊。

資訊清單

您必須在資訊清單中宣告下列金鑰，才能使用這個 API。

"bluetooth"

類型

Advertisement

Chrome 47 以上版本

屬性

• manufacturerData

  ManufacturerData[] 選填

  要納入廣告資料「製造商專屬資料」欄位中的製造商專屬資料清單。

• serviceData

  ServiceData[] 選用

  要包含在廣告資料「服務資料」欄位的服務資料清單。

• serviceUuids

  string[] 選填

  要加進廣告資料「服務 UUID」欄位的 UUID 清單。以下 UUID 可為 16 位元、32 位元或 128 格式。

• solicitUuids

  string[] 選填

  要加進廣告資料「Solicit UUIDs」欄位的 UUID 清單。以下 UUID 可為 16 位元、32 位元或 128 格式。

• 類型

  AdvertisementType

  廣告的類型。

AdvertisementType

Chrome 47 以上版本

廣告的類型。如果選擇「廣播」，已傳送的廣告類型就會是 ADV_NONCONN_IND，且裝置會使用隨機 MAC 位址廣播。如果設為「週邊裝置」，廣告類型會是 ADV_IND 或 ADV_SCAN_IND，並透過真實藍牙轉接器的 MAC 位址廣播。

列舉

Characteristic

屬性

• instanceId

  字串 選用

  傳回指派給這個特性的 ID。使用執行個體 ID 來區分具有相同 UUID 的周邊裝置特性，以及執行使用特徵 ID 的函式呼叫。如果這個例項代表遠端特性，則為存在。

• 資源

  CharacteristicProperty[]

  這個特性的特性。

• 服務

  服務 選填

  這個特性所屬的 GATT 服務。

• uuid

  字串

  特性的 UUID，例如 00002a37-0000-1000-8000-00805f9b34fb。

• 值

  ArrayBuffer 選用

  目前快取的特性值。當系統透過通知或指示讀取或更新特徵值時，就會更新這個值。

CharacteristicProperty

值代表特徵可能的屬性。特性權限是從這些屬性推測得出。請參閱藍牙 4.x 規格，瞭解每個屬性的含義。

列舉

"read"

"writeWithoutResponse"

"authenticatedSignedWrites"

"extendedProperties"

"reliableWrite"

"writableAuxiliaries"

ConnectProperties

屬性

• 永久

  boolean

  此標記可註明在應用程式卸載時，是否要開啟裝置連線 (請參閱「管理應用程式生命週期」)。預設值為 false.

Descriptor

屬性

• 特徵

  特性 選用

  這個描述元所屬的 GATT 特性。

• instanceId

  字串 選用

  傳回指派給這個描述元的 ID。使用執行個體 ID 來區分描述元與具有相同 UUID 的周邊裝置，並提出採用描述元 ID 的函式呼叫。如果這個例項代表遠端特性，則為存在。

• 權限

  DescriptorPermission[]

  Chrome 52 以上版本

  這個描述元的權限。

• uuid

  字串

  特徵描述元的 UUID，例如 00002902-0000-1000-8000-00805f9b34fb。

• 值

  ArrayBuffer 選用

  目前快取的描述元值。讀取描述元的值時，這個值會更新。

DescriptorPermission

Chrome 52 以上版本

代表描述元可能權限的值。請參閱藍牙 4.x 規格，瞭解每項權限的意義。

列舉

"read"

Device

Chrome 52 以上版本

屬性

• 地址

  字串

  裝置的地址，格式為「XX:XX:XX:XX:XX:XX」。

• deviceClass

  數字 選填

  裝置的類別，由 http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband 定義的位元欄位。

• 名稱

  字串 選用

  使用者可理解的裝置名稱。

ManufacturerData

Chrome 47 以上版本

屬性

• 資料或曾存取這類資料的人員

  數字 []

• id

  號碼

Notification

Chrome 52 以上版本

屬性

• shouldIndicate

  布林值 (選用)

  用於傳送指示而非通知的選用標記。

• 值

  ArrayBuffer

  特徵的新值。

NotificationProperties

屬性

• 永久

  boolean

  此標記可註明應用程式是否應在應用程式的事件頁面卸載時接收通知 (請參閱「管理應用程式生命週期」)。預設值為 false。

Request

Chrome 52 以上版本

屬性

• 裝置

  裝置

  傳送這項要求的裝置。

• requestId

  號碼

  此要求的專屬 ID。回應這項要求時，請使用這個 ID。

• 值

  ArrayBuffer 選用

  要寫入的值 (如果這是寫入要求)。

Response

Chrome 52 以上版本

屬性

• isError

  boolean

  如果這是錯誤回應，則應為 true。

• requestId

  號碼

  要回應的要求 ID。

• 值

  ArrayBuffer 選用

  回應值。寫入要求和錯誤回應會忽略這個參數。

Service

屬性

• deviceAddress

  字串 選用

  GATT 服務所屬的遠端週邊裝置裝置位址。如果這個執行個體代表遠端服務，則存在此屬性。

• instanceId

  字串 選用

  傳回指派給這項服務的 ID。使用執行個體 ID 來區分服務與具有相同 UUID 的周邊裝置，以及發出接收服務 ID 的函式呼叫。如果這個執行個體代表遠端服務，則存在此屬性。

• isPrimary

  boolean

  指出這項服務的類型為主要或次要類型。

• uuid

  字串

  服務的 UUID，例如 0000180d-0000-1000-8000-00805f9b34fb。

ServiceData

Chrome 47 以上版本

屬性

• 資料或曾存取這類資料的人員

  數字 []

• uuid

  字串

方法

connect()

Promise

chrome.bluetoothLowEnergy.connect(
  deviceAddress: string,
  properties?: ConnectProperties,
  callback?: function,
)

在指定位址的應用程式和裝置之間建立連線。裝置可能已經連線，且不必呼叫 connect 就能使用 GATT 服務。不過，如果應用程式要存取裝置中的 GATT 服務，則應呼叫這個函式，確保與裝置的連線維持連線狀態。如果未連線，成功呼叫 connect 後，系統會探索裝置的所有 GATT 服務。

參數

• deviceAddress

  字串

  應開啟 GATT 連線的遠端裝置的藍牙位址。

• 資源

  ConnectProperties 選用

  連線屬性 (選用)。

• 回呼

  函式選用

  callback 參數如下所示：

  ()=>void

傳回

• Promise<void>

  Chrome 91 以上版本

  Promise 僅支援 Manifest V3 以上版本，其他平台就必須使用回呼。

createCharacteristic()

Promise Chrome 52 以上版本

chrome.bluetoothLowEnergy.createCharacteristic(
  characteristic: Characteristic,
  serviceId: string,
  callback?: function,
)

建立本地代管的 GATT 特性。這項特性必須託管於有效的服務。如果服務 ID 無效，則會設定 lastError。只有在應用程式同時將「Bluetooth:low_energy」和「藍牙：週邊裝置」權限設為 true 時，才能使用此功能。某些週邊裝置權限可能不適用於所有應用程式。

參數

• 特徵

  特色

  要建立的特性。

• serviceId

  字串

  要建立這個特性的服務 ID。

• 回呼

  函式選用

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

建立本機託管的 GATT 描述元。這個描述元必須由有效的特性代管。如果特性 ID 無效，則會設定 lastError。只有在應用程式同時將「Bluetooth:low_energy」和「藍牙：週邊裝置」權限設為 true 時，才能使用此功能。某些週邊裝置權限可能不適用於所有應用程式。

參數

• 描述元

  描述元

  要建立的描述元。

• characteristicId

  字串

  要建立這個描述元的特徵 ID。

• 回呼

  函式選用

  callback 參數如下所示：

  (descriptorId: string)=>void

  • descriptorId

    字串

傳回

• Promise<string>

  Chrome 91 以上版本

  Promise 僅支援 Manifest V3 以上版本，其他平台就必須使用回呼。

createService()

Promise Chrome 52 以上版本

chrome.bluetoothLowEnergy.createService(
  service: Service,
  callback?: function,
)

建立本機代管的 GATT 服務。您可以註冊這項服務，供本機 GATT 伺服器上使用。只有在應用程式同時將「Bluetooth:low_energy」和「藍牙：週邊裝置」權限設為 true 時，才能使用此功能。某些週邊裝置權限可能不適用於所有應用程式。

參數

• 服務

  Service

  要建立的服務。

• 回呼

  函式選用

  callback 參數如下所示：

  (serviceId: string)=>void

  • serviceId

    字串

傳回

• Promise<string>

  Chrome 91 以上版本

  Promise 僅支援 Manifest V3 以上版本，其他平台就必須使用回呼。

disconnect()

Promise

chrome.bluetoothLowEnergy.disconnect(
  deviceAddress: string,
  callback?: function,
)

關閉與指定地址的裝置連線。請注意，此方法不一定會刪除實體連結本身，因為其他應用程式可能已有公開連線。

參數

• deviceAddress

  字串

  遠端裝置的藍牙位址。

• 回呼

  函式選用

  callback 參數如下所示：

  ()=>void

傳回

• Promise<void>

  Chrome 91 以上版本

  Promise 僅支援 Manifest V3 以上版本，其他平台就必須使用回呼。

getCharacteristic()

Promise

chrome.bluetoothLowEnergy.getCharacteristic(
  characteristicId: string,
  callback?: function,
)

根據屬於特定 GATT 服務的特定執行個體 ID，取得 GATT 特性 (如果特性存在)。

參數

• characteristicId

  字串

  所要求 GATT 特徵的執行個體 ID。

• 回呼

  函式選用

  callback 參數如下所示：

  (result: Characteristic)=>void

  • 結果

    特色

傳回

• Promise<Characteristic>

  Chrome 91 以上版本

  Promise 僅支援 Manifest V3 以上版本，其他平台就必須使用回呼。

getCharacteristics()

Promise

chrome.bluetoothLowEnergy.getCharacteristics(
  serviceId: string,
  callback?: function,
)

取得屬於指定服務的所有已發現 GATT 特性的清單。

參數

• serviceId

  字串

  應傳回其特性的 GATT 服務執行個體 ID。

• 回呼

  函式選用

  callback 參數如下所示：

  (result: Characteristic[])=>void

  • 結果

    特色[]

傳回

• Promise<Characteristic[]>

  Chrome 91 以上版本

  Promise 僅支援 Manifest V3 以上版本，其他平台就必須使用回呼。

getDescriptor()

Promise

chrome.bluetoothLowEnergy.getDescriptor(
  descriptorId: string,
  callback?: function,
)

取得具有指定執行個體 ID 的 GATT 字元描述元。

參數

• descriptorId

  字串

  所要求 GATT 字元描述元的執行個體 ID。

• 回呼

  函式選用

  callback 參數如下所示：

  (result: Descriptor)=>void

  • 結果

    描述元

傳回

• Promise<Descriptor>

  Chrome 91 以上版本

  Promise 僅支援 Manifest V3 以上版本，其他平台就必須使用回呼。

getDescriptors()

Promise

chrome.bluetoothLowEnergy.getDescriptors(
  characteristicId: string,
  callback?: function,
)

取得屬於指定特性的 GATT 特性描述元清單。

參數

• characteristicId

  字串

  應傳回描述元的 GATT 字元的執行個體 ID。

• 回呼

  函式選用

  callback 參數如下所示：

  (result: Descriptor[])=>void

  • 結果

    描述元[]

傳回

• Promise<Descriptor[]>

  Chrome 91 以上版本

  Promise 僅支援 Manifest V3 以上版本，其他平台就必須使用回呼。

getIncludedServices()

Promise

chrome.bluetoothLowEnergy.getIncludedServices(
  serviceId: string,
  callback?: function,
)

取得所包含的 GATT 服務清單。

參數

• serviceId

  字串

  應傳回 GATT 服務的執行個體 ID。

• 回呼

  函式選用

  callback 參數如下所示：

  (result: Service[])=>void

  • 結果

    服務[]

傳回

• Promise<服務[]>

  Chrome 91 以上版本

  Promise 僅支援 Manifest V3 以上版本，其他平台就必須使用回呼。

getService()

Promise

chrome.bluetoothLowEnergy.getService(
  serviceId: string,
  callback?: function,
)

取得具有指定執行個體 ID 的 GATT 服務。

參數

• serviceId

  字串

  所要求 GATT 服務的執行個體 ID。

• 回呼

  函式選用

  callback 參數如下所示：

  (result: Service)=>void

  • 結果

    Service

傳回

• Promise<服務>

  Chrome 91 以上版本

  Promise 僅支援 Manifest V3 以上版本，其他平台就必須使用回呼。

getServices()

Promise

chrome.bluetoothLowEnergy.getServices(
  deviceAddress: string,
  callback?: function,
)

透過指定裝置位址取得在遠端裝置上發現的所有 GATT 服務。

注意：如果裝置尚未完成服務探索，這個 API 會傳回部分服務 (可能沒有內容)。替代方案是新增根據時間設定的延遲時間和/或重複呼叫，直到服務傳回預期的服務數量為止。

參數

• deviceAddress

  字串

  應傳回 GATT 服務的遠端裝置藍牙位址。

• 回呼

  函式選用

  callback 參數如下所示：

  (result: Service[])=>void

  • 結果

    服務[]

傳回

• Promise<服務[]>

  Chrome 91 以上版本

  Promise 僅支援 Manifest V3 以上版本，其他平台就必須使用回呼。

notifyCharacteristicValueChanged()

Promise Chrome 52 以上版本

chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
  characteristicId: string,
  notification: Notification,
  callback?: function,
)

通知遠端裝置是否有特性的新值。如果通知物件中的 shouldIndicate 標記為 true，系統會傳送指示，而不是通知。請注意，特性必須在建立期間正確設定「notify」或「indicate」屬性，呼叫才能成功。只有在應用程式同時將「Bluetooth:low_energy」和「藍牙：週邊裝置」權限設為 true 時，才能使用此功能。某些週邊裝置權限可能不適用於所有應用程式。

參數

• characteristicId

  字串

  用於傳送標記的特性。

• 通知

  通知

• 回呼

  函式選用

  callback 參數如下所示：

  ()=>void

傳回

• Promise<void>

  Chrome 91 以上版本

  Promise 僅支援 Manifest V3 以上版本，其他平台就必須使用回呼。

readCharacteristicValue()

Promise

chrome.bluetoothLowEnergy.readCharacteristicValue(
  characteristicId: string,
  callback?: function,
)

從遠端週邊裝置擷取指定特性的值。

參數

• characteristicId

  字串

  GATT 特性的執行個體 ID，其值應從遠端裝置讀取。

• 回呼

  函式選用

  callback 參數如下所示：

  (result: Characteristic)=>void

  • 結果

    特色

傳回

• Promise<Characteristic>

  Chrome 91 以上版本

  Promise 僅支援 Manifest V3 以上版本，其他平台就必須使用回呼。

readDescriptorValue()

Promise

chrome.bluetoothLowEnergy.readDescriptorValue(
  descriptorId: string,
  callback?: function,
)

從遠端週邊裝置擷取指定特性描述元的值。

參數

• descriptorId

  字串

  GATT 字元描述元的執行個體 ID，其值必須從遠端裝置讀取。

• 回呼

  函式選用

  callback 參數如下所示：

  (result: Descriptor)=>void

  • 結果

    描述元

傳回

• Promise<Descriptor>

  Chrome 91 以上版本

  Promise 僅支援 Manifest V3 以上版本，其他平台就必須使用回呼。

registerAdvertisement()

Promise Chrome 47 以上版本

chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
)

建立廣告並註冊用於放送廣告。如要呼叫這個函式，應用程式必須將 Bluetooth:low_energy 和藍牙：週邊裝置權限設為 true。此外，這個 API 僅適用於在資訊站模式中自動啟動的應用程式，或是設定「--enable-ble-advertising-in-apps」指令列切換工具。詳情請參閱 https://developer.chrome.com/apps/manifest/bluetooth。注意：部分硬體可同時支援中央和周邊裝置模式，但如果硬體不支援這項功能，系統會將裝置切換為週邊模式。在不支援中樞裝置和周邊裝置模式的硬體中，嘗試以這兩種模式使用裝置會導致未定義的行為，或者導致其他核心角色應用程式無法正常運作 (包括發現藍牙低功耗裝置)。

參數

• 廣告

  廣告

  要宣傳的廣告。

• 回呼

  函式選用

  callback 參數如下所示：

  (advertisementId: number)=>void

  • advertisementId

    號碼

傳回

• Promise<number>

  Chrome 91 以上版本

  Promise 僅支援 Manifest V3 以上版本，其他平台就必須使用回呼。

registerService()

Promise Chrome 52 以上版本

chrome.bluetoothLowEnergy.registerService(
  serviceId: string,
  callback?: function,
)

在本機 GATT 伺服器上註冊指定服務。如果服務 ID 無效，系統會設定 lastError。只有在應用程式同時將「Bluetooth:low_energy」和「藍牙：週邊裝置」權限設為 true 時，才能使用此功能。某些週邊裝置權限可能不適用於所有應用程式。

參數

• serviceId

  字串

  所建立服務的專屬 ID。

• 回呼

  函式選用

  callback 參數如下所示：

  ()=>void

傳回

• Promise<void>

  Chrome 91 以上版本

  Promise 僅支援 Manifest V3 以上版本，其他平台就必須使用回呼。

removeService()

Promise Chrome 52 以上版本

chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
)

移除指定服務；如果已註冊，請取消註冊服務。如果服務 ID 無效，系統會設定 lastError。只有在應用程式同時將「Bluetooth:low_energy」和「藍牙：週邊裝置」權限設為 true 時，才能使用此功能。某些週邊裝置權限可能不適用於所有應用程式。

參數

• serviceId

  字串

  目前註冊服務的專屬 ID。

• 回呼

  函式選用

  callback 參數如下所示：

  ()=>void

傳回

• Promise<void>

  Chrome 91 以上版本

  Promise 僅支援 Manifest V3 以上版本，其他平台就必須使用回呼。

resetAdvertising()

Promise Chrome 61 以上版本

chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
)

重設目前裝置上的廣告。它會取消註冊並停止所有現有的廣告。

參數

• 回呼

  函式選用

  callback 參數如下所示：

  ()=>void

傳回

• Promise<void>

  Chrome 91 以上版本

  Promise 僅支援 Manifest V3 以上版本，其他平台就必須使用回呼。

sendRequestResponse()

Chrome 52 以上版本

chrome.bluetoothLowEnergy.sendRequestResponse(
  response: Response,
)

針對特徵或描述元讀取/寫入要求傳送回應。只有在應用程式同時將「Bluetooth:low_energy」和「藍牙：週邊裝置」權限設為 true 時，才能使用此功能。某些週邊裝置權限可能不適用於所有應用程式。

參數

• 則回應

  回應

  要求的回應。

setAdvertisingInterval()

Promise Chrome 55 以上版本

chrome.bluetoothLowEnergy.setAdvertisingInterval(
  minInterval: number,
  maxInterval: number,
  callback?: function,
)

請設定兩個連續廣告的間隔。注意：這會盡力進行。實際間隔時間可能會與要求的間隔時間不相上下。在某些硬體上，最短間隔為 100 毫秒。最小值和最大值不得超過 Bluetooth 4.2 規格允許的範圍。

參數

• minInterval

  號碼

  廣告之間的最小間隔 (以毫秒為單位)。這個值不得低於 20 毫秒 (根據規格)。

• maxInterval

  號碼

  廣告之間的時間間隔上限 (以毫秒為單位)。根據規格，這個值不得超過 10240 毫秒。

• 回呼

  函式選用

  callback 參數如下所示：

  ()=>void

傳回

• Promise<void>

  Chrome 91 以上版本

  Promise 僅支援 Manifest V3 以上版本，其他平台就必須使用回呼。

startCharacteristicNotifications()

Promise

chrome.bluetoothLowEnergy.startCharacteristicNotifications(
  characteristicId: string,
  properties?: NotificationProperties,
  callback?: function,
)

啟用指定特性的值通知/指示。啟用後，應用程式即可透過 onCharacteristicValueChanged 事件監聽通知。

參數

• characteristicId

  字串

  應啟用通知的 GATT 特性執行個體 ID。

• 資源

  NotificationProperties 選用

  通知工作階段屬性 (選用)。

• 回呼

  函式選用

  callback 參數如下所示：

  ()=>void

傳回

• Promise<void>

  Chrome 91 以上版本

  Promise 僅支援 Manifest V3 以上版本，其他平台就必須使用回呼。

stopCharacteristicNotifications()

Promise

chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
  characteristicId: string,
  callback?: function,
)

停用指定特性的值通知/指示。成功呼叫後，應用程式就不會再收到這個特性的通知/指示。

參數

• characteristicId

  字串

  這個應用程式的通知工作階段應停止的 GATT 功能執行個體 ID。

• 回呼

  函式選用

  callback 參數如下所示：

  ()=>void

傳回

• Promise<void>

  Chrome 91 以上版本

  Promise 僅支援 Manifest V3 以上版本，其他平台就必須使用回呼。

unregisterAdvertisement()

Promise Chrome 47 以上版本

chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
)

取消註冊廣告並停止放送廣告。如果廣告無法取消註冊，那麼就只能重新啟動裝置。

參數

• advertisementId

  號碼

  要取消註冊的廣告 ID。

• 回呼

  函式選用

  callback 參數如下所示：

  ()=>void

傳回

• Promise<void>

  Chrome 91 以上版本

  Promise 僅支援 Manifest V3 以上版本，其他平台就必須使用回呼。

unregisterService()

Promise Chrome 52 以上版本

chrome.bluetoothLowEnergy.unregisterService(
  serviceId: string,
  callback?: function,
)

向本機 GATT 伺服器取消註冊特定服務。如果服務 ID 無效，系統會設定 lastError。只有在應用程式同時將「Bluetooth:low_energy」和「藍牙：週邊裝置」權限設為 true 時，才能使用此功能。某些週邊裝置權限可能不適用於所有應用程式。

參數

• serviceId

  字串

  目前註冊服務的專屬 ID。

• 回呼

  函式選用

  callback 參數如下所示：

  ()=>void

傳回

• Promise<void>

  Chrome 91 以上版本

  Promise 僅支援 Manifest V3 以上版本，其他平台就必須使用回呼。

writeCharacteristicValue()

Promise

chrome.bluetoothLowEnergy.writeCharacteristicValue(
  characteristicId: string,
  value: ArrayBuffer,
  callback?: function,
)

從遠端週邊裝置寫入指定特徵的值。

參數

• characteristicId

  字串

  應寫入 GATT 特性的執行個體 ID。

• 值

  ArrayBuffer

  應在寫入要求中傳送至遠端特性的值。

• 回呼

  函式選用

  callback 參數如下所示：

  ()=>void

傳回

• Promise<void>

  Chrome 91 以上版本

  Promise 僅支援 Manifest V3 以上版本，其他平台就必須使用回呼。

writeDescriptorValue()

Promise

chrome.bluetoothLowEnergy.writeDescriptorValue(
  descriptorId: string,
  value: ArrayBuffer,
  callback?: function,
)

從遠端週邊裝置寫入指定特性描述元的值。

參數

• descriptorId

  字串

  應寫入 GATT 字元描述元的執行個體 ID。

• 值

  ArrayBuffer

  應該在寫入要求中傳送至遠端描述元的值。

• 回呼

  函式選用

  callback 參數如下所示：

  ()=>void

傳回

• Promise<void>

  Chrome 91 以上版本

  Promise 僅支援 Manifest V3 以上版本，其他平台就必須使用回呼。

活動

onCharacteristicReadRequest

Chrome 52 以上版本

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

當已連結的中央裝置要求讀取本機 GATT 伺服器上註冊的特徵值時，就會觸發如果您長時間沒有回應此要求，可能會導致連線中斷。只有在應用程式同時將「藍牙」和「藍牙」權限設為「true」時，系統才會提供此事件。某些週邊裝置權限可能不適用於所有應用程式。

參數

• 回呼

  功能

  callback 參數如下所示：

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

  • 申請。

    要求

  • characteristicId

    字串

onCharacteristicValueChanged

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

當遠端 GATT 特性的值變更 (例如讀取要求，或值變更通知/指示) 時，會觸發此事件。應用程式必須呼叫 startCharacteristicNotifications 並啟用通知，才會傳送這個事件。

參數

• 回呼

  功能

  callback 參數如下所示：

  (characteristic: Characteristic)=>void

  • 特徵

    特色

onCharacteristicWriteRequest

Chrome 52 以上版本

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

當連線的中央裝置要求寫入本機 GATT 伺服器上註冊的特徵值時，就會觸發如果您長時間沒有回應此要求，可能會導致連線中斷。只有在應用程式同時將「藍牙」和「藍牙」權限設為「true」時，系統才會提供此事件。某些週邊裝置權限可能不適用於所有應用程式。

參數

• 回呼

  功能

  callback 參數如下所示：

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

  • 申請。

    要求

  • characteristicId

    字串

onDescriptorReadRequest

Chrome 52 以上版本

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

當已連結的中央裝置要求讀取本機 GATT 伺服器上註冊的描述元的值時，就會觸發如果您長時間沒有回應此要求，可能會導致連線中斷。只有在應用程式同時將「藍牙」和「藍牙」權限設為「true」時，系統才會提供此事件。某些週邊裝置權限可能不適用於所有應用程式。

參數

• 回呼

  功能

  callback 參數如下所示：

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

  • 申請。

    要求

  • descriptorId

    字串

onDescriptorValueChanged

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

當遠端 GATT 字元描述元的值變更時 (通常是讀取要求的結果)，就會觸發這個事件。為方便起見，此事件主要是存在，且一律會在成功呼叫 readDescriptorValue 後傳送。

參數

• 回呼

  功能

  callback 參數如下所示：

  (descriptor: Descriptor)=>void

  • 描述元

    描述元

onDescriptorWriteRequest

Chrome 52 以上版本

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

當已連結的中央裝置要求寫入本機 GATT 伺服器上註冊的描述元的值時，就會觸發如果您長時間沒有回應此要求，可能會導致連線中斷。只有在應用程式同時將「藍牙」和「藍牙」權限設為「true」時，系統才會提供此事件。某些週邊裝置權限可能不適用於所有應用程式。

參數

• 回呼

  功能

  callback 參數如下所示：

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

  • 申請。

    要求

  • descriptorId

    字串

onServiceAdded

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

已在遠端裝置上發現一項新的 GATT 服務，火焰了。

參數

• 回呼

  功能

  callback 參數如下所示：

  (service: Service)=>void

  • 服務

    Service

onServiceChanged

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

遠端 GATT 服務的狀態變更時觸發。這包括任何從服務中新增或移除的特性和/或描述元，以及來自遠端裝置的「ServiceChanged」通知。

參數

• 回呼

  功能

  callback 參數如下所示：

  (service: Service)=>void

  • 服務

    Service

onServiceRemoved

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

先前在遠端裝置上發現的 GATT 服務遭到移除時觸發。

參數

• 回呼

  功能

  callback 參數如下所示：

  (service: Service)=>void

  • 服務

    Service