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