chrome.bluetoothLowEnergy

Nội dung mô tả

API chrome.bluetoothLowEnergy được dùng để giao tiếp với các thiết bị Bluetooth thông minh (Năng lượng thấp) bằng Cấu hình thuộc tính chung (GATT).

Tệp kê khai

Bạn phải khai báo các khoá sau trong tệp kê khai để sử dụng API này.

"bluetooth"

Loại

Advertisement

Chrome 47 trở lên

Thuộc tính

  • manufacturerData

    ManufacturerData[] không bắt buộc

    Danh sách dữ liệu cụ thể của nhà sản xuất để đưa vào trường "Dữ liệu cụ thể của nhà sản xuất" của dữ liệu quảng cáo.

  • serviceData

    ServiceData[] không bắt buộc

    Danh sách dữ liệu dịch vụ có trong trường "Dữ liệu dịch vụ" của dữ liệu quảng cáo.

  • serviceUuids

    string[] không bắt buộc

    Danh sách mã nhận dạng duy nhất (UUID) cần bao gồm trong trường "Mã nhận dạng duy nhất (UUID) dịch vụ" của Dữ liệu quảng cáo). Các UUID này có thể ở định dạng 16 bit, 32 bit hoặc 128.

  • solicitUuids

    string[] không bắt buộc

    Danh sách mã nhận dạng duy nhất (UUID) cần đưa vào trường "Yêu cầu UUID" của Dữ liệu quảng cáo. Các UUID này có thể ở định dạng 16 bit, 32 bit hoặc 128.

  • Loại quảng cáo.

AdvertisementType

Chrome 47 trở lên

Loại quảng cáo. Nếu bạn chọn "phát sóng", loại quảng cáo được gửi sẽ là ADV_NONCONN_IND và thiết bị sẽ phát sóng với một Địa chỉ MAC ngẫu nhiên. Nếu được đặt thành 'ngoại tuyến', loại quảng cáo sẽ là ADV_IND hoặc ADV_SCAN_IND và thiết bị sẽ phát với Địa chỉ MAC thực của Bộ điều hợp Bluetooth.

Liệt kê

"broadcast"

Characteristic

Thuộc tính

  • instanceId

    chuỗi không bắt buộc

    Trả về giá trị nhận dạng được gán cho đặc điểm này. Sử dụng mã thực thể để phân biệt các đặc điểm của một thiết bị ngoại vi có cùng mã nhận dạng duy nhất (UUID) và để thực hiện các lệnh gọi hàm nhận giá trị nhận dạng đặc điểm. Trình bày, nếu phiên bản này đại diện cho một đặc điểm từ xa.

  • các tài sản

    CharacteristicProperty[]

    Đặc tính của đặc điểm này.

  • dịch vụ

    Dịch vụ không bắt buộc

    Dịch vụ GATT sử dụng đặc điểm này.

  • uuid

    string

    UUID của đặc điểm, ví dụ: 00002a37-0000-1000-8000-00805f9b34fb.

  • value

    ArrayBuffer không bắt buộc

    Giá trị của đặc điểm hiện được lưu vào bộ nhớ đệm. Giá trị này được cập nhật khi giá trị của đặc điểm được đọc hoặc cập nhật thông qua một thông báo hoặc chỉ báo.

CharacteristicProperty

Giá trị đại diện cho các tính chất có thể có của một đặc điểm. Các quyền đặc điểm được suy ra từ các thuộc tính này. Vui lòng xem thông số kỹ thuật Bluetooth 4.x để biết ý nghĩa của từng thuộc tính.

Liệt kê

"broadcast"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

ConnectProperties

Thuộc tính

  • cố định

    boolean

    Cờ cho biết liệu một kết nối với thiết bị có đang mở khi trang sự kiện của ứng dụng bị huỷ tải hay không (xem phần Quản lý vòng đời ứng dụng). Giá trị mặc định là false.

Descriptor

Thuộc tính

  • đặc điểm

    Đặc điểm không bắt buộc

    Đặc tính GATT có phần mô tả này.

  • instanceId

    chuỗi không bắt buộc

    Trả về giá trị nhận dạng được chỉ định cho phần mô tả này. Sử dụng mã thực thể để phân biệt các mã mô tả của một thiết bị ngoại vi có cùng mã nhận dạng duy nhất (UUID) và để thực hiện các lệnh gọi hàm có giá trị nhận dạng chỉ số mô tả. Trình bày, nếu phiên bản này đại diện cho một đặc điểm từ xa.

  • Chrome 52 trở lên

    Các quyền của chỉ số mô tả này.

  • uuid

    string

    UUID của mô tả đặc điểm, ví dụ: 00002902-0000-1000-8000-00805f9b34fb.

  • value

    ArrayBuffer không bắt buộc

    Giá trị của mã mô tả hiện được lưu vào bộ nhớ đệm. Giá trị này được cập nhật khi giá trị của chỉ số mô tả được đọc.

DescriptorPermission

Chrome 52 trở lên

Giá trị thể hiện các quyền có thể có đối với phần mô tả. Vui lòng xem thông số kỹ thuật Bluetooth 4.x để biết ý nghĩa của từng quyền.

Liệt kê

"encryptedWrite"

Device

Chrome 52 trở lên

Thuộc tính

  • xử lý

    string

    Địa chỉ của thiết bị, ở định dạng "XX:XX:XX:XX:XX:XX".

  • deviceClass

    số không bắt buộc

    Lớp của thiết bị, trường bit được xác định bởi http://www.bluetooth.org/en-us/specification/attributes-numbers/base Band.

  • tên

    chuỗi không bắt buộc

    Tên thiết bị mà con người có thể đọc được.

ManufacturerData

Chrome 47 trở lên

Thuộc tính

  • data

    số[]

  • id

    number

Notification

Chrome 52 trở lên

Thuộc tính

  • shouldIndicate

    boolean không bắt buộc

    Cờ không bắt buộc để gửi chỉ báo thay vì thông báo.

  • value

    ArrayBuffer

    Giá trị mới của đặc điểm này.

NotificationProperties

Thuộc tính

  • cố định

    boolean

    Cờ cho biết liệu ứng dụng có nhận được thông báo khi trang sự kiện của ứng dụng bị huỷ tải hay không (xem phần Quản lý vòng đời của ứng dụng). Giá trị mặc định là false.

Request

Chrome 52 trở lên

Thuộc tính

  • thiết bị

    Thiết bị

    Thiết bị gửi yêu cầu này.

  • requestId

    number

    Mã nhận dạng duy nhất cho yêu cầu này. Hãy sử dụng mã này khi phản hồi yêu cầu này.

  • value

    ArrayBuffer không bắt buộc

    Giá trị cần ghi (nếu đây là yêu cầu ghi).

Response

Chrome 52 trở lên

Thuộc tính

  • isError

    boolean

    Nếu đây là phản hồi lỗi, thì điều này phải đúng.

  • requestId

    number

    Mã của yêu cầu. Đây là phản hồi.

  • value

    ArrayBuffer không bắt buộc

    Giá trị phản hồi. Các yêu cầu ghi và phản hồi lỗi sẽ bỏ qua thông số này.

Service

Thuộc tính

  • deviceAddress

    chuỗi không bắt buộc

    Địa chỉ thiết bị của thiết bị ngoại vi từ xa chứa dịch vụ GATT. Hiển thị, nếu phiên bản này đại diện cho một dịch vụ từ xa.

  • instanceId

    chuỗi không bắt buộc

    Trả về giá trị nhận dạng được chỉ định cho dịch vụ này. Sử dụng mã thực thể để phân biệt các dịch vụ của một thiết bị ngoại vi có cùng mã nhận dạng duy nhất (UUID) và để thực hiện các lệnh gọi hàm lấy mã nhận dạng dịch vụ. Hiển thị, nếu phiên bản này đại diện cho một dịch vụ từ xa.

  • isPrimary

    boolean

    Cho biết loại dịch vụ này là chính hay phụ.

  • uuid

    string

    Mã nhận dạng duy nhất (UUID) của dịch vụ, ví dụ: 0000180d-0000-1000-8000-00805f9b34fb.

ServiceData

Chrome 47 trở lên

Thuộc tính

  • data

    số[]

  • uuid

    string

Phương thức

connect()

Cam kết 
chrome.bluetoothLowEnergy.connect(
  deviceAddress: string,
  properties?: ConnectProperties,
  callback?: function,
)

Thiết lập kết nối giữa ứng dụng và thiết bị bằng địa chỉ đã cho. Một thiết bị có thể đã được kết nối và các dịch vụ GATT của thiết bị đó vẫn hoạt động mà không cần gọi connect. Tuy nhiên, một ứng dụng muốn truy cập vào các dịch vụ GATT của thiết bị phải gọi hàm này để đảm bảo duy trì kết nối với thiết bị. Nếu thiết bị chưa được kết nối, tất cả dịch vụ GATT của thiết bị sẽ được phát hiện sau khi gọi connect thành công.

Tham số

  • deviceAddress

    string

    Địa chỉ Bluetooth của thiết bị từ xa cần mở kết nối GATT.

  • các tài sản

    ConnectProperties không bắt buộc

    Thuộc tính kết nối (không bắt buộc).

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    ()=>void

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

createCharacteristic()

Cam kết Chrome 52 trở lên 
chrome.bluetoothLowEnergy.createCharacteristic(
  characteristic: Characteristic,
  serviceId: string,
  callback?: function,
)

Tạo đặc điểm GATT được lưu trữ cục bộ. Đặc điểm này phải được lưu trữ trong một dịch vụ hợp lệ. Nếu mã dịch vụ không hợp lệ, giá trị lastError sẽ được đặt. Chức năng này chỉ dùng được nếu ứng dụng có cả quyền bluetooth:low_energy và bluetooth:thiết bị ngoại vi được đặt thành true. Một số ứng dụng có thể không dùng được quyền truy cập vào thiết bị ngoại vi.

Tham số

  • đặc điểm

    Đặc điểm

    Đặc điểm cần sáng tạo.

  • serviceId

    string

    Mã nhận dạng của dịch vụ dùng để tạo đặc điểm này.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    (characteristicId: string)=>void

    • characteristicId

      string

Giá trị trả về

  • Hứa hẹn<string>

    Chrome 91 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

createDescriptor()

Cam kết Chrome 52 trở lên 
chrome.bluetoothLowEnergy.createDescriptor(
  descriptor: Descriptor,
  characteristicId: string,
  callback?: function,
)

Tạo một phần mô tả GATT được lưu trữ cục bộ. Mã mô tả này phải được lưu trữ theo một đặc điểm hợp lệ. Nếu mã nhận dạng đặc điểm không hợp lệ, thì giá trị lastError sẽ được đặt. Chức năng này chỉ dùng được nếu ứng dụng có cả quyền bluetooth:low_energy và bluetooth:thiết bị ngoại vi được đặt thành true. Một số ứng dụng có thể không dùng được quyền truy cập vào thiết bị ngoại vi.

Tham số

  • phần mô tả

    Phần mô tả

    Phần mô tả cần tạo.

  • characteristicId

    string

    Mã nhận dạng của đặc điểm để tạo ra mã mô tả này.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    (descriptorId: string)=>void

    • descriptorId

      string

Giá trị trả về

  • Hứa hẹn<string>

    Chrome 91 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

createService()

Cam kết Chrome 52 trở lên 
chrome.bluetoothLowEnergy.createService(
  service: Service,
  callback?: function,
)

Tạo dịch vụ GATT được lưu trữ cục bộ. Bạn có thể đăng ký dịch vụ này để sử dụng trên máy chủ GATT cục bộ. Chức năng này chỉ dùng được nếu ứng dụng có cả quyền bluetooth:low_energy và bluetooth:thiết bị ngoại vi được đặt thành true. Một số ứng dụng có thể không dùng được quyền truy cập vào thiết bị ngoại vi.

Tham số

  • dịch vụ

    Dịch vụ

    Dịch vụ cần tạo.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    (serviceId: string)=>void

    • serviceId

      string

Giá trị trả về

  • Hứa hẹn<string>

    Chrome 91 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

disconnect()

Cam kết 
chrome.bluetoothLowEnergy.disconnect(
  deviceAddress: string,
  callback?: function,
)

Đóng kết nối của ứng dụng với thiết bị có địa chỉ đã cho. Xin lưu ý rằng thao tác này không phải lúc nào cũng huỷ bỏ chính đường liên kết vật lý, vì có thể có các ứng dụng khác có kết nối đang mở.

Tham số

  • deviceAddress

    string

    Địa chỉ Bluetooth của thiết bị từ xa.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    ()=>void

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getCharacteristic()

Cam kết 
chrome.bluetoothLowEnergy.getCharacteristic(
  characteristicId: string,
  callback?: function,
)

Lấy đặc tính GATT bằng mã thực thể cho trước thuộc dịch vụ GATT nhất định, nếu đặc điểm này tồn tại.

Tham số

  • characteristicId

    string

    Mã thực thể của đặc tính GATT được yêu cầu.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    (result: Characteristic)=>void

Giá trị trả về

  • Promise<Characteristic>

    Chrome 91 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getCharacteristics()

Cam kết 
chrome.bluetoothLowEnergy.getCharacteristics(
  serviceId: string,
  callback?: function,
)

Nhận danh sách tất cả đặc điểm GATT đã phát hiện thuộc về dịch vụ nhất định.

Tham số

  • serviceId

    string

    Mã thực thể của dịch vụ GATT có các đặc điểm cần được trả về.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    (result: Characteristic[])=>void

Giá trị trả về

  • Promise<Characteristic[]>

    Chrome 91 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getDescriptor()

Cam kết 
chrome.bluetoothLowEnergy.getDescriptor(
  descriptorId: string,
  callback?: function,
)

Lấy mã mô tả đặc điểm GATT bằng mã thực thể cụ thể.

Tham số

  • descriptorId

    string

    Mã thực thể của mã mô tả đặc điểm GATT được yêu cầu.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    (result: Descriptor)=>void

Giá trị trả về

  • Promise<Descriptor>

    Chrome 91 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getDescriptors()

Cam kết 
chrome.bluetoothLowEnergy.getDescriptors(
  characteristicId: string,
  callback?: function,
)

Nhận danh sách mã mô tả đặc điểm GATT thuộc về đặc điểm đã cho.

Tham số

  • characteristicId

    string

    Mã thực thể của đặc điểm GATT có mã mô tả phải được trả về.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    (result: Descriptor[])=>void

Giá trị trả về

  • Promise<Descriptor[]>

    Chrome 91 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getIncludedServices()

Cam kết 
chrome.bluetoothLowEnergy.getIncludedServices(
  serviceId: string,
  callback?: function,
)

Nhận danh sách các dịch vụ GATT mà dịch vụ cụ thể cung cấp.

Tham số

  • serviceId

    string

    Mã thực thể của dịch vụ GATT có các dịch vụ đi kèm sẽ được trả về.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    (result: Service[])=>void

Giá trị trả về

  • Cam kết<Dịch vụ[]>

    Chrome 91 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getService()

Cam kết 
chrome.bluetoothLowEnergy.getService(
  serviceId: string,
  callback?: function,
)

Lấy dịch vụ GATT bằng mã thực thể đã cho.

Tham số

  • serviceId

    string

    Mã thực thể của dịch vụ GATT được yêu cầu.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    (result: Service)=>void

Giá trị trả về

  • Hứa hẹn<Dịch vụ>

    Chrome 91 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getServices()

Cam kết 
chrome.bluetoothLowEnergy.getServices(
  deviceAddress: string,
  callback?: function,
)

Lấy tất cả dịch vụ GATT mà Google phát hiện trên thiết bị từ xa bằng địa chỉ thiết bị cụ thể.

Lưu ý: Nếu quá trình khám phá dịch vụ chưa hoàn tất trên thiết bị, API này sẽ trả về một tập hợp con dịch vụ (có thể trống). Cách giải quyết là thêm độ trễ dựa trên thời gian và/hoặc gọi nhiều lần cho đến khi số lượng dịch vụ dự kiến được trả về.

Tham số

  • deviceAddress

    string

    Địa chỉ Bluetooth của thiết bị từ xa có dịch vụ GATT sẽ được trả về.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    (result: Service[])=>void

Giá trị trả về

  • Cam kết<Dịch vụ[]>

    Chrome 91 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

notifyCharacteristicValueChanged()

Cam kết Chrome 52 trở lên 
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
  characteristicId: string,
  notification: Notification,
  callback?: function,
)

Thông báo cho thiết bị từ xa về một giá trị mới cho một đặc điểm. Nếu cờ nên Cho biết trong đối tượng thông báo là true, thì một chỉ báo sẽ được gửi thay vì thông báo. Lưu ý rằng đặc điểm này cần đặt chính xác thuộc tính "thông báo" hoặc "cho biết" trong quá trình tạo để cuộc gọi này thành công. Chức năng này chỉ dùng được nếu ứng dụng có cả quyền bluetooth:low_energy và bluetooth:thiết bị ngoại vi được đặt thành true. Một số ứng dụng có thể không dùng được quyền truy cập vào thiết bị ngoại vi.

Tham số

  • characteristicId

    string

    Đặc điểm cần gửi thông báo.

  • notification

    Thông báo

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    ()=>void

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

readCharacteristicValue()

Cam kết 
chrome.bluetoothLowEnergy.readCharacteristicValue(
  characteristicId: string,
  callback?: function,
)

Truy xuất giá trị của một đặc điểm đã chỉ định từ thiết bị ngoại vi từ xa.

Tham số

  • characteristicId

    string

    Mã thực thể của đặc tính GATT có giá trị phải được đọc trên thiết bị từ xa.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    (result: Characteristic)=>void

Giá trị trả về

  • Promise<Characteristic>

    Chrome 91 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

readDescriptorValue()

Cam kết 
chrome.bluetoothLowEnergy.readDescriptorValue(
  descriptorId: string,
  callback?: function,
)

Truy xuất giá trị của mã mô tả đặc điểm đã chỉ định từ một thiết bị ngoại vi từ xa.

Tham số

  • descriptorId

    string

    Mã thực thể của mã mô tả đặc điểm GATT có giá trị phải được đọc trên thiết bị từ xa.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    (result: Descriptor)=>void

Giá trị trả về

  • Promise<Descriptor>

    Chrome 91 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

registerAdvertisement()

Cam kết Chrome 47 trở lên 
chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
)

Tạo một quảng cáo và đăng ký tham gia quảng cáo. Để gọi hàm này, ứng dụng phải đặt các quyền bluetooth:low_energy và bluetooth:ngoại vi thành true. Ngoài ra, API này chỉ có sẵn cho các ứng dụng tự động chạy ở Chế độ kiosk hoặc bằng cách đặt nút chuyển dòng lệnh '--enable-ble-advertising-in-apps'. Hãy xem https://developer.chrome.com/apps/manifest/bluetooth Lưu ý: Trên một số chế độ phần cứng, chế độ trung tâm và thiết bị ngoại vi được hỗ trợ đồng thời nhưng trên phần cứng không hỗ trợ chế độ này, việc thực hiện cuộc gọi này sẽ chuyển thiết bị sang chế độ thiết bị ngoại vi. Trong trường hợp phần cứng không hỗ trợ cả chế độ trung tâm và thiết bị ngoại vi, việc cố gắng sử dụng thiết bị ở cả hai chế độ sẽ dẫn đến hành vi không xác định hoặc ngăn các ứng dụng vai trò trung tâm khác hoạt động chính xác (bao gồm cả việc phát hiện thiết bị Bluetooth năng lượng thấp).

Tham số

  • quảng cáo

    Quảng cáo

    Quảng cáo để quảng cáo.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    (advertisementId: number)=>void

    • advertisementId

      number

Giá trị trả về

  • Hứa hẹn<number>

    Chrome 91 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

registerService()

Cam kết Chrome 52 trở lên 
chrome.bluetoothLowEnergy.registerService(
  serviceId: string,
  callback?: function,
)

Đăng ký dịch vụ đã cho với máy chủ GATT cục bộ. Nếu mã dịch vụ không hợp lệ, giá trị lastError sẽ được đặt. Chức năng này chỉ dùng được nếu ứng dụng có cả quyền bluetooth:low_energy và bluetooth:thiết bị ngoại vi được đặt thành true. Một số ứng dụng có thể không dùng được quyền truy cập vào thiết bị ngoại vi.

Tham số

  • serviceId

    string

    Mã nhận dạng duy nhất của một dịch vụ đã tạo.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    ()=>void

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

removeService()

Cam kết Chrome 52 trở lên 
chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
)

Xoá dịch vụ đã chỉ định, huỷ đăng ký nếu dịch vụ đã được đăng ký. Nếu mã dịch vụ không hợp lệ, giá trị lastError sẽ được đặt. Chức năng này chỉ dùng được nếu ứng dụng có cả quyền bluetooth:low_energy và bluetooth:thiết bị ngoại vi được đặt thành true. Một số ứng dụng có thể không dùng được quyền truy cập vào thiết bị ngoại vi.

Tham số

  • serviceId

    string

    Mã nhận dạng duy nhất của dịch vụ hiện đã đăng ký.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    ()=>void

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

resetAdvertising()

Cam kết Chrome 61 trở lên 
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
)

Đặt lại quảng cáo trên thiết bị hiện tại. Thao tác này sẽ huỷ đăng ký và ngừng tất cả quảng cáo hiện có.

Tham số

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    ()=>void

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

sendRequestResponse()

Chrome 52 trở lên 
chrome.bluetoothLowEnergy.sendRequestResponse(
  response: Response,
)

Gửi phản hồi cho một yêu cầu đọc/ghi đặc điểm hoặc phần mô tả. Chức năng này chỉ dùng được nếu ứng dụng có cả quyền bluetooth:low_energy và bluetooth:thiết bị ngoại vi được đặt thành true. Một số ứng dụng có thể không dùng được quyền truy cập vào thiết bị ngoại vi.

Tham số

  • phản hồi

    Đáp

    Phản hồi cho yêu cầu.

setAdvertisingInterval()

Cam kết Chrome 55 trở lên 
chrome.bluetoothLowEnergy.setAdvertisingInterval(
  minInterval: number,
  maxInterval: number,
  callback?: function,
)

Đặt là khoảng thời gian giữa hai quảng cáo liên tiếp. Lưu ý: Đây là cách tốt nhất. Khoảng thời gian thực tế có thể thay đổi không đáng kể so với các khoảng thời gian được yêu cầu. Một số phần cứng sẽ có một khoảng thời gian tối thiểu là 100 mili giây. Giá trị tối thiểu và tối đa không được vượt quá phạm vi được phép theo thông số kỹ thuật của Bluetooth 4.2.

Tham số

  • minInterval

    number

    Khoảng thời gian tối thiểu giữa các quảng cáo (tính bằng mili giây). Thời gian này không được thấp hơn 20 mili giây (theo thông số kỹ thuật).

  • maxInterval

    number

    Khoảng thời gian tối đa giữa các quảng cáo (tính bằng mili giây). Thời gian này không được vượt quá 10240 mili giây (theo thông số kỹ thuật).

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    ()=>void

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

startCharacteristicNotifications()

Cam kết 
chrome.bluetoothLowEnergy.startCharacteristicNotifications(
  characteristicId: string,
  properties?: NotificationProperties,
  callback?: function,
)

Bật thông báo/chỉ báo giá trị từ đặc điểm đã chỉ định. Sau khi bạn bật, một ứng dụng có thể theo dõi thông báo bằng sự kiện onCharacteristicValueChanged.

Tham số

  • characteristicId

    string

    Mã thực thể của đặc điểm GATT mà thông báo phải được bật.

  • các tài sản

    Không bắt buộc NotificationProperties

    Thuộc tính phiên thông báo (không bắt buộc).

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    ()=>void

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

stopCharacteristicNotifications()

Cam kết 
chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
  characteristicId: string,
  callback?: function,
)

Tắt thông báo/chỉ báo giá trị từ đặc điểm đã chỉ định. Sau khi bạn gọi thành công, ứng dụng sẽ ngừng nhận thông báo/chỉ báo từ đặc điểm này.

Tham số

  • characteristicId

    string

    Mã thực thể của đặc điểm GATT mà phiên thông báo của ứng dụng này sẽ bị dừng.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    ()=>void

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

unregisterAdvertisement()

Cam kết Chrome 47 trở lên 
chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
)

Huỷ đăng ký quảng cáo và ngừng quảng cáo. Nếu quảng cáo không thể huỷ đăng ký, cách duy nhất để ngừng quảng cáo có thể là khởi động lại thiết bị.

Tham số

  • advertisementId

    number

    Mã của quảng cáo cần huỷ đăng ký.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    ()=>void

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

unregisterService()

Cam kết Chrome 52 trở lên 
chrome.bluetoothLowEnergy.unregisterService(
  serviceId: string,
  callback?: function,
)

Huỷ đăng ký dịch vụ đã cho với máy chủ GATT cục bộ. Nếu mã dịch vụ không hợp lệ, giá trị lastError sẽ được đặt. Chức năng này chỉ dùng được nếu ứng dụng có cả quyền bluetooth:low_energy và bluetooth:thiết bị ngoại vi được đặt thành true. Một số ứng dụng có thể không dùng được quyền truy cập vào thiết bị ngoại vi.

Tham số

  • serviceId

    string

    Mã nhận dạng duy nhất của dịch vụ hiện đã đăng ký.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    ()=>void

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

writeCharacteristicValue()

Cam kết 
chrome.bluetoothLowEnergy.writeCharacteristicValue(
  characteristicId: string,
  value: ArrayBuffer,
  callback?: function,
)

Ghi giá trị của một đặc điểm được chỉ định từ một thiết bị ngoại vi từ xa.

Tham số

  • characteristicId

    string

    Mã thực thể của đặc điểm GATT có giá trị được ghi vào.

  • value

    ArrayBuffer

    Giá trị cần được gửi tới đặc tính từ xa trong yêu cầu ghi.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    ()=>void

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

writeDescriptorValue()

Cam kết 
chrome.bluetoothLowEnergy.writeDescriptorValue(
  descriptorId: string,
  value: ArrayBuffer,
  callback?: function,
)

Ghi giá trị của một mã mô tả đặc điểm đã chỉ định từ một thiết bị ngoại vi từ xa.

Tham số

  • descriptorId

    string

    Mã thực thể của mã mô tả đặc điểm GATT mà bạn phải ghi giá trị vào.

  • value

    ArrayBuffer

    Giá trị phải được gửi đến mô tả từ xa trong yêu cầu ghi.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    ()=>void

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

Sự kiện

onCharacteristicReadRequest

Chrome 52 trở lên 
chrome.bluetoothLowEnergy.onCharacteristicReadRequest.addListener(
  callback: function,
)

Được kích hoạt khi một thiết bị trung tâm đã kết nối yêu cầu đọc giá trị của một đặc điểm đã đăng ký trên máy chủ GATT cục bộ. Nếu bạn không phản hồi yêu cầu này trong thời gian dài, thì tài khoản có thể bị ngắt kết nối. Sự kiện này chỉ dùng được nếu ứng dụng có cả quyền bluetooth:low_energy và bluetooth:thiết bị ngoại vi được đặt thành true. Một số ứng dụng có thể không dùng được quyền truy cập vào thiết bị ngoại vi.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau: 

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

onCharacteristicValueChanged

chrome.bluetoothLowEnergy.onCharacteristicValueChanged.addListener(
  callback: function,
)

Được kích hoạt khi giá trị của đặc tính GATT từ xa thay đổi, do có sự thay đổi của yêu cầu đọc hoặc thông báo/chỉ báo thay đổi giá trị. Sự kiện này chỉ được gửi nếu ứng dụng đã bật thông báo bằng cách gọi startCharacteristicNotifications.

Tham số

onCharacteristicWriteRequest

Chrome 52 trở lên 
chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
  callback: function,
)

Được kích hoạt khi một thiết bị trung tâm đã kết nối yêu cầu ghi giá trị của một đặc điểm đã đăng ký trên máy chủ GATT cục bộ. Nếu bạn không phản hồi yêu cầu này trong thời gian dài, thì tài khoản có thể bị ngắt kết nối. Sự kiện này chỉ dùng được nếu ứng dụng có cả quyền bluetooth:low_energy và bluetooth:thiết bị ngoại vi được đặt thành true. Một số ứng dụng có thể không dùng được quyền truy cập vào thiết bị ngoại vi.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau: 

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

onDescriptorReadRequest

Chrome 52 trở lên 
chrome.bluetoothLowEnergy.onDescriptorReadRequest.addListener(
  callback: function,
)

Được kích hoạt khi một thiết bị trung tâm đã kết nối yêu cầu đọc giá trị của bộ mô tả đã đăng ký trên máy chủ GATT cục bộ. Nếu bạn không phản hồi yêu cầu này trong thời gian dài, thì tài khoản có thể bị ngắt kết nối. Sự kiện này chỉ dùng được nếu ứng dụng có cả quyền bluetooth:low_energy và bluetooth:thiết bị ngoại vi được đặt thành true. Một số ứng dụng có thể không dùng được quyền truy cập vào thiết bị ngoại vi.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau: 

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

onDescriptorValueChanged

chrome.bluetoothLowEnergy.onDescriptorValueChanged.addListener(
  callback: function,
)

Được kích hoạt khi giá trị của mã mô tả đặc tính GATT từ xa thay đổi, thường là do yêu cầu đọc. Sự kiện này chủ yếu tồn tại để thuận tiện và luôn được gửi sau khi bạn thực hiện lệnh gọi thành công đến readDescriptorValue.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau: 

    (descriptor: Descriptor)=>void

onDescriptorWriteRequest

Chrome 52 trở lên 
chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
  callback: function,
)

Được kích hoạt khi một thiết bị trung tâm đã kết nối yêu cầu ghi giá trị của bộ mô tả đã đăng ký trên máy chủ GATT cục bộ. Nếu bạn không phản hồi yêu cầu này trong thời gian dài, thì tài khoản có thể bị ngắt kết nối. Sự kiện này chỉ dùng được nếu ứng dụng có cả quyền bluetooth:low_energy và bluetooth:thiết bị ngoại vi được đặt thành true. Một số ứng dụng có thể không dùng được quyền truy cập vào thiết bị ngoại vi.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau: 

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

onServiceAdded

chrome.bluetoothLowEnergy.onServiceAdded.addListener(
  callback: function,
)

Đã phát hiện thấy một dịch vụ GATT mới trên một thiết bị từ xa bị kích hoạt.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau: 

    (service: Service)=>void

onServiceChanged

chrome.bluetoothLowEnergy.onServiceChanged.addListener(
  callback: function,
)

Được kích hoạt khi trạng thái của dịch vụ GATT từ xa thay đổi. Điều này liên quan đến bất kỳ đặc điểm và/hoặc mã mô tả nào được thêm vào hoặc bị xóa khỏi dịch vụ cũng như thông báo "ServiceChanged" từ thiết bị từ xa.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau: 

    (service: Service)=>void

onServiceRemoved

chrome.bluetoothLowEnergy.onServiceRemoved.addListener(
  callback: function,
)

Được kích hoạt khi một dịch vụ GATT trước đó được phát hiện trên thiết bị từ xa đã bị xoá.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau: 

    (service: Service)=>void