說明
chrome.bluetoothLowEnergy
API 的用途是透過一般屬性設定檔 (GATT) 與藍牙智慧型 (低功耗) 裝置通訊。
資訊清單
類型
Advertisement
屬性
-
manufacturerData
ManufacturerData[] 選填
要納入廣告資料「製造商專屬資料」欄位中的製造商專屬資料清單。
-
serviceData
ServiceData[] 選用
要包含在廣告資料「服務資料」欄位的服務資料清單。
-
serviceUuids
string[] 選填
要加進廣告資料「服務 UUID」欄位的 UUID 清單。以下 UUID 可為 16 位元、32 位元或 128 格式。
-
solicitUuids
string[] 選填
要加進廣告資料「Solicit UUIDs」欄位的 UUID 清單。以下 UUID 可為 16 位元、32 位元或 128 格式。
-
廣告的類型。
AdvertisementType
廣告的類型。如果選擇「廣播」,已傳送的廣告類型就會是 ADV_NONCONN_IND,且裝置會使用隨機 MAC 位址廣播。如果設為「週邊裝置」,廣告類型會是 ADV_IND 或 ADV_SCAN_IND,並透過真實藍牙轉接器的 MAC 位址廣播。
列舉
Characteristic
屬性
-
instanceId
字串 選用
傳回指派給這個特性的 ID。使用執行個體 ID 來區分具有相同 UUID 的周邊裝置特性,以及執行使用特徵 ID 的函式呼叫。如果這個例項代表遠端特性,則為存在。
-
這個特性的特性。
-
服務
服務 選填
這個特性所屬的 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 的函式呼叫。如果這個例項代表遠端特性,則為存在。
-
權限Chrome 52 以上版本
這個描述元的權限。
-
uuid
字串
特徵描述元的 UUID,例如 00002902-0000-1000-8000-00805f9b34fb。
-
值
ArrayBuffer 選用
目前快取的描述元值。讀取描述元的值時,這個值會更新。
DescriptorPermission
代表描述元可能權限的值。請參閱藍牙 4.x 規格,瞭解每項權限的意義。
列舉
"read"
Device
屬性
-
地址
字串
裝置的地址,格式為「XX:XX:XX:XX:XX:XX」。
-
deviceClass
數字 選填
裝置的類別,由 http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband 定義的位元欄位。
-
名稱
字串 選用
使用者可理解的裝置名稱。
ManufacturerData
屬性
-
資料或曾存取這類資料的人員
數字 []
-
id
號碼
Notification
屬性
-
shouldIndicate
布林值 (選用)
用於傳送指示而非通知的選用標記。
-
值
ArrayBuffer
特徵的新值。
NotificationProperties
屬性
-
永久
boolean
此標記可註明應用程式是否應在應用程式的事件頁面卸載時接收通知 (請參閱「管理應用程式生命週期」)。預設值為
false
。
Request
屬性
-
裝置
傳送這項要求的裝置。
-
requestId
號碼
此要求的專屬 ID。回應這項要求時,請使用這個 ID。
-
值
ArrayBuffer 選用
要寫入的值 (如果這是寫入要求)。
Response
屬性
-
isError
boolean
如果這是錯誤回應,則應為 true。
-
requestId
號碼
要回應的要求 ID。
-
值
ArrayBuffer 選用
回應值。寫入要求和錯誤回應會忽略這個參數。
Service
屬性
-
deviceAddress
字串 選用
GATT 服務所屬的遠端週邊裝置裝置位址。如果這個執行個體代表遠端服務,則存在此屬性。
-
instanceId
字串 選用
傳回指派給這項服務的 ID。使用執行個體 ID 來區分服務與具有相同 UUID 的周邊裝置,以及發出接收服務 ID 的函式呼叫。如果這個執行個體代表遠端服務,則存在此屬性。
-
isPrimary
boolean
指出這項服務的類型為主要或次要類型。
-
uuid
字串
服務的 UUID,例如 0000180d-0000-1000-8000-00805f9b34fb。
ServiceData
屬性
-
資料或曾存取這類資料的人員
數字 []
-
uuid
字串
方法
connect()
chrome.bluetoothLowEnergy.connect(
deviceAddress: string,
properties?: ConnectProperties,
callback?: function,
)
在指定位址的應用程式和裝置之間建立連線。裝置可能已經連線,且不必呼叫 connect
就能使用 GATT 服務。不過,如果應用程式要存取裝置中的 GATT 服務,則應呼叫這個函式,確保與裝置的連線維持連線狀態。如果未連線,成功呼叫 connect
後,系統會探索裝置的所有 GATT 服務。
參數
-
deviceAddress
字串
應開啟 GATT 連線的遠端裝置的藍牙位址。
-
資源
連線屬性 (選用)。
-
回呼
函式選用
callback
參數如下所示:() => void
傳回
-
Promise<void>
Chrome 91 以上版本Promise 僅支援 Manifest V3 以上版本,其他平台就必須使用回呼。
createCharacteristic()
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()
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()
chrome.bluetoothLowEnergy.createService(
service: Service,
callback?: function,
)
建立本機代管的 GATT 服務。您可以註冊這項服務,供本機 GATT 伺服器上使用。只有在應用程式同時將「Bluetooth:low_energy」和「藍牙:週邊裝置」權限設為 true 時,才能使用此功能。某些週邊裝置權限可能不適用於所有應用程式。
參數
-
服務
要建立的服務。
-
回呼
函式選用
callback
參數如下所示:(serviceId: string) => void
-
serviceId
字串
-
傳回
-
Promise<string>
Chrome 91 以上版本Promise 僅支援 Manifest V3 以上版本,其他平台就必須使用回呼。
disconnect()
chrome.bluetoothLowEnergy.disconnect(
deviceAddress: string,
callback?: function,
)
關閉與指定地址的裝置連線。請注意,此方法不一定會刪除實體連結本身,因為其他應用程式可能已有公開連線。
參數
-
deviceAddress
字串
遠端裝置的藍牙位址。
-
回呼
函式選用
callback
參數如下所示:() => void
傳回
-
Promise<void>
Chrome 91 以上版本Promise 僅支援 Manifest V3 以上版本,其他平台就必須使用回呼。
getCharacteristic()
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()
chrome.bluetoothLowEnergy.getCharacteristics(
serviceId: string,
callback?: function,
)
取得屬於指定服務的所有已發現 GATT 特性的清單。
參數
-
serviceId
字串
應傳回其特性的 GATT 服務執行個體 ID。
-
回呼
函式選用
callback
參數如下所示:(result: Characteristic[]) => void
-
結果
特色[]
-
傳回
-
Promise<Characteristic[]>
Chrome 91 以上版本Promise 僅支援 Manifest V3 以上版本,其他平台就必須使用回呼。
getDescriptor()
chrome.bluetoothLowEnergy.getDescriptor(
descriptorId: string,
callback?: function,
)
取得具有指定執行個體 ID 的 GATT 字元描述元。
參數
-
descriptorId
字串
所要求 GATT 字元描述元的執行個體 ID。
-
回呼
函式選用
callback
參數如下所示:(result: Descriptor) => void
-
結果
-
傳回
-
Promise<Descriptor>
Chrome 91 以上版本Promise 僅支援 Manifest V3 以上版本,其他平台就必須使用回呼。
getDescriptors()
chrome.bluetoothLowEnergy.getDescriptors(
characteristicId: string,
callback?: function,
)
取得屬於指定特性的 GATT 特性描述元清單。
參數
-
characteristicId
字串
應傳回描述元的 GATT 字元的執行個體 ID。
-
回呼
函式選用
callback
參數如下所示:(result: Descriptor[]) => void
-
結果
描述元[]
-
傳回
-
Promise<Descriptor[]>
Chrome 91 以上版本Promise 僅支援 Manifest V3 以上版本,其他平台就必須使用回呼。
getIncludedServices()
chrome.bluetoothLowEnergy.getIncludedServices(
serviceId: string,
callback?: function,
)
取得所包含的 GATT 服務清單。
傳回
-
Promise<服務[]>
Chrome 91 以上版本Promise 僅支援 Manifest V3 以上版本,其他平台就必須使用回呼。
getService()
chrome.bluetoothLowEnergy.getService(
serviceId: string,
callback?: function,
)
取得具有指定執行個體 ID 的 GATT 服務。
傳回
-
Promise<服務>
Chrome 91 以上版本Promise 僅支援 Manifest V3 以上版本,其他平台就必須使用回呼。
getServices()
chrome.bluetoothLowEnergy.getServices(
deviceAddress: string,
callback?: function,
)
透過指定裝置位址取得在遠端裝置上發現的所有 GATT 服務。
注意:如果裝置尚未完成服務探索,這個 API 會傳回部分服務 (可能沒有內容)。替代方案是新增根據時間設定的延遲時間和/或重複呼叫,直到服務傳回預期的服務數量為止。
參數
傳回
-
Promise<服務[]>
Chrome 91 以上版本Promise 僅支援 Manifest V3 以上版本,其他平台就必須使用回呼。
notifyCharacteristicValueChanged()
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()
chrome.bluetoothLowEnergy.readCharacteristicValue(
characteristicId: string,
callback?: function,
)
從遠端週邊裝置擷取指定特性的值。
參數
-
characteristicId
字串
GATT 特性的執行個體 ID,其值應從遠端裝置讀取。
-
回呼
函式選用
callback
參數如下所示:(result: Characteristic) => void
-
結果
-
傳回
-
Promise<Characteristic>
Chrome 91 以上版本Promise 僅支援 Manifest V3 以上版本,其他平台就必須使用回呼。
readDescriptorValue()
chrome.bluetoothLowEnergy.readDescriptorValue(
descriptorId: string,
callback?: function,
)
從遠端週邊裝置擷取指定特性描述元的值。
參數
-
descriptorId
字串
GATT 字元描述元的執行個體 ID,其值必須從遠端裝置讀取。
-
回呼
函式選用
callback
參數如下所示:(result: Descriptor) => void
-
結果
-
傳回
-
Promise<Descriptor>
Chrome 91 以上版本Promise 僅支援 Manifest V3 以上版本,其他平台就必須使用回呼。
registerAdvertisement()
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()
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()
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()
chrome.bluetoothLowEnergy.resetAdvertising(
callback?: function,
)
重設目前裝置上的廣告。它會取消註冊並停止所有現有的廣告。
參數
-
回呼
函式選用
callback
參數如下所示:() => void
傳回
-
Promise<void>
Chrome 91 以上版本Promise 僅支援 Manifest V3 以上版本,其他平台就必須使用回呼。
sendRequestResponse()
chrome.bluetoothLowEnergy.sendRequestResponse(
response: Response,
)
針對特徵或描述元讀取/寫入要求傳送回應。只有在應用程式同時將「Bluetooth:low_energy」和「藍牙:週邊裝置」權限設為 true 時,才能使用此功能。某些週邊裝置權限可能不適用於所有應用程式。
參數
-
則回應
要求的回應。
setAdvertisingInterval()
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()
chrome.bluetoothLowEnergy.startCharacteristicNotifications(
characteristicId: string,
properties?: NotificationProperties,
callback?: function,
)
啟用指定特性的值通知/指示。啟用後,應用程式即可透過 onCharacteristicValueChanged
事件監聽通知。
參數
-
characteristicId
字串
應啟用通知的 GATT 特性執行個體 ID。
-
資源
通知工作階段屬性 (選用)。
-
回呼
函式選用
callback
參數如下所示:() => void
傳回
-
Promise<void>
Chrome 91 以上版本Promise 僅支援 Manifest V3 以上版本,其他平台就必須使用回呼。
stopCharacteristicNotifications()
chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
characteristicId: string,
callback?: function,
)
停用指定特性的值通知/指示。成功呼叫後,應用程式就不會再收到這個特性的通知/指示。
參數
-
characteristicId
字串
這個應用程式的通知工作階段應停止的 GATT 功能執行個體 ID。
-
回呼
函式選用
callback
參數如下所示:() => void
傳回
-
Promise<void>
Chrome 91 以上版本Promise 僅支援 Manifest V3 以上版本,其他平台就必須使用回呼。
unregisterAdvertisement()
chrome.bluetoothLowEnergy.unregisterAdvertisement(
advertisementId: number,
callback?: function,
)
取消註冊廣告並停止放送廣告。如果廣告無法取消註冊,那麼就只能重新啟動裝置。
參數
-
advertisementId
號碼
要取消註冊的廣告 ID。
-
回呼
函式選用
callback
參數如下所示:() => void
傳回
-
Promise<void>
Chrome 91 以上版本Promise 僅支援 Manifest V3 以上版本,其他平台就必須使用回呼。
unregisterService()
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()
chrome.bluetoothLowEnergy.writeCharacteristicValue(
characteristicId: string,
value: ArrayBuffer,
callback?: function,
)
從遠端週邊裝置寫入指定特徵的值。
參數
-
characteristicId
字串
應寫入 GATT 特性的執行個體 ID。
-
值
ArrayBuffer
應在寫入要求中傳送至遠端特性的值。
-
回呼
函式選用
callback
參數如下所示:() => void
傳回
-
Promise<void>
Chrome 91 以上版本Promise 僅支援 Manifest V3 以上版本,其他平台就必須使用回呼。
writeDescriptorValue()
chrome.bluetoothLowEnergy.writeDescriptorValue(
descriptorId: string,
value: ArrayBuffer,
callback?: function,
)
從遠端週邊裝置寫入指定特性描述元的值。
參數
-
descriptorId
字串
應寫入 GATT 字元描述元的執行個體 ID。
-
值
ArrayBuffer
應該在寫入要求中傳送至遠端描述元的值。
-
回呼
函式選用
callback
參數如下所示:() => void
傳回
-
Promise<void>
Chrome 91 以上版本Promise 僅支援 Manifest V3 以上版本,其他平台就必須使用回呼。
活動
onCharacteristicReadRequest
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.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
callback: function,
)
當連線的中央裝置要求寫入本機 GATT 伺服器上註冊的特徵值時,就會觸發如果您長時間沒有回應此要求,可能會導致連線中斷。只有在應用程式同時將「藍牙」和「藍牙」權限設為「true」時,系統才會提供此事件。某些週邊裝置權限可能不適用於所有應用程式。
參數
-
回呼
功能
callback
參數如下所示:(request: Request, characteristicId: string) => void
-
申請。
-
characteristicId
字串
-
onDescriptorReadRequest
chrome.bluetoothLowEnergy.onDescriptorReadRequest.addListener(
callback: function,
)
當已連結的中央裝置要求讀取本機 GATT 伺服器上註冊的描述元的值時,就會觸發如果您長時間沒有回應此要求,可能會導致連線中斷。只有在應用程式同時將「藍牙」和「藍牙」權限設為「true」時,系統才會提供此事件。某些週邊裝置權限可能不適用於所有應用程式。
onDescriptorValueChanged
chrome.bluetoothLowEnergy.onDescriptorValueChanged.addListener(
callback: function,
)
當遠端 GATT 字元描述元的值變更時 (通常是讀取要求的結果),就會觸發這個事件。為方便起見,此事件主要是存在,且一律會在成功呼叫 readDescriptorValue
後傳送。
參數
-
回呼
功能
callback
參數如下所示:(descriptor: Descriptor) => void
-
描述元
-
onDescriptorWriteRequest
chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
callback: function,
)
當已連結的中央裝置要求寫入本機 GATT 伺服器上註冊的描述元的值時,就會觸發如果您長時間沒有回應此要求,可能會導致連線中斷。只有在應用程式同時將「藍牙」和「藍牙」權限設為「true」時,系統才會提供此事件。某些週邊裝置權限可能不適用於所有應用程式。
onServiceAdded
chrome.bluetoothLowEnergy.onServiceAdded.addListener(
callback: function,
)
已在遠端裝置上發現一項新的 GATT 服務,火焰了。
onServiceChanged
chrome.bluetoothLowEnergy.onServiceChanged.addListener(
callback: function,
)
遠端 GATT 服務的狀態變更時觸發。這包括任何從服務中新增或移除的特性和/或描述元,以及來自遠端裝置的「ServiceChanged」通知。
onServiceRemoved
chrome.bluetoothLowEnergy.onServiceRemoved.addListener(
callback: function,
)
先前在遠端裝置上發現的 GATT 服務遭到移除時觸發。