chrome.bluetoothLowEnergy

คำอธิบาย

chrome.bluetoothLowEnergy API ใช้เพื่อสื่อสารกับอุปกรณ์บลูทูธอัจฉริยะ (พลังงานต่ำ) โดยใช้โปรไฟล์แอตทริบิวต์ทั่วไป (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

    ประเภทโฆษณา

AdvertisementType

Chrome 47 ขึ้นไป

ประเภทโฆษณา หากเลือก "broadcast" ประเภทโฆษณาที่ส่งจะเป็น ADV_NONCONN_IND และอุปกรณ์จะออกอากาศด้วยที่อยู่ MAC แบบสุ่ม หากตั้งค่าเป็น "อุปกรณ์ต่อพ่วง" ประเภทการโฆษณาจะเป็น ADV_IND หรือ ADV_SCAN_IND และอุปกรณ์จะออกอากาศด้วยที่อยู่ MAC ของอะแดปเตอร์บลูทูธจริง

ค่าแจกแจง

"broadcast"

"อุปกรณ์ต่อพ่วง"

Characteristic

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

  • instanceId

    สตริง ไม่บังคับ

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

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

    CharacteristicProperty[]

    คุณสมบัติของลักษณะนี้

  • บริการ

    บริการ ไม่บังคับ

    บริการ GATT ที่ลักษณะนี้เป็นของ

  • uuid

    สตริง

    UUID ของลักษณะ เช่น 00002a37-0000-1000-8000-00805f9b34fb

  • value

    ArrayBuffer ไม่บังคับ

    ค่าลักษณะที่แคชไว้ในปัจจุบัน ค่านี้จะได้รับการอัปเดตเมื่อมีการอ่านหรืออัปเดตค่าของลักษณะผ่านการแจ้งเตือนหรือการระบุ

CharacteristicProperty

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

ค่าแจกแจง

"broadcast"

"read"

"writeWithoutResponse"

"เขียน"

"notify"

"ระบุ"

"authenticatedSignedWrites"

"extendedProperties"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

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

  • ต่อเนื่อง

    บูลีน

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

Descriptor

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

  • ลักษณะเฉพาะ

    ลักษณะ ไม่บังคับ

    ลักษณะ GATT ที่ตัวอธิบายนี้เป็นของ

  • instanceId

    สตริง ไม่บังคับ

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

  • สิทธิ์

    DescriptorPermission[]

    Chrome 52 ขึ้นไป

    สิทธิ์ของตัวอธิบายนี้

  • uuid

    สตริง

    UUID ของตัวอธิบายลักษณะ เช่น 00002902-0000-1000-8000-00805f9b34fb

  • value

    ArrayBuffer ไม่บังคับ

    ค่าตัวอธิบายที่แคชไว้ในปัจจุบัน ค่านี้จะได้รับการอัปเดตเมื่ออ่านค่าของตัวอธิบาย

DescriptorPermission

Chrome 52 ขึ้นไป

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

ค่าแจกแจง

"read"

"เขียน"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome 52 ขึ้นไป

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

  • ที่อยู่

    สตริง

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

  • deviceClass

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

    คลาสของอุปกรณ์ ซึ่งเป็นฟิลด์บิตที่กำหนดโดย http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband

  • ชื่อ

    สตริง ไม่บังคับ

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

ManufacturerData

Chrome 47 ขึ้นไป

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

  • เพิ่มเติม

    number[]

  • id

    ตัวเลข

Notification

Chrome 52 ขึ้นไป

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

  • shouldIndicate

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

    แฟล็กที่ไม่บังคับสำหรับการส่งข้อบ่งชี้แทนการแจ้งเตือน

  • value

    ArrayBuffer

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

NotificationProperties

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

  • ต่อเนื่อง

    บูลีน

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

Request

Chrome 52 ขึ้นไป

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

  • อุปกรณ์

    อุปกรณ์

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

  • requestId

    ตัวเลข

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

  • value

    ArrayBuffer ไม่บังคับ

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

Response

Chrome 52 ขึ้นไป

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

  • isError

    บูลีน

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

  • requestId

    ตัวเลข

    รหัสของคำขอที่นี่คือคำตอบ

  • value

    ArrayBuffer ไม่บังคับ

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

Service

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

  • deviceAddress

    สตริง ไม่บังคับ

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

  • instanceId

    สตริง ไม่บังคับ

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

  • isPrimary

    บูลีน

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

  • uuid

    สตริง

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

ServiceData

Chrome 47 ขึ้นไป

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

  • เพิ่มเติม

    number[]

  • uuid

    สตริง

เมธอด

connect()

Promise 
chrome.bluetoothLowEnergy.connect(
  deviceAddress: string,
  properties?: ConnectProperties,
  callback?: function,
): Promise<void>

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

พารามิเตอร์

  • deviceAddress

    สตริง

    ที่อยู่บลูทูธของอุปกรณ์ระยะไกลที่ควรเปิดการเชื่อมต่อ GATT

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

    ConnectProperties ไม่บังคับ

    พร็อพเพอร์ตี้ของการเชื่อมต่อ (ไม่บังคับ)

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    () => void

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

  • Promise<void>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

createCharacteristic()

Promise Chrome 52 ขึ้นไป 
chrome.bluetoothLowEnergy.createCharacteristic(
  characteristic: Characteristic,
  serviceId: string,
  callback?: function,
): Promise<string>

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

พารามิเตอร์

  • ลักษณะเฉพาะ

    ลักษณะ

    ลักษณะที่จะสร้าง

  • serviceId

    สตริง

    รหัสของบริการที่จะสร้างลักษณะนี้

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    (characteristicId: string) => void

    • characteristicId

      สตริง

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

  • Promise<string>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

createDescriptor()

Promise Chrome 52 ขึ้นไป 
chrome.bluetoothLowEnergy.createDescriptor(
  descriptor: Descriptor,
  characteristicId: string,
  callback?: function,
): Promise<string>

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

พารามิเตอร์

  • ข้อบ่งชี้

    ตัวอธิบาย

    ตัวอธิบายที่จะสร้าง

  • characteristicId

    สตริง

    รหัสของลักษณะที่จะสร้างตัวอธิบายนี้

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    (descriptorId: string) => void

    • descriptorId

      สตริง

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

  • Promise<string>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

createService()

Promise Chrome 52 ขึ้นไป 
chrome.bluetoothLowEnergy.createService(
  service: Service,
  callback?: function,
): Promise<string>

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

พารามิเตอร์

  • บริการ

    บริการ

    บริการที่จะสร้าง

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    (serviceId: string) => void

    • serviceId

      สตริง

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

  • Promise<string>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

disconnect()

Promise 
chrome.bluetoothLowEnergy.disconnect(
  deviceAddress: string,
  callback?: function,
): Promise<void>

ปิดการเชื่อมต่อของแอปกับอุปกรณ์ที่มีที่อยู่ที่ระบุ โปรดทราบว่าการดำเนินการนี้ไม่ได้ทำลายลิงก์จริงเสมอไป เนื่องจากอาจมีแอปอื่นๆ ที่มีการเชื่อมต่อแบบเปิดอยู่

พารามิเตอร์

  • deviceAddress

    สตริง

    ที่อยู่บลูทูธของอุปกรณ์ระยะไกล

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    () => void

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

  • Promise<void>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

getCharacteristic()

Promise 
chrome.bluetoothLowEnergy.getCharacteristic(
  characteristicId: string,
  callback?: function,
): Promise<Characteristic>

รับลักษณะ GATT ที่มีรหัสอินสแตนซ์ที่ระบุซึ่งเป็นของบริการ GATT ที่ระบุ หากมีลักษณะดังกล่าว

พารามิเตอร์

  • characteristicId

    สตริง

    รหัสอินสแตนซ์ของลักษณะ GATT ที่ขอ

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    (result: Characteristic) => void

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

  • Promise<Characteristic>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

getCharacteristics()

Promise 
chrome.bluetoothLowEnergy.getCharacteristics(
  serviceId: string,
  callback?: function,
): Promise<Characteristic[]>

รับรายการลักษณะ GATT ที่ค้นพบทั้งหมดซึ่งเป็นของบริการที่ระบุ

พารามิเตอร์

  • serviceId

    สตริง

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

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    (result: Characteristic[]) => void

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

  • Promise<Characteristic[]>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

getDescriptor()

Promise 
chrome.bluetoothLowEnergy.getDescriptor(
  descriptorId: string,
  callback?: function,
): Promise<Descriptor>

รับตัวอธิบายลักษณะ GATT ที่มีรหัสอินสแตนซ์ที่ระบุ

พารามิเตอร์

  • descriptorId

    สตริง

    รหัสอินสแตนซ์ของตัวอธิบายลักษณะ GATT ที่ขอ

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    (result: Descriptor) => void

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

  • Promise<Descriptor>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

getDescriptors()

Promise 
chrome.bluetoothLowEnergy.getDescriptors(
  characteristicId: string,
  callback?: function,
): Promise<Descriptor[]>

รับรายการตัวอธิบายลักษณะ GATT ที่เป็นของลักษณะที่ระบุ

พารามิเตอร์

  • characteristicId

    สตริง

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

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    (result: Descriptor[]) => void

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

  • Promise<Descriptor[]>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

getIncludedServices()

Promise 
chrome.bluetoothLowEnergy.getIncludedServices(
  serviceId: string,
  callback?: function,
): Promise<Service[]>

รับรายการบริการ GATT ที่รวมอยู่ในบริการที่ระบุ

พารามิเตอร์

  • serviceId

    สตริง

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

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    (result: Service[]) => void

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

  • Promise<Service[]>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

getService()

Promise 
chrome.bluetoothLowEnergy.getService(
  serviceId: string,
  callback?: function,
): Promise<Service>

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

พารามิเตอร์

  • serviceId

    สตริง

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

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    (result: Service) => void

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

  • Promise<Service>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

getServices()

Promise 
chrome.bluetoothLowEnergy.getServices(
  deviceAddress: string,
  callback?: function,
): Promise<Service[]>

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

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

พารามิเตอร์

  • deviceAddress

    สตริง

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

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    (result: Service[]) => void

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

  • Promise<Service[]>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

notifyCharacteristicValueChanged()

Promise Chrome 52 ขึ้นไป 
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
  characteristicId: string,
  notification: Notification,
  callback?: function,
): Promise<void>

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

พารามิเตอร์

  • characteristicId

    สตริง

    ลักษณะที่จะส่งการแจ้งเตือน

  • การแจ้งเตือน

    การแจ้งเตือน

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    () => void

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

  • Promise<void>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

readCharacteristicValue()

Promise 
chrome.bluetoothLowEnergy.readCharacteristicValue(
  characteristicId: string,
  callback?: function,
): Promise<Characteristic>

เรียกค่าของลักษณะที่ระบุจากอุปกรณ์ต่อพ่วงระยะไกล

พารามิเตอร์

  • characteristicId

    สตริง

    รหัสอินสแตนซ์ของลักษณะ GATT ที่ควรอ่านค่าจากอุปกรณ์ระยะไกล

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    (result: Characteristic) => void

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

  • Promise<Characteristic>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

readDescriptorValue()

Promise 
chrome.bluetoothLowEnergy.readDescriptorValue(
  descriptorId: string,
  callback?: function,
): Promise<Descriptor>

ดึงค่าของตัวอธิบายลักษณะที่ระบุจากอุปกรณ์ต่อพ่วงระยะไกล

พารามิเตอร์

  • descriptorId

    สตริง

    รหัสอินสแตนซ์ของตัวอธิบายลักษณะ GATT ที่ควรอ่านค่าจากอุปกรณ์ระยะไกล

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    (result: Descriptor) => void

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

  • Promise<Descriptor>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

registerAdvertisement()

Promise Chrome 47 ขึ้นไป 
chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
): Promise<number>

สร้างโฆษณาและลงทะเบียนเพื่อการโฆษณา หากต้องการเรียกใช้ฟังก์ชันนี้ แอปต้องตั้งค่าสิทธิ์ 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 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

registerService()

Promise Chrome 52 ขึ้นไป 
chrome.bluetoothLowEnergy.registerService(
  serviceId: string,
  callback?: function,
): Promise<void>

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

พารามิเตอร์

  • serviceId

    สตริง

    รหัสที่ไม่ซ้ำกันของบริการที่สร้างขึ้น

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    () => void

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

  • Promise<void>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

removeService()

Promise Chrome 52 ขึ้นไป 
chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
): Promise<void>

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

พารามิเตอร์

  • serviceId

    สตริง

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

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    () => void

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

  • Promise<void>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

resetAdvertising()

Promise Chrome 61 ขึ้นไป 
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
): Promise<void>

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

พารามิเตอร์

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    () => void

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

  • Promise<void>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

sendRequestResponse()

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

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

พารามิเตอร์

setAdvertisingInterval()

Promise Chrome 55 ขึ้นไป 
chrome.bluetoothLowEnergy.setAdvertisingInterval(
  minInterval: number,
  maxInterval: number,
  callback?: function,
): Promise<void>

ตั้งค่าช่วงเวลาระหว่างโฆษณา 2 รายการที่แสดงติดต่อกัน หมายเหตุ: เราจะพยายามอย่างเต็มที่ ช่วงเวลาจริงอาจแตกต่างจากช่วงเวลาที่ขออย่างมาก ฮาร์ดแวร์บางรุ่นมีช่วงเวลาขั้นต่ำ 100 มิลลิวินาที ค่าต่ำสุดและสูงสุดต้องไม่เกินช่วงที่ข้อกำหนดของ Bluetooth 4.2 อนุญาต

พารามิเตอร์

  • minInterval

    ตัวเลข

    ช่วงเวลาขั้นต่ำระหว่างโฆษณา (เป็นมิลลิวินาที) ค่านี้ต้องไม่ต่ำกว่า 20 มิลลิวินาที (ตามข้อกำหนด)

  • maxInterval

    ตัวเลข

    ช่วงเวลาสูงสุดระหว่างการโฆษณา (เป็นมิลลิวินาที) ค่านี้ต้องไม่เกิน 10240 มิลลิวินาที (ตามข้อกำหนด)

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    () => void

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

  • Promise<void>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

startCharacteristicNotifications()

Promise 
chrome.bluetoothLowEnergy.startCharacteristicNotifications(
  characteristicId: string,
  properties?: NotificationProperties,
  callback?: function,
): Promise<void>

เปิดใช้การแจ้งเตือน/การบ่งชี้ค่าจากลักษณะที่ระบุ เมื่อเปิดใช้แล้ว แอปพลิเคชันจะฟังการแจ้งเตือนได้โดยใช้เหตุการณ์ onCharacteristicValueChanged

พารามิเตอร์

  • characteristicId

    สตริง

    รหัสอินสแตนซ์ของลักษณะ GATT ที่ควรเปิดใช้การแจ้งเตือน

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

    NotificationProperties ไม่บังคับ

    พร็อพเพอร์ตี้เซสชันการแจ้งเตือน (ไม่บังคับ)

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    () => void

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

  • Promise<void>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

stopCharacteristicNotifications()

Promise 
chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
  characteristicId: string,
  callback?: function,
): Promise<void>

ปิดใช้การแจ้งเตือน/ข้อบ่งชี้ค่าจากลักษณะที่ระบุ หลังจากโทรออกสำเร็จแล้ว แอปพลิเคชันจะหยุดรับการแจ้งเตือน/ข้อบ่งชี้จากลักษณะนี้

พารามิเตอร์

  • characteristicId

    สตริง

    รหัสอินสแตนซ์ของลักษณะ GATT ที่ควรหยุดเซสชันการแจ้งเตือนของแอปนี้

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    () => void

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

  • Promise<void>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

unregisterAdvertisement()

Promise Chrome 47 ขึ้นไป 
chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
): Promise<void>

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

พารามิเตอร์

  • advertisementId

    ตัวเลข

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

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    () => void

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

  • Promise<void>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

unregisterService()

Promise Chrome 52 ขึ้นไป 
chrome.bluetoothLowEnergy.unregisterService(
  serviceId: string,
  callback?: function,
): Promise<void>

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

พารามิเตอร์

  • serviceId

    สตริง

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

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    () => void

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

  • Promise<void>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

writeCharacteristicValue()

Promise 
chrome.bluetoothLowEnergy.writeCharacteristicValue(
  characteristicId: string,
  value: ArrayBuffer,
  callback?: function,
): Promise<void>

เขียนค่าของลักษณะที่ระบุจากอุปกรณ์ต่อพ่วงระยะไกล

พารามิเตอร์

  • characteristicId

    สตริง

    รหัสอินสแตนซ์ของลักษณะ GATT ที่ควรเขียนค่า

  • value

    ArrayBuffer

    ค่าที่ควรส่งไปยังลักษณะระยะไกลเป็นส่วนหนึ่งของคำขอเขียน

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    () => void

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

  • Promise<void>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

writeDescriptorValue()

Promise 
chrome.bluetoothLowEnergy.writeDescriptorValue(
  descriptorId: string,
  value: ArrayBuffer,
  callback?: function,
): Promise<void>

เขียนค่าของตัวอธิบายลักษณะที่ระบุจากอุปกรณ์ต่อพ่วงระยะไกล

พารามิเตอร์

  • descriptorId

    สตริง

    รหัสอินสแตนซ์ของตัวอธิบายลักษณะ GATT ที่ควรเขียนค่า

  • value

    ArrayBuffer

    ค่าที่ควรส่งไปยังตัวอธิบายระยะไกลเป็นส่วนหนึ่งของคำขอเขียน

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    () => void

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

  • Promise<void>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

กิจกรรม

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

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (characteristic: Characteristic) => void

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