คำอธิบาย
chrome.bluetoothLowEnergy
API ใช้เพื่อสื่อสารกับอุปกรณ์ Bluetooth Smart (พลังงานต่ำ) โดยใช้โปรไฟล์แอตทริบิวต์ทั่วไป (GATT)
ไฟล์ Manifest
ประเภท
Advertisement
พร็อพเพอร์ตี้
-
manufacturerData
ManufacturerData[] ไม่บังคับ
รายการข้อมูลเฉพาะของผู้ผลิตที่จะรวมอยู่ใน "ข้อมูลเฉพาะของผู้ผลิต" ของข้อมูลการโฆษณา
-
serviceData
ServiceData[] ไม่บังคับ
รายการข้อมูลบริการที่จะรวมอยู่ใน "ข้อมูลบริการ" ของข้อมูลการโฆษณา
-
serviceUuids
string[] ไม่บังคับ
รายการ UUID ที่จะรวมอยู่ใน "UUID ของบริการ" ของข้อมูลการโฆษณา UUID เหล่านี้จะอยู่ในรูปแบบ 16 บิต, 32 บิต หรือ 128 ก็ได้
-
solicitUuids
string[] ไม่บังคับ
รายการ UUID ที่จะรวมใน "UUID ที่ขอ" ของข้อมูลการโฆษณา UUID เหล่านี้จะอยู่ในรูปแบบ 16 บิต, 32 บิต หรือ 128 ก็ได้
-
ประเภท
ประเภทของโฆษณา
AdvertisementType
ประเภทของโฆษณา หาก "ประกาศ" ที่เลือกไว้ ประเภทโฆษณาที่ส่งจะเป็น ADV_NONCONN_IND และอุปกรณ์จะเผยแพร่ด้วยที่อยู่ MAC แบบสุ่ม หากตั้งค่าเป็น "อุปกรณ์ต่อพ่วง" ประเภทโฆษณาจะเป็น ADV_IND หรือ ADV_SCAN_IND และอุปกรณ์จะเผยแพร่ด้วยที่อยู่ MAC ของอะแดปเตอร์บลูทูธจริง
ค่าแจกแจง
"ประกาศ"
"อุปกรณ์ต่อพ่วง"
Characteristic
พร็อพเพอร์ตี้
-
instanceId
string ไม่บังคับ
แสดงผลตัวระบุที่กำหนดให้กับลักษณะเฉพาะนี้ ใช้รหัสอินสแตนซ์เพื่อแยกความแตกต่างระหว่างลักษณะต่างๆ จากอุปกรณ์ต่อพ่วงที่มี UUID เดียวกัน และเพื่อเรียกใช้ฟังก์ชันที่ใช้ตัวระบุลักษณะ แสดง หากอินสแตนซ์นี้แสดงลักษณะระยะไกล
-
พร็อพเพอร์ตี้
คุณสมบัติของลักษณะนี้
-
บริการ
บริการ ไม่บังคับ
บริการ GATT ลักษณะนี้
-
Uuid
สตริง
UUID ของลักษณะเฉพาะ เช่น 00002a37-0000-1000-8000-00805f9b34fb.
-
value
ArrayBuffer ไม่บังคับ
ค่าลักษณะเฉพาะที่แคชไว้ในปัจจุบัน ค่านี้จะได้รับการอัปเดตเมื่อมีการอ่านหรืออัปเดตค่าของลักษณะผ่านการแจ้งเตือนหรือตัวบ่งชี้
CharacteristicProperty
ค่าที่แสดงถึงคุณสมบัติที่เป็นไปได้ของลักษณะเฉพาะ สิทธิ์ลักษณะเฉพาะจะอนุมานจากพร็อพเพอร์ตี้เหล่านี้ โปรดดูข้อมูลจำเพาะของบลูทูธ 4.x เพื่อดูความหมายของแต่ละพร็อพเพอร์ตี้
ค่าแจกแจง
"ประกาศ"
"อ่าน"
"writeWithoutResponse"
"เขียน"
"แจ้ง"
"ระบุ"
"AUTHdSignedWrites"
"extendedProperties"
"reliableWrite"
"writableAuxiliaries"
"encryptRead"
"encryptWrite"
"encryptAuthenticatedRead"
"encryptAuthenticatedWrite"
ConnectProperties
พร็อพเพอร์ตี้
-
ต่อเนื่อง
boolean
การแจ้งที่ระบุว่ามีการเปิดการเชื่อมต่อกับอุปกรณ์ค้างไว้หรือไม่เมื่อหน้าเหตุการณ์ของแอปพลิเคชันยกเลิกการโหลด (โปรดดูจัดการวงจรของแอป) ค่าเริ่มต้นคือ
false.
Descriptor
พร็อพเพอร์ตี้
-
ลักษณะเฉพาะ
ลักษณะเฉพาะ ไม่บังคับ
ลักษณะของ GATT ที่เป็นของข้อบ่งชี้นี้
-
instanceId
string ไม่บังคับ
แสดงผลตัวระบุที่กำหนดให้กับข้อบ่งชี้นี้ ใช้รหัสอินสแตนซ์เพื่อแยกความแตกต่างระหว่างข้อบ่งชี้จากอุปกรณ์ต่อพ่วงที่มี UUID เดียวกัน และเพื่อเรียกใช้ฟังก์ชันที่ใช้ตัวระบุข้อบ่งชี้ แสดง หากอินสแตนซ์นี้แสดงลักษณะระยะไกล
-
สิทธิ์Chrome 52 ขึ้นไป
สิทธิ์ของคำอธิบายนี้
-
Uuid
สตริง
UUID ของข้อบ่งชี้ลักษณะเฉพาะ เช่น 00002902-0000-1000-8000-00805f9b34fb.
-
value
ArrayBuffer ไม่บังคับ
ค่าข้อบ่งชี้ที่แคชไว้ในปัจจุบัน ระบบจะอัปเดตค่านี้เมื่อมีการอ่านค่าของข้อบ่งชี้
DescriptorPermission
ค่าที่แสดงถึงสิทธิ์ที่เป็นไปได้สำหรับข้อบ่งชี้ โปรดดูข้อกำหนดของบลูทูธ 4.x เพื่อดูความหมายของสิทธิ์แต่ละคำ
ค่าแจกแจง
"อ่าน"
"เขียน"
"encryptedRead"
"encryptedWrite"
"encryptedAuthenticatedRead"
"encryptedAuthenticatedWrite"
Device
พร็อพเพอร์ตี้
-
ที่อยู่
สตริง
ที่อยู่ของอุปกรณ์ในรูปแบบ "XX:XX:XX:XX:XX:XX"
-
deviceClass
หมายเลข ไม่บังคับ
คลาสของอุปกรณ์ ฟิลด์บิตที่กำหนดโดย http://www.bluetooth.org/th-th/specification/assigned-numbers/base Band
-
ชื่อ
string ไม่บังคับ
ชื่ออุปกรณ์ที่มนุษย์อ่านได้
ManufacturerData
พร็อพเพอร์ตี้
-
ข้อมูล
ตัวเลข[]
-
id
ตัวเลข
Notification
พร็อพเพอร์ตี้
-
shouldIndicate
บูลีน ไม่บังคับ
ธงที่ไม่บังคับสำหรับส่งการระบุแทนการแจ้งเตือน
-
value
อาร์เรย์บัฟเฟอร์
ค่าใหม่ของลักษณะเฉพาะ
NotificationProperties
พร็อพเพอร์ตี้
-
ต่อเนื่อง
boolean
การแจ้งที่ระบุว่าแอปควรได้รับการแจ้งเตือนเมื่อหน้าเหตุการณ์ของแอปพลิเคชันยกเลิกการโหลดหรือไม่ (โปรดดูจัดการวงจรของแอป) ค่าเริ่มต้นคือ
false
Request
พร็อพเพอร์ตี้
-
อุปกรณ์
อุปกรณ์ที่ส่งคำขอนี้
-
requestId
ตัวเลข
รหัสที่ไม่ซ้ำกันสำหรับคำขอนี้ ใช้รหัสนี้เมื่อตอบคำขอนี้
-
value
ArrayBuffer ไม่บังคับ
ค่าที่จะเขียน (หากเป็นคำขอการเขียน)
Response
พร็อพเพอร์ตี้
-
isError
boolean
หากนี่เป็นการตอบกลับที่มีข้อผิดพลาด ก็ต้องเป็นจริง
-
requestId
ตัวเลข
รหัสของคำขอ นี่คือการตอบกลับ
-
value
ArrayBuffer ไม่บังคับ
ค่าของคำตอบ คำขอการเขียนและการตอบกลับข้อผิดพลาดจะไม่สนใจพารามิเตอร์นี้
Service
พร็อพเพอร์ตี้
-
deviceAddress
string ไม่บังคับ
ที่อยู่อุปกรณ์ของอุปกรณ์ต่อพ่วงรีโมตที่มีบริการ GATT แสดง หากอินสแตนซ์นี้แสดงถึงบริการระยะไกล
-
instanceId
string ไม่บังคับ
แสดงผลตัวระบุที่กำหนดให้กับบริการนี้ ใช้รหัสอินสแตนซ์เพื่อแยกแยะระหว่างบริการจากอุปกรณ์ต่อพ่วงที่มี UUID เดียวกัน และเพื่อเรียกใช้ฟังก์ชันที่ใช้ตัวระบุบริการ แสดง หากอินสแตนซ์นี้แสดงถึงบริการระยะไกล
-
คือหลัก
boolean
ระบุว่าบริการนี้เป็นประเภทหลักหรือรอง
-
Uuid
สตริง
UUID ของบริการ เช่น 0000180d-0000-1000-8000-00805f9b34fb.
ServiceData
พร็อพเพอร์ตี้
-
ข้อมูล
ตัวเลข[]
-
Uuid
สตริง
เมธอด
connect()
chrome.bluetoothLowEnergy.connect(
deviceAddress: string,
properties?: ConnectProperties,
callback?: function,
)
สร้างการเชื่อมต่อระหว่างแอปพลิเคชันและอุปกรณ์ด้วยที่อยู่ที่ระบุ อุปกรณ์อาจเชื่อมต่ออยู่แล้วและบริการ GATT พร้อมใช้งานโดยไม่ต้องเรียก connect
อย่างไรก็ตาม แอปที่ต้องการเข้าถึงบริการ GATT ของอุปกรณ์ควรเรียกใช้ฟังก์ชันนี้เพื่อให้แน่ใจว่าการเชื่อมต่อกับอุปกรณ์ได้รับการรักษาไว้ หากอุปกรณ์ไม่ได้เชื่อมต่ออยู่ ระบบจะพบบริการ GATT ทั้งหมดของอุปกรณ์หลังจากที่โทรหา connect
สำเร็จแล้ว
พารามิเตอร์
-
deviceAddress
สตริง
ที่อยู่บลูทูธของอุปกรณ์ระยะไกลที่ควรเปิดการเชื่อมต่อ GATT
-
พร็อพเพอร์ตี้
ConnectProperties ไม่บังคับ
พร็อพเพอร์ตี้การเชื่อมต่อ (ไม่บังคับ)
-
Callback
ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้() => void
การคืนสินค้า
-
คำมั่นสัญญา<โมฆะ>
Chrome 91 ขึ้นไปPromise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback
createCharacteristic()
chrome.bluetoothLowEnergy.createCharacteristic(
characteristic: Characteristic,
serviceId: string,
callback?: function,
)
สร้างลักษณะเฉพาะของ GATT ที่โฮสต์ในเครื่อง ลักษณะเฉพาะนี้ต้องโฮสต์ภายใต้บริการที่ถูกต้อง หากรหัสบริการไม่ถูกต้อง ระบบจะตั้งค่า lastError ฟังก์ชันนี้จะใช้ได้ต่อเมื่อแอปตั้งค่าสิทธิ์ของ Bluetooth:low_energy และ Bluetooth:peripheral เป็น "จริง" เท่านั้น สิทธิ์เข้าถึงอุปกรณ์ต่อพ่วงอาจไม่พร้อมใช้งานกับบางแอป
พารามิเตอร์
-
ลักษณะเฉพาะ
ลักษณะเฉพาะในการสร้าง
-
รหัสบริการ
สตริง
รหัสของบริการที่จะสร้างลักษณะเฉพาะนี้
-
Callback
ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้(characteristicId: string) => void
-
characteristicId
สตริง
-
การคืนสินค้า
-
คำมั่นสัญญา<สตริง>
Chrome 91 ขึ้นไปPromise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback
createDescriptor()
chrome.bluetoothLowEnergy.createDescriptor(
descriptor: Descriptor,
characteristicId: string,
callback?: function,
)
สร้างข้อบ่งชี้ GATT ที่โฮสต์ไว้ในเครื่อง ข้อบ่งชี้นี้ต้องโฮสต์ไว้ภายใต้ลักษณะเฉพาะที่ถูกต้อง หากรหัสลักษณะเฉพาะไม่ถูกต้อง ระบบจะตั้งค่า lastError ฟังก์ชันนี้จะใช้ได้ต่อเมื่อแอปตั้งค่าทั้ง Bluetooth:low_energy และสิทธิ์เข้าถึง Bluetooth:peripheral เป็น "จริง" สิทธิ์เข้าถึงอุปกรณ์ต่อพ่วงอาจไม่พร้อมใช้งานกับบางแอป
พารามิเตอร์
-
ข้อบ่งชี้
ข้อบ่งชี้ในการสร้าง
-
characteristicId
สตริง
รหัสของลักษณะเฉพาะที่จะใช้สร้างตัวบ่งชี้นี้
-
Callback
ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้(descriptorId: string) => void
-
descriptorId
สตริง
-
การคืนสินค้า
-
คำมั่นสัญญา<สตริง>
Chrome 91 ขึ้นไปPromise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback
createService()
chrome.bluetoothLowEnergy.createService(
service: Service,
callback?: function,
)
สร้างบริการ GATT ที่โฮสต์ในเครื่อง สามารถลงทะเบียนบริการนี้ให้พร้อมใช้งานในเซิร์ฟเวอร์ GATT ในเครื่อง ฟังก์ชันนี้จะใช้ได้ต่อเมื่อแอปตั้งค่าทั้ง Bluetooth:low_energy และสิทธิ์เข้าถึง Bluetooth:peripheral เป็น "จริง" สิทธิ์เข้าถึงอุปกรณ์ต่อพ่วงอาจไม่พร้อมใช้งานกับบางแอป
พารามิเตอร์
-
บริการ
บริการที่จะสร้าง
-
Callback
ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้(serviceId: string) => void
-
รหัสบริการ
สตริง
-
การคืนสินค้า
-
คำมั่นสัญญา<สตริง>
Chrome 91 ขึ้นไปPromise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback
disconnect()
chrome.bluetoothLowEnergy.disconnect(
deviceAddress: string,
callback?: function,
)
ปิดการเชื่อมต่อของแอปกับอุปกรณ์ด้วยที่อยู่ที่ระบุ โปรดทราบว่าการดำเนินการนี้ไม่ได้ทำลายตัวลิงก์จริงเสมอไป เนื่องจากอาจมีแอปอื่นๆ ที่มีการเชื่อมต่อแบบเปิด
พารามิเตอร์
-
deviceAddress
สตริง
ที่อยู่บลูทูธของอุปกรณ์ระยะไกล
-
Callback
ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้() => void
การคืนสินค้า
-
คำมั่นสัญญา<โมฆะ>
Chrome 91 ขึ้นไปPromise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback
getCharacteristic()
chrome.bluetoothLowEnergy.getCharacteristic(
characteristicId: string,
callback?: function,
)
รับลักษณะ GATT ด้วยรหัสอินสแตนซ์ที่ระบุซึ่งเป็นของบริการ GATT ที่ระบุ หากมีลักษณะเฉพาะนั้นอยู่
พารามิเตอร์
-
characteristicId
สตริง
รหัสอินสแตนซ์ของลักษณะ GATT ที่ขอ
-
Callback
ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้(result: Characteristic) => void
-
ผลลัพธ์
-
การคืนสินค้า
-
คำสัญญา<ลักษณะเฉพาะ>
Chrome 91 ขึ้นไปPromise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback
getCharacteristics()
chrome.bluetoothLowEnergy.getCharacteristics(
serviceId: string,
callback?: function,
)
รับรายการลักษณะ GATT ทั้งหมดที่ค้นพบซึ่งเป็นของบริการที่ระบุ
พารามิเตอร์
-
รหัสบริการ
สตริง
รหัสอินสแตนซ์ของบริการ GATT ที่ควรแสดงลักษณะเฉพาะ
-
Callback
ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้(result: Characteristic[]) => void
-
ผลลัพธ์
-
การคืนสินค้า
-
คำสัญญา<ลักษณะเฉพาะ[]>
Chrome 91 ขึ้นไปPromise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback
getDescriptor()
chrome.bluetoothLowEnergy.getDescriptor(
descriptorId: string,
callback?: function,
)
รับข้อบ่งชี้ลักษณะเฉพาะของ GATT พร้อมรหัสอินสแตนซ์ที่กำหนด
พารามิเตอร์
-
descriptorId
สตริง
รหัสอินสแตนซ์ของข้อบ่งชี้ลักษณะเฉพาะ GATT ที่ขอ
-
Callback
ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้(result: Descriptor) => void
-
ผลลัพธ์
-
การคืนสินค้า
-
Promise<Descriptor>
Chrome 91 ขึ้นไปPromise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback
getDescriptors()
chrome.bluetoothLowEnergy.getDescriptors(
characteristicId: string,
callback?: function,
)
รับรายการข้อบ่งชี้ลักษณะเฉพาะของ GATT ที่เป็นของลักษณะเฉพาะที่ระบุ
พารามิเตอร์
-
characteristicId
สตริง
รหัสอินสแตนซ์ของลักษณะ GATT ที่ควรแสดงผลข้อบ่งชี้
-
Callback
ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้(result: Descriptor[]) => void
-
ผลลัพธ์
-
การคืนสินค้า
-
Promise<Descriptor[]>
Chrome 91 ขึ้นไปPromise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback
getIncludedServices()
chrome.bluetoothLowEnergy.getIncludedServices(
serviceId: string,
callback?: function,
)
รับรายการบริการ GATT ที่บริการดังกล่าวรวมอยู่
พารามิเตอร์
การคืนสินค้า
-
สัญญา<บริการ[]>
Chrome 91 ขึ้นไปPromise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback
getService()
chrome.bluetoothLowEnergy.getService(
serviceId: string,
callback?: function,
)
รับบริการ GATT ด้วยรหัสอินสแตนซ์ที่ระบุ
พารามิเตอร์
-
รหัสบริการ
สตริง
รหัสอินสแตนซ์ของบริการ GATT ที่ขอ
-
Callback
ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้(result: Service) => void
-
ผลลัพธ์
-
การคืนสินค้า
-
Promise<Service>
Chrome 91 ขึ้นไปPromise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback
getServices()
chrome.bluetoothLowEnergy.getServices(
deviceAddress: string,
callback?: function,
)
รับบริการ GATT ทั้งหมดที่พบในอุปกรณ์ระยะไกลโดยใช้ที่อยู่อุปกรณ์ที่ระบุ
หมายเหตุ: หากการค้นหาบริการในอุปกรณ์ยังไม่เสร็จสมบูรณ์ API นี้จะส่งคืนบริการบางส่วน (อาจว่างเปล่า) วิธีแก้ปัญหาคือการเพิ่มการหน่วงเวลาและ/หรือการโทรซ้ำๆ จนกว่าจะส่งคืนบริการตามจำนวนที่คาดไว้
พารามิเตอร์
การคืนสินค้า
-
สัญญา<บริการ[]>
Chrome 91 ขึ้นไปPromise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback
notifyCharacteristicValueChanged()
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
characteristicId: string,
notification: Notification,
callback?: function,
)
แจ้งเตือนอุปกรณ์ระยะไกลเกี่ยวกับค่าใหม่สำหรับลักษณะหนึ่งๆ หาก "ควรระบุธง" ในออบเจ็กต์การแจ้งเตือนเป็น "จริง" ระบบจะส่งสัญญาณบอกสถานะแทนการแจ้งเตือน โปรดทราบว่าลักษณะเฉพาะจำเป็นต้องตั้งค่า "แจ้ง" ให้ถูกต้อง หรือ "ระบุ" ในระหว่างการสร้างเพื่อให้การเรียกนี้สำเร็จ ฟังก์ชันนี้จะใช้ได้ต่อเมื่อแอปตั้งค่าสิทธิ์ของ Bluetooth:low_energy และ Bluetooth:peripheral เป็น "จริง" เท่านั้น สิทธิ์เข้าถึงอุปกรณ์ต่อพ่วงอาจไม่พร้อมใช้งานกับบางแอป
พารามิเตอร์
-
characteristicId
สตริง
ลักษณะเฉพาะสำหรับส่งการแจ้งเตือน
-
การแจ้งเตือน
-
Callback
ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้() => void
การคืนสินค้า
-
คำมั่นสัญญา<โมฆะ>
Chrome 91 ขึ้นไปPromise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback
readCharacteristicValue()
chrome.bluetoothLowEnergy.readCharacteristicValue(
characteristicId: string,
callback?: function,
)
ดึงข้อมูลค่าของลักษณะเฉพาะที่ระบุจากอุปกรณ์ต่อพ่วงระยะไกล
พารามิเตอร์
-
characteristicId
สตริง
รหัสอินสแตนซ์ของลักษณะ GATT ที่ควรอ่านค่าจากอุปกรณ์ระยะไกล
-
Callback
ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้(result: Characteristic) => void
-
ผลลัพธ์
-
การคืนสินค้า
-
คำสัญญา<ลักษณะเฉพาะ>
Chrome 91 ขึ้นไปPromise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback
readDescriptorValue()
chrome.bluetoothLowEnergy.readDescriptorValue(
descriptorId: string,
callback?: function,
)
ดึงข้อมูลค่าของข้อบ่งชี้ลักษณะเฉพาะที่ระบุจากอุปกรณ์ต่อพ่วงระยะไกล
พารามิเตอร์
-
descriptorId
สตริง
รหัสอินสแตนซ์ของข้อบ่งชี้ลักษณะเฉพาะ GATT ที่ควรอ่านค่าจากอุปกรณ์ระยะไกล
-
Callback
ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้(result: Descriptor) => void
-
ผลลัพธ์
-
การคืนสินค้า
-
Promise<Descriptor>
Chrome 91 ขึ้นไปPromise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback
registerAdvertisement()
chrome.bluetoothLowEnergy.registerAdvertisement(
advertisement: Advertisement,
callback?: function,
)
สร้างโฆษณาและลงทะเบียนเพื่อแสดงโฆษณา หากต้องการเรียกฟังก์ชันนี้ แอปต้องตั้งค่าสิทธิ์ของ Bluetooth:low_energy และ Bluetooth:peripheral เป็น "จริง" นอกจากนี้ API นี้จะใช้ได้กับแอปที่เปิดใช้อัตโนมัติในโหมดคีออสก์ หรือโดยการตั้งค่า "--enable-ble-advertising-in-apps" เปลี่ยนบรรทัดคำสั่ง ดู https://developer.chrome.com/apps/manifest/bluetooth หมายเหตุ: ฮาร์ดแวร์บางรุ่นรองรับโหมดส่วนกลางและอุปกรณ์ต่อพ่วงในเวลาเดียวกันแต่ในฮาร์ดแวร์ที่ไม่รองรับการดำเนินการนี้ การเรียกใช้ครั้งนี้จะเปลี่ยนอุปกรณ์เป็นโหมดอุปกรณ์ต่อพ่วง ในกรณีของฮาร์ดแวร์ที่ไม่รองรับทั้งโหมดส่วนกลางและโหมดอุปกรณ์ต่อพ่วง การพยายามใช้อุปกรณ์ในทั้ง 2 โหมดจะนำไปสู่การทำงานที่ไม่ระบุ หรือป้องกันไม่ให้แอปพลิเคชันบทบาทส่วนกลางอื่นๆ ทำงานผิดปกติ (รวมถึงการค้นหาอุปกรณ์บลูทูธพลังงานต่ำ)
พารามิเตอร์
-
โฆษณา
โฆษณาที่จะโฆษณา
-
Callback
ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้(advertisementId: number) => void
-
advertisementId
ตัวเลข
-
การคืนสินค้า
-
Promise<number>
Chrome 91 ขึ้นไปPromise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback
registerService()
chrome.bluetoothLowEnergy.registerService(
serviceId: string,
callback?: function,
)
ลงทะเบียนบริการที่ระบุกับเซิร์ฟเวอร์ GATT ในเครื่อง หากรหัสบริการไม่ถูกต้อง ระบบจะตั้งค่า lastError ฟังก์ชันนี้จะใช้ได้ต่อเมื่อแอปตั้งค่าทั้ง Bluetooth:low_energy และสิทธิ์เข้าถึง Bluetooth:peripheral เป็น "จริง" สิทธิ์เข้าถึงอุปกรณ์ต่อพ่วงอาจไม่พร้อมใช้งานกับบางแอป
พารามิเตอร์
-
รหัสบริการ
สตริง
รหัสที่ไม่ซ้ำกันของบริการที่สร้าง
-
Callback
ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้() => void
การคืนสินค้า
-
คำมั่นสัญญา<โมฆะ>
Chrome 91 ขึ้นไปPromise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback
removeService()
chrome.bluetoothLowEnergy.removeService(
serviceId: string,
callback?: function,
)
นำบริการที่ระบุออก ยกเลิกการลงทะเบียนบริการ ถ้าลงทะเบียนไว้ หากรหัสบริการไม่ถูกต้อง ระบบจะตั้งค่า lastError ฟังก์ชันนี้จะใช้ได้ต่อเมื่อแอปตั้งค่าทั้ง Bluetooth:low_energy และสิทธิ์เข้าถึง Bluetooth:peripheral เป็น "จริง" สิทธิ์เข้าถึงอุปกรณ์ต่อพ่วงอาจไม่พร้อมใช้งานกับบางแอป
พารามิเตอร์
-
รหัสบริการ
สตริง
รหัสที่ไม่ซ้ำกันของบริการที่ลงทะเบียนในปัจจุบัน
-
Callback
ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้() => void
การคืนสินค้า
-
คำมั่นสัญญา<โมฆะ>
Chrome 91 ขึ้นไปPromise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback
resetAdvertising()
chrome.bluetoothLowEnergy.resetAdvertising(
callback?: function,
)
รีเซ็ตการโฆษณาในอุปกรณ์ปัจจุบัน การดำเนินการนี้จะยกเลิกการลงทะเบียนและหยุดโฆษณาทั้งหมดที่มีอยู่
พารามิเตอร์
-
Callback
ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้() => void
การคืนสินค้า
-
คำมั่นสัญญา<โมฆะ>
Chrome 91 ขึ้นไปPromise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback
sendRequestResponse()
chrome.bluetoothLowEnergy.sendRequestResponse(
response: Response,
)
ส่งการตอบกลับคำขออ่าน/เขียนลักษณะเฉพาะหรือข้อบ่งชี้ ฟังก์ชันนี้จะใช้ได้ต่อเมื่อแอปตั้งค่าทั้ง Bluetooth:low_energy และสิทธิ์เข้าถึง Bluetooth:peripheral เป็น "จริง" สิทธิ์เข้าถึงอุปกรณ์ต่อพ่วงอาจไม่พร้อมใช้งานกับบางแอป
พารามิเตอร์
-
การตอบกลับ
การตอบกลับคำขอ
setAdvertisingInterval()
chrome.bluetoothLowEnergy.setAdvertisingInterval(
minInterval: number,
maxInterval: number,
callback?: function,
)
ค่าเป็นช่วงตั้งแต่โฆษณาสองโฆษณาติดต่อกัน หมายเหตุ: นี่คือความพยายามที่ดีที่สุด ช่วงจริงอาจแตกต่างไปโดยไม่เสียเวลากับช่วงเวลาที่ขอ ฮาร์ดแวร์บางรุ่นจะมีช่วงเวลาต่ำสุดที่ 100 มิลลิวินาที ค่าต่ำสุดและสูงสุดต้องไม่เกินช่วงที่อนุญาตตามข้อกำหนดของบลูทูธ 4.2
พารามิเตอร์
-
minInterval
ตัวเลข
ช่วงเวลาต่ำสุดระหว่างโฆษณาต่างๆ (หน่วยเป็นมิลลิวินาที) ค่านี้ต้องไม่เกิน 20 มิลลิวินาที (ตามข้อกำหนด)
-
maxInterval
ตัวเลข
ช่วงเวลาสูงสุดระหว่างโฆษณา (หน่วยเป็นมิลลิวินาที) ต้องไม่เกิน 10240 มิลลิวินาที (ตามข้อกำหนด)
-
Callback
ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้() => void
การคืนสินค้า
-
คำมั่นสัญญา<โมฆะ>
Chrome 91 ขึ้นไปPromise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback
startCharacteristicNotifications()
chrome.bluetoothLowEnergy.startCharacteristicNotifications(
characteristicId: string,
properties?: NotificationProperties,
callback?: function,
)
เปิดใช้การแจ้งเตือน/ตัวบ่งชี้ค่าจากลักษณะที่ระบุไว้ เมื่อเปิดใช้แล้ว แอปพลิเคชันจะฟังการแจ้งเตือนได้โดยใช้เหตุการณ์ onCharacteristicValueChanged
พารามิเตอร์
-
characteristicId
สตริง
รหัสอินสแตนซ์ของลักษณะ GATT ที่ควรเปิดใช้การแจ้งเตือน
-
พร็อพเพอร์ตี้
NotificationProperties ไม่บังคับ
พร็อพเพอร์ตี้เซสชันการแจ้งเตือน (ไม่บังคับ)
-
Callback
ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้() => void
การคืนสินค้า
-
คำมั่นสัญญา<โมฆะ>
Chrome 91 ขึ้นไปPromise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback
stopCharacteristicNotifications()
chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
characteristicId: string,
callback?: function,
)
ปิดใช้การแจ้งเตือน/ตัวบ่งชี้ค่าจากลักษณะที่ระบุไว้ หลังจากการโทรสำเร็จ แอปพลิเคชันจะหยุดได้รับการแจ้งเตือน/ตัวบ่งชี้จากลักษณะนี้
พารามิเตอร์
-
characteristicId
สตริง
รหัสอินสแตนซ์ของลักษณะ GATT ที่ควรหยุดเซสชันการแจ้งเตือนของแอปนี้
-
Callback
ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้() => void
การคืนสินค้า
-
คำมั่นสัญญา<โมฆะ>
Chrome 91 ขึ้นไปPromise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback
unregisterAdvertisement()
chrome.bluetoothLowEnergy.unregisterAdvertisement(
advertisementId: number,
callback?: function,
)
ยกเลิกการลงทะเบียนโฆษณาและหยุดการโฆษณา หากโฆษณายกเลิกการลงทะเบียนไม่ได้ วิธีเดียวที่จะหยุดโฆษณาได้คือการรีสตาร์ทอุปกรณ์
พารามิเตอร์
-
advertisementId
ตัวเลข
รหัสโฆษณาที่จะยกเลิกการลงทะเบียน
-
Callback
ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้() => void
การคืนสินค้า
-
คำมั่นสัญญา<โมฆะ>
Chrome 91 ขึ้นไปPromise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback
unregisterService()
chrome.bluetoothLowEnergy.unregisterService(
serviceId: string,
callback?: function,
)
ยกเลิกการลงทะเบียนบริการที่ระบุกับเซิร์ฟเวอร์ GATT ในเครื่อง หากรหัสบริการไม่ถูกต้อง ระบบจะตั้งค่า lastError ฟังก์ชันนี้จะใช้ได้ต่อเมื่อแอปตั้งค่าสิทธิ์ของ Bluetooth:low_energy และ Bluetooth:peripheral เป็น "จริง" เท่านั้น สิทธิ์เข้าถึงอุปกรณ์ต่อพ่วงอาจไม่พร้อมใช้งานกับบางแอป
พารามิเตอร์
-
รหัสบริการ
สตริง
รหัสที่ไม่ซ้ำกันของบริการที่ลงทะเบียนในปัจจุบัน
-
Callback
ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้() => void
การคืนสินค้า
-
คำมั่นสัญญา<โมฆะ>
Chrome 91 ขึ้นไปPromise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback
writeCharacteristicValue()
chrome.bluetoothLowEnergy.writeCharacteristicValue(
characteristicId: string,
value: ArrayBuffer,
callback?: function,
)
เขียนค่าของลักษณะเฉพาะที่ระบุจากอุปกรณ์ต่อพ่วงระยะไกล
พารามิเตอร์
-
characteristicId
สตริง
รหัสอินสแตนซ์ของลักษณะ GATT ที่ควรเขียนค่า
-
value
อาร์เรย์บัฟเฟอร์
ค่าที่ควรส่งไปยังลักษณะระยะไกลโดยเป็นส่วนหนึ่งของคำขอการเขียน
-
Callback
ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้() => void
การคืนสินค้า
-
คำมั่นสัญญา<โมฆะ>
Chrome 91 ขึ้นไปPromise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback
writeDescriptorValue()
chrome.bluetoothLowEnergy.writeDescriptorValue(
descriptorId: string,
value: ArrayBuffer,
callback?: function,
)
เขียนค่าของข้อบ่งชี้ลักษณะเฉพาะที่ระบุจากอุปกรณ์ต่อพ่วงระยะไกล
พารามิเตอร์
-
descriptorId
สตริง
รหัสอินสแตนซ์ของข้อบ่งชี้ลักษณะเฉพาะ GATT ที่ควรเขียนค่า
-
value
อาร์เรย์บัฟเฟอร์
ค่าที่ควรส่งไปยังตัวบ่งชี้ระยะไกลโดยเป็นส่วนหนึ่งของคำขอเขียน
-
Callback
ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้() => void
การคืนสินค้า
-
คำมั่นสัญญา<โมฆะ>
Chrome 91 ขึ้นไปPromise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback
กิจกรรม
onCharacteristicReadRequest
chrome.bluetoothLowEnergy.onCharacteristicReadRequest.addListener(
callback: function,
)
เริ่มทำงานเมื่ออุปกรณ์ส่วนกลางที่เชื่อมต่อขออ่านค่าของลักษณะที่ลงทะเบียนในเซิร์ฟเวอร์ GATT ในเครื่อง การไม่ตอบกลับคำขอนี้เป็นเวลานานอาจทำให้ผู้ใช้ขาดการเชื่อมต่อ เหตุการณ์นี้จะใช้ได้เฉพาะเมื่อแอปตั้งค่าทั้งสิทธิ์เข้าถึง Bluetooth:low_energy และ Bluetooth:peripheral เป็น "จริง" สิทธิ์เข้าถึงอุปกรณ์ต่อพ่วงอาจไม่พร้อมใช้งานกับบางแอป
พารามิเตอร์
-
Callback
ฟังก์ชัน
พารามิเตอร์
callback
มีลักษณะดังนี้(request: Request, characteristicId: string) => void
-
ส่งคำขอ
-
characteristicId
สตริง
-
onCharacteristicValueChanged
chrome.bluetoothLowEnergy.onCharacteristicValueChanged.addListener(
callback: function,
)
เริ่มทำงานเมื่อค่าของลักษณะ GATT ระยะไกลมีการเปลี่ยนแปลง ไม่ว่าจะเป็นผลลัพธ์ของคำขออ่าน หรือการแจ้งเตือน/การแจ้งการเปลี่ยนแปลงค่า ระบบจะส่งเหตุการณ์นี้เฉพาะเมื่อแอปเปิดการแจ้งเตือนโดยการเรียกใช้ startCharacteristicNotifications
พารามิเตอร์
-
Callback
ฟังก์ชัน
พารามิเตอร์
callback
มีลักษณะดังนี้(characteristic: Characteristic) => void
-
ลักษณะเฉพาะ
-
onCharacteristicWriteRequest
chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
callback: function,
)
เริ่มทำงานเมื่ออุปกรณ์ส่วนกลางที่เชื่อมต่อขอเขียนค่าของลักษณะที่ลงทะเบียนในเซิร์ฟเวอร์ GATT ในเครื่อง การไม่ตอบกลับคำขอนี้เป็นเวลานานอาจทำให้ผู้ใช้ขาดการเชื่อมต่อ เหตุการณ์นี้จะใช้ได้เฉพาะเมื่อแอปตั้งค่าทั้งสิทธิ์เข้าถึง Bluetooth:low_energy และ Bluetooth:peripheral เป็น "จริง" สิทธิ์เข้าถึงอุปกรณ์ต่อพ่วงอาจไม่พร้อมใช้งานกับบางแอป
พารามิเตอร์
-
Callback
ฟังก์ชัน
พารามิเตอร์
callback
มีลักษณะดังนี้(request: Request, characteristicId: string) => void
-
ส่งคำขอ
-
characteristicId
สตริง
-
onDescriptorReadRequest
chrome.bluetoothLowEnergy.onDescriptorReadRequest.addListener(
callback: function,
)
เริ่มทำงานเมื่ออุปกรณ์ส่วนกลางที่เชื่อมต่อขออ่านค่าของข้อบ่งชี้ที่ลงทะเบียนในเซิร์ฟเวอร์ GATT ในเครื่อง การไม่ตอบกลับคำขอนี้เป็นเวลานานอาจทำให้ผู้ใช้ขาดการเชื่อมต่อ เหตุการณ์นี้จะใช้ได้เฉพาะเมื่อแอปตั้งค่าทั้งสิทธิ์เข้าถึง Bluetooth:low_energy และ Bluetooth:peripheral เป็น "จริง" สิทธิ์เข้าถึงอุปกรณ์ต่อพ่วงอาจไม่พร้อมใช้งานกับบางแอป
พารามิเตอร์
-
Callback
ฟังก์ชัน
พารามิเตอร์
callback
มีลักษณะดังนี้(request: Request, descriptorId: string) => void
-
ส่งคำขอ
-
descriptorId
สตริง
-
onDescriptorValueChanged
chrome.bluetoothLowEnergy.onDescriptorValueChanged.addListener(
callback: function,
)
เริ่มทำงานเมื่อค่าของคำอธิบายลักษณะเฉพาะ GATT ระยะไกลเปลี่ยนแปลง ซึ่งมักเป็นผลมาจากคำขออ่าน กิจกรรมนี้มีไว้เพื่ออำนวยความสะดวกเป็นส่วนใหญ่และจะส่งหลังจากโทรหา readDescriptorValue
สำเร็จแล้วเสมอ
พารามิเตอร์
-
Callback
ฟังก์ชัน
พารามิเตอร์
callback
มีลักษณะดังนี้(descriptor: Descriptor) => void
-
ข้อบ่งชี้
-
onDescriptorWriteRequest
chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
callback: function,
)
เริ่มทำงานเมื่ออุปกรณ์ส่วนกลางที่เชื่อมต่อขอเขียนค่าของข้อบ่งชี้ที่ลงทะเบียนในเซิร์ฟเวอร์ GATT ในเครื่อง การไม่ตอบกลับคำขอนี้เป็นเวลานานอาจทำให้ผู้ใช้ขาดการเชื่อมต่อ เหตุการณ์นี้จะใช้ได้เฉพาะเมื่อแอปตั้งค่าทั้งสิทธิ์เข้าถึง Bluetooth:low_energy และ Bluetooth:peripheral เป็น "จริง" สิทธิ์เข้าถึงอุปกรณ์ต่อพ่วงอาจไม่พร้อมใช้งานกับบางแอป
พารามิเตอร์
-
Callback
ฟังก์ชัน
พารามิเตอร์
callback
มีลักษณะดังนี้(request: Request, descriptorId: string) => void
-
ส่งคำขอ
-
descriptorId
สตริง
-
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 ที่พบก่อนหน้านี้ออกจากอุปกรณ์ระยะไกลถูกนำออก