chrome.bluetoothLowEnergy

คำอธิบาย

chrome.bluetoothLowEnergy API ใช้เพื่อสื่อสารกับอุปกรณ์ Bluetooth Smart (พลังงานต่ำ) โดยใช้โปรไฟล์แอตทริบิวต์ทั่วไป (GATT)

ไฟล์ Manifest

คุณต้องประกาศคีย์ต่อไปนี้ในไฟล์ Manifest เพื่อใช้ API นี้

"bluetooth"

ประเภท

Advertisement

Chrome 47 ขึ้นไป

พร็อพเพอร์ตี้

  • manufacturerData

    ManufacturerData[] ไม่บังคับ

    รายการข้อมูลเฉพาะของผู้ผลิตที่จะรวมอยู่ใน "ข้อมูลเฉพาะของผู้ผลิต" ของข้อมูลการโฆษณา

  • serviceData

    ServiceData[] ไม่บังคับ

    รายการข้อมูลบริการที่จะรวมอยู่ใน "ข้อมูลบริการ" ของข้อมูลการโฆษณา

  • serviceUuids

    string[] ไม่บังคับ

    รายการ UUID ที่จะรวมอยู่ใน "UUID ของบริการ" ของข้อมูลการโฆษณา UUID เหล่านี้จะอยู่ในรูปแบบ 16 บิต, 32 บิต หรือ 128 ก็ได้

  • solicitUuids

    string[] ไม่บังคับ

    รายการ UUID ที่จะรวมใน "UUID ที่ขอ" ของข้อมูลการโฆษณา UUID เหล่านี้จะอยู่ในรูปแบบ 16 บิต, 32 บิต หรือ 128 ก็ได้

  • ประเภท

    ประเภทของโฆษณา

AdvertisementType

Chrome 47 ขึ้นไป

ประเภทของโฆษณา หาก "ประกาศ" ที่เลือกไว้ ประเภทโฆษณาที่ส่งจะเป็น 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

Chrome 52 ขึ้นไป

ค่าที่แสดงถึงสิทธิ์ที่เป็นไปได้สำหรับข้อบ่งชี้ โปรดดูข้อกำหนดของบลูทูธ 4.x เพื่อดูความหมายของสิทธิ์แต่ละคำ

ค่าแจกแจง

"อ่าน"

"เขียน"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome 52 ขึ้นไป

พร็อพเพอร์ตี้

  • ที่อยู่

    สตริง

    ที่อยู่ของอุปกรณ์ในรูปแบบ "XX:XX:XX:XX:XX:XX"

  • deviceClass

    หมายเลข ไม่บังคับ

    คลาสของอุปกรณ์ ฟิลด์บิตที่กำหนดโดย http://www.bluetooth.org/th-th/specification/assigned-numbers/base Band

  • ชื่อ

    string ไม่บังคับ

    ชื่ออุปกรณ์ที่มนุษย์อ่านได้

ManufacturerData

Chrome 47 ขึ้นไป

พร็อพเพอร์ตี้

  • ข้อมูล

    ตัวเลข[]

  • id

    ตัวเลข

Notification

Chrome 52 ขึ้นไป

พร็อพเพอร์ตี้

  • shouldIndicate

    บูลีน ไม่บังคับ

    ธงที่ไม่บังคับสำหรับส่งการระบุแทนการแจ้งเตือน

  • value

    อาร์เรย์บัฟเฟอร์

    ค่าใหม่ของลักษณะเฉพาะ

NotificationProperties

พร็อพเพอร์ตี้

  • ต่อเนื่อง

    boolean

    การแจ้งที่ระบุว่าแอปควรได้รับการแจ้งเตือนเมื่อหน้าเหตุการณ์ของแอปพลิเคชันยกเลิกการโหลดหรือไม่ (โปรดดูจัดการวงจรของแอป) ค่าเริ่มต้นคือ false

Request

Chrome 52 ขึ้นไป

พร็อพเพอร์ตี้

  • อุปกรณ์

    อุปกรณ์ที่ส่งคำขอนี้

  • requestId

    ตัวเลข

    รหัสที่ไม่ซ้ำกันสำหรับคำขอนี้ ใช้รหัสนี้เมื่อตอบคำขอนี้

  • value

    ArrayBuffer ไม่บังคับ

    ค่าที่จะเขียน (หากเป็นคำขอการเขียน)

Response

Chrome 52 ขึ้นไป

พร็อพเพอร์ตี้

  • isError

    boolean

    หากนี่เป็นการตอบกลับที่มีข้อผิดพลาด ก็ต้องเป็นจริง

  • requestId

    ตัวเลข

    รหัสของคำขอ นี่คือการตอบกลับ

  • value

    ArrayBuffer ไม่บังคับ

    ค่าของคำตอบ คำขอการเขียนและการตอบกลับข้อผิดพลาดจะไม่สนใจพารามิเตอร์นี้

Service

พร็อพเพอร์ตี้

  • deviceAddress

    string ไม่บังคับ

    ที่อยู่อุปกรณ์ของอุปกรณ์ต่อพ่วงรีโมตที่มีบริการ GATT แสดง หากอินสแตนซ์นี้แสดงถึงบริการระยะไกล

  • instanceId

    string ไม่บังคับ

    แสดงผลตัวระบุที่กำหนดให้กับบริการนี้ ใช้รหัสอินสแตนซ์เพื่อแยกแยะระหว่างบริการจากอุปกรณ์ต่อพ่วงที่มี UUID เดียวกัน และเพื่อเรียกใช้ฟังก์ชันที่ใช้ตัวระบุบริการ แสดง หากอินสแตนซ์นี้แสดงถึงบริการระยะไกล

  • คือหลัก

    boolean

    ระบุว่าบริการนี้เป็นประเภทหลักหรือรอง

  • Uuid

    สตริง

    UUID ของบริการ เช่น 0000180d-0000-1000-8000-00805f9b34fb.

ServiceData

Chrome 47 ขึ้นไป

พร็อพเพอร์ตี้

  • ข้อมูล

    ตัวเลข[]

  • 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 52 ขึ้นไป
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 52 ขึ้นไป
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 52 ขึ้นไป
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&lt;Descriptor&gt;

    Chrome 91 ขึ้นไป

    Promise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback

getDescriptors()

สัญญา
chrome.bluetoothLowEnergy.getDescriptors(
  characteristicId: string,
  callback?: function,
)

รับรายการข้อบ่งชี้ลักษณะเฉพาะของ GATT ที่เป็นของลักษณะเฉพาะที่ระบุ

พารามิเตอร์

  • characteristicId

    สตริง

    รหัสอินสแตนซ์ของลักษณะ GATT ที่ควรแสดงผลข้อบ่งชี้

  • Callback

    ไม่บังคับ

    พารามิเตอร์ callback มีลักษณะดังนี้

    (result: Descriptor[]) => void

การคืนสินค้า

  • Promise&lt;Descriptor[]&gt;

    Chrome 91 ขึ้นไป

    Promise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback

getIncludedServices()

สัญญา
chrome.bluetoothLowEnergy.getIncludedServices(
  serviceId: string,
  callback?: function,
)

รับรายการบริการ GATT ที่บริการดังกล่าวรวมอยู่

พารามิเตอร์

  • รหัสบริการ

    สตริง

    รหัสอินสแตนซ์ของบริการ GATT ที่ควรแสดงบริการที่รวมไว้

  • Callback

    ไม่บังคับ

    พารามิเตอร์ callback มีลักษณะดังนี้

    (result: Service[]) => void

การคืนสินค้า

  • สัญญา<บริการ[]>

    Chrome 91 ขึ้นไป

    Promise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback

getService()

สัญญา
chrome.bluetoothLowEnergy.getService(
  serviceId: string,
  callback?: function,
)

รับบริการ GATT ด้วยรหัสอินสแตนซ์ที่ระบุ

พารามิเตอร์

  • รหัสบริการ

    สตริง

    รหัสอินสแตนซ์ของบริการ GATT ที่ขอ

  • Callback

    ไม่บังคับ

    พารามิเตอร์ callback มีลักษณะดังนี้

    (result: Service) => void

การคืนสินค้า

  • Promise&lt;Service&gt;

    Chrome 91 ขึ้นไป

    Promise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback

getServices()

สัญญา
chrome.bluetoothLowEnergy.getServices(
  deviceAddress: string,
  callback?: function,
)

รับบริการ GATT ทั้งหมดที่พบในอุปกรณ์ระยะไกลโดยใช้ที่อยู่อุปกรณ์ที่ระบุ

หมายเหตุ: หากการค้นหาบริการในอุปกรณ์ยังไม่เสร็จสมบูรณ์ API นี้จะส่งคืนบริการบางส่วน (อาจว่างเปล่า) วิธีแก้ปัญหาคือการเพิ่มการหน่วงเวลาและ/หรือการโทรซ้ำๆ จนกว่าจะส่งคืนบริการตามจำนวนที่คาดไว้

พารามิเตอร์

  • deviceAddress

    สตริง

    ที่อยู่บลูทูธของอุปกรณ์ระยะไกลที่ควรส่งคืนบริการ GATT

  • Callback

    ไม่บังคับ

    พารามิเตอร์ callback มีลักษณะดังนี้

    (result: Service[]) => void

การคืนสินค้า

  • สัญญา<บริการ[]>

    Chrome 91 ขึ้นไป

    Promise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback

notifyCharacteristicValueChanged()

สัญญา Chrome 52 ขึ้นไป
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&lt;Descriptor&gt;

    Chrome 91 ขึ้นไป

    Promise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback

registerAdvertisement()

สัญญา Chrome 47 ขึ้นไป
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&lt;number&gt;

    Chrome 91 ขึ้นไป

    Promise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback

registerService()

สัญญา Chrome 52 ขึ้นไป
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 52 ขึ้นไป
chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
)

นำบริการที่ระบุออก ยกเลิกการลงทะเบียนบริการ ถ้าลงทะเบียนไว้ หากรหัสบริการไม่ถูกต้อง ระบบจะตั้งค่า lastError ฟังก์ชันนี้จะใช้ได้ต่อเมื่อแอปตั้งค่าทั้ง Bluetooth:low_energy และสิทธิ์เข้าถึง Bluetooth:peripheral เป็น "จริง" สิทธิ์เข้าถึงอุปกรณ์ต่อพ่วงอาจไม่พร้อมใช้งานกับบางแอป

พารามิเตอร์

  • รหัสบริการ

    สตริง

    รหัสที่ไม่ซ้ำกันของบริการที่ลงทะเบียนในปัจจุบัน

  • Callback

    ไม่บังคับ

    พารามิเตอร์ callback มีลักษณะดังนี้

    () => void

การคืนสินค้า

  • คำมั่นสัญญา<โมฆะ>

    Chrome 91 ขึ้นไป

    Promise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback

resetAdvertising()

สัญญา Chrome 61 ขึ้นไป
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
)

รีเซ็ตการโฆษณาในอุปกรณ์ปัจจุบัน การดำเนินการนี้จะยกเลิกการลงทะเบียนและหยุดโฆษณาทั้งหมดที่มีอยู่

พารามิเตอร์

  • Callback

    ไม่บังคับ

    พารามิเตอร์ callback มีลักษณะดังนี้

    () => void

การคืนสินค้า

  • คำมั่นสัญญา<โมฆะ>

    Chrome 91 ขึ้นไป

    Promise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback

sendRequestResponse()

Chrome 52 ขึ้นไป
chrome.bluetoothLowEnergy.sendRequestResponse(
  response: Response,
)

ส่งการตอบกลับคำขออ่าน/เขียนลักษณะเฉพาะหรือข้อบ่งชี้ ฟังก์ชันนี้จะใช้ได้ต่อเมื่อแอปตั้งค่าทั้ง Bluetooth:low_energy และสิทธิ์เข้าถึง Bluetooth:peripheral เป็น "จริง" สิทธิ์เข้าถึงอุปกรณ์ต่อพ่วงอาจไม่พร้อมใช้งานกับบางแอป

พารามิเตอร์

setAdvertisingInterval()

สัญญา Chrome 55 ขึ้นไป
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 47 ขึ้นไป
chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
)

ยกเลิกการลงทะเบียนโฆษณาและหยุดการโฆษณา หากโฆษณายกเลิกการลงทะเบียนไม่ได้ วิธีเดียวที่จะหยุดโฆษณาได้คือการรีสตาร์ทอุปกรณ์

พารามิเตอร์

  • advertisementId

    ตัวเลข

    รหัสโฆษณาที่จะยกเลิกการลงทะเบียน

  • Callback

    ไม่บังคับ

    พารามิเตอร์ callback มีลักษณะดังนี้

    () => void

การคืนสินค้า

  • คำมั่นสัญญา<โมฆะ>

    Chrome 91 ขึ้นไป

    Promise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback

unregisterService()

สัญญา Chrome 52 ขึ้นไป
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 52 ขึ้นไป
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

พารามิเตอร์

onCharacteristicWriteRequest

Chrome 52 ขึ้นไป
chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
  callback: function,
)

เริ่มทำงานเมื่ออุปกรณ์ส่วนกลางที่เชื่อมต่อขอเขียนค่าของลักษณะที่ลงทะเบียนในเซิร์ฟเวอร์ GATT ในเครื่อง การไม่ตอบกลับคำขอนี้เป็นเวลานานอาจทำให้ผู้ใช้ขาดการเชื่อมต่อ เหตุการณ์นี้จะใช้ได้เฉพาะเมื่อแอปตั้งค่าทั้งสิทธิ์เข้าถึง Bluetooth:low_energy และ Bluetooth:peripheral เป็น "จริง" สิทธิ์เข้าถึงอุปกรณ์ต่อพ่วงอาจไม่พร้อมใช้งานกับบางแอป

พารามิเตอร์

  • Callback

    ฟังก์ชัน

    พารามิเตอร์ callback มีลักษณะดังนี้

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

    • ส่งคำขอ
    • characteristicId

      สตริง

onDescriptorReadRequest

Chrome 52 ขึ้นไป
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 52 ขึ้นไป
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 ที่พบก่อนหน้านี้ออกจากอุปกรณ์ระยะไกลถูกนำออก

พารามิเตอร์

  • Callback

    ฟังก์ชัน

    พารามิเตอร์ callback มีลักษณะดังนี้

    (service: Service) => void