chrome.bluetoothLowEnergy

Mô tả

API chrome.bluetoothLowEnergy 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 "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ụ sẽ được đưa vào "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 thêm vào "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 thêm vào "Mã nhận dạng duy nhất (UUID) mục đích yêu cầu" 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 là "phát sóng" được chọn, loại quảng cáo đã gửi sẽ là ADV_NONCONN_IND và thiết bị sẽ phát đi với một Địa chỉ MAC ngẫu nhiên. Nếu bạn đặt chính sách này thành "ngoại vi", thì loại quảng cáo sẽ là ADV_IND hoặc ADV_SCAN_IND và thiết bị sẽ phát đi thông báo bằng Địa chỉ MAC của Bộ điều hợp Bluetooth thực.

Enum

"phát sóng"

"thiết bị ngoại vi"

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ã nhận dạng thực thể để phân biệt các đặc điểm của 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 giá trị nhận dạng đặc điểm. Hiển thị, nếu bản sao này đại diện cho một đặc điểm từ xa.

  • các tài sản

    CharacteristicProperty[]

    Các thuộc tính của đặc điểm này.

  • dịch vụ

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

    Đặc điểm này thuộc về dịch vụ của GATT.

  • uuid

    string

    Mã nhận dạng duy nhất (UUID) của đặc điểm, ví dụ: 00002a37-0000-1000-8000-00805f9b34fb.

  • value

    ArrayBuffer không bắt buộc

    Giá trị đặc điểm hiện đang đượ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 theo đặc điểm được suy ra từ những thuộc tính này. Vui lòng xem thông số Bluetooth 4.x để biết ý nghĩa của từng thuộc tính riêng lẻ.

Enum

"phát sóng"

"đọc"

"writeNoResponse"

"viết"

"thông báo"

"cho biết"

"authenticationdSignedWrites"

"ExtendedProperties"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptVerifydRead"

"encryptAuthenticatedWrite"

ConnectProperties

Thuộc tính

  • liên tục

    boolean

    Cờ cho biết liệu 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 tính không bắt buộc

    Đặc điểm của GATT thuộc về mô tả này.

  • instanceId

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

    Trả về giá trị nhận dạng được gán cho chỉ số mô tả này. Sử dụng mã thực thể để phân biệt giữa các mã mô tả của 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 giá trị nhận dạng của mã mô tả. Hiển thị, nếu bản sao 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

    Mã nhận dạng duy nhất (UUID) của bộ mô tả đặc điểm, ví dụ: 00002902-0000-1000-8000-00805f9b34fb.

  • value

    ArrayBuffer không bắt buộc

    Giá trị 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 phần mô tả được đọc.

DescriptorPermission

Chrome 52 trở lên

Giá trị đại diện cho các quyền có thể có cho một mã mô tả. Vui lòng xem thông số Bluetooth 4.x để biết ý nghĩa của từng quyền riêng lẻ.

Enum

"đọc"

"viết"

"encryptedRead"

"encryptedWrite"

"EncryptdRead"

"encryptedVerifydWrite"

Device

Chrome 52 trở lên

Thuộc tính

  • xử lý

    string

    Địa chỉ của thiết bị có đị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/assigned-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

  • dữ liệu

    số[]

  • id

    số

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 một chỉ báo thay vì thông báo.

  • value

    ArrayBuffer

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

NotificationProperties

Thuộc tính

  • liên tục

    boolean

    Cờ cho biết liệu ứng dụng có nên nhận 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 ứ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

    số

    Mã nhận dạng duy nhất cho yêu cầu này. Sử dụng mã nhận dạng 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ì giá trị này phải đúng.

  • requestId

    số

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

  • value

    ArrayBuffer không bắt buộc

    Giá trị phản hồi. Việc ghi các yêu cầu 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. Trình bày, nếu thực thể 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 gán cho dịch vụ này. Sử dụng mã nhận dạng thực thể để phân biệt các dịch vụ từ một thiết bị ngoại vi có cùng UUID và để thực hiện các lệnh gọi hàm lấy giá trị nhận dạng dịch vụ. Trình bày, nếu thực thể này đại diện cho một dịch vụ từ xa.

  • là chính

    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

  • dữ liệu

    số[]

  • uuid

    string

Phương thức

connect()

Lời hứa 
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ị đó 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 một thiết bị phải gọi hàm này để đảm bảo rằng kết nối với thiết bị vẫn được duy trì. 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 bạn gọi thành công đến connect.

Tham số

  • deviceAddress

    string

    Địa chỉ Bluetooth của thiết bị từ xa mà bạn sẽ 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ề

  • Lời hứa<vô hiệu>

    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()

Lời hứa Chrome 52 trở lên 
chrome.bluetoothLowEnergy.createCharacteristic(
  characteristic: Characteristic,
  serviceId: string,
  callback?: function,
)

Tạo một đặ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ệ, thì lỗi 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:ngoại vi được đặt thành true. Một số ứng dụng có thể khô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 tạo.

  • mã dịch vụ

    string

    Mã nhận dạng của dịch vụ để 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ề

  • Cam kết<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()

Lời hứa Chrome 52 trở lên 
chrome.bluetoothLowEnergy.createDescriptor(
  descriptor: Descriptor,
  characteristicId: string,
  callback?: function,
)

Tạo mã mô tả GATT được lưu trữ cục bộ. Chỉ số mô tả này phải được lưu trữ trong một đặc điểm hợp lệ. Nếu mã đặc điểm không hợp lệ, hàm 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:ngoại vi được đặt thành true. Một số ứng dụng có thể khô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ả

    Mã mô tả cần tạo.

  • characteristicId

    string

    Mã nhận dạng của đặc điểm để tạo 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ề

  • Cam kết<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()

Lời hứa Chrome 52 trở lên 
chrome.bluetoothLowEnergy.createService(
  service: Service,
  callback?: function,
)

Tạo một dịch vụ GATT được lưu trữ cục bộ. Dịch vụ này có thể được đăng ký để hoạt độ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:ngoại vi được đặt thành true. Một số ứng dụng có thể khô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

    • mã dịch vụ

      string

Giá trị trả về

  • Cam kết<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()

Lời hứa 
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. 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 thực, do có thể có những ứng dụng khác có kết nối 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ề

  • Lời hứa<vô hiệu>

    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()

Lời hứa 
chrome.bluetoothLowEnergy.getCharacteristic(
  characteristicId: string,
  callback?: function,
)

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

Tham số

  • characteristicId

    string

    Mã thực thể của đặ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: Characteristic) => void

Giá trị trả về

  • Cam kết<Đặc điểm>

    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()

Lời hứa 
chrome.bluetoothLowEnergy.getCharacteristics(
  serviceId: string,
  callback?: function,
)

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

Tham số

  • mã dịch vụ

    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ề

  • Cam kết<Đặc điểm[]>

    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()

Lời hứa 
chrome.bluetoothLowEnergy.getDescriptor(
  descriptorId: string,
  callback?: function,
)

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

Tham số

  • descriptorId

    string

    Mã thực thể của bộ 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&lt;Descriptor&gt;

    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()

Lời hứa 
chrome.bluetoothLowEnergy.getDescriptors(
  characteristicId: string,
  callback?: function,
)

Lấy danh sách các bộ 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ó phần mô tả 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: Descriptor[]) => void

Giá trị trả về

  • Promise&lt;Descriptor[]&gt;

    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()

Lời hứa 
chrome.bluetoothLowEnergy.getIncludedServices(
  serviceId: string,
  callback?: function,
)

Nhận danh sách các dịch vụ GATT đi kèm với dịch vụ cụ thể.

Tham số

  • mã dịch vụ

    string

    Mã thực thể của dịch vụ GATT có các dịch vụ đi kè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: 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()

Lời hứa 
chrome.bluetoothLowEnergy.getService(
  serviceId: string,
  callback?: function,
)

Nhận dịch vụ GATT bằng mã thực thể đã cho.

Tham số

  • mã dịch vụ

    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ề

  • Promise&lt;Service&gt;

    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()

Lời hứa 
chrome.bluetoothLowEnergy.getServices(
  deviceAddress: string,
  callback?: function,
)

Sử dụng tất cả các dịch vụ GATT phát hiện được trên thiết bị từ xa bằng địa chỉ thiết bị đã cho.

Lưu ý: Nếu quá trình khám phá dịch vụ chưa hoàn tất trên thiết bị, thì API này sẽ trả về một nhóm nhỏ dịch vụ (có thể là 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 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: 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()

Lời hứa 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 của một đặc điểm. Nếu cờ shouldIndicate 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 ý: đặc điểm này cần đặt chính xác tính năng "thông báo" hoặc "cho biết" trong quá trình tạo để lệnh 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:ngoại vi được đặt thành true. Một số ứng dụng có thể không có quyền truy cập vào thiết bị ngoại vi.

Tham số

  • characteristicId

    string

    Đặc điểm để gửi ký hiệu.

  • thông báo

    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ề

  • Lời hứa<vô hiệu>

    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()

Lời hứa 
chrome.bluetoothLowEnergy.readCharacteristicValue(
  characteristicId: string,
  callback?: function,
)

Truy xuất giá trị của một đặc tính đã chỉ định 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ần đượ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ề

  • Cam kết<Đặc điểm>

    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()

Lời hứa 
chrome.bluetoothLowEnergy.readDescriptorValue(
  descriptorId: string,
  callback?: function,
)

Truy xuất giá trị của một bộ 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 bộ mô tả đặc điểm GATT có giá trị phải được đọc từ 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&lt;Descriptor&gt;

    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()

Lời hứa Chrome 47 trở lên 
chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
)

Tạo quảng cáo và đăng ký quảng cáo. Để gọi hàm này, ứng dụng phải đặt quyền bluetooth:low_energy và bluetooth:thiết bị 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 "--enable-ble-advertising-in-apps" chuyển đổi dòng lệnh. Xem https://developer.chrome.com/apps/manifest/bluetooth Lưu ý: Hệ thống sẽ đồng thời hỗ trợ một số chế độ phần cứng, chế độ trung tâm và thiết bị ngoại vi. Tuy nhiên, trên phần cứng không hỗ trợ chế độ này, thao tác thực hiện lệnh gọi này sẽ chuyển thiết bị sang chế độ ngoại vi. Trong trường hợp phần cứng không hỗ trợ cả chế độ trung tâm và 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 các 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

      số

Giá trị trả về

  • Promise&lt;number&gt;

    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()

Lời hứa Chrome 52 trở lên 
chrome.bluetoothLowEnergy.registerService(
  serviceId: string,
  callback?: function,
)

Đăng ký dịch vụ có sẵn với máy chủ GATT cục bộ. Nếu mã dịch vụ không hợp lệ, thì lỗi 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:ngoại vi được đặt thành true. Một số ứng dụng có thể không có quyền truy cập vào thiết bị ngoại vi.

Tham số

  • mã dịch vụ

    string

    Mã nhận dạng duy nhất của một dịch vụ được 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ề

  • Lời hứa<vô hiệu>

    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()

Lời hứa Chrome 52 trở lên 
chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
)

Xóa dịch vụ được chỉ định, hủy đăng ký dịch vụ nếu đã được đăng ký. Nếu mã dịch vụ không hợp lệ, thì lỗi 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:ngoại vi được đặt thành true. Một số ứng dụng có thể không có quyền truy cập vào thiết bị ngoại vi.

Tham số

  • mã dịch vụ

    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ề

  • Lời hứa<vô hiệu>

    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()

Lời hứa 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ả cá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ề

  • Lời hứa<vô hiệu>

    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ủa một đặc điểm hoặc bộ 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:ngoại vi được đặt thành true. Một số ứng dụng có thể khô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()

Lời hứa Chrome 55 trở lên 
chrome.bluetoothLowEnergy.setAdvertisingInterval(
  minInterval: number,
  maxInterval: number,
  callback?: function,
)

Đặt 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ể khác một chút so với các khoảng thời gian được yêu cầu. Trên một số phần cứng, 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 cho phép theo thông số kỹ thuật Bluetooth 4.2.

Tham số

  • minInterval

    số

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

  • maxInterval

    số

    Khoảng thời gian tối đa giữa các lần hiển thị quảng cáo (tính bằng mili giây). Tốc độ 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ề

  • Lời hứa<vô hiệu>

    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()

Lời hứa 
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 được bật, ứng dụng có thể nghe 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à bạn phải bật thông báo.

  • các tài sản

    NotificationProperties không bắt buộc

    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ề

  • Lời hứa<vô hiệu>

    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()

Lời hứa 
chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
  characteristicId: string,
  callback?: function,
)

Tắt các thông báo/chỉ báo giá trị từ đặc điểm đã chỉ định. Sau khi cuộc 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 tính 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ề

  • Lời hứa<vô hiệu>

    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()

Lời hứa Chrome 47 trở lên 
chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
)

Huỷ đăng ký một quảng cáo và dừng quảng cáo của quảng cáo đó. Nếu quảng cáo không thể huỷ đăng ký thì 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

    số

    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ề

  • Lời hứa<vô hiệu>

    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()

Lời hứa 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ệ, thì lỗi 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:ngoại vi được đặt thành true. Một số ứng dụng có thể không có quyền truy cập vào thiết bị ngoại vi.

Tham số

  • mã dịch vụ

    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ề

  • Lời hứa<vô hiệu>

    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()

Lời hứa 
chrome.bluetoothLowEnergy.writeCharacteristicValue(
  characteristicId: string,
  value: ArrayBuffer,
  callback?: function,
)

Viết giá trị của một đặc điểm đã 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ần được ghi vào.

  • value

    ArrayBuffer

    Giá trị phải được gửi đến đặc điểm 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ề

  • Lời hứa<vô hiệu>

    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()

Lời hứa 
chrome.bluetoothLowEnergy.writeDescriptorValue(
  descriptorId: string,
  value: ArrayBuffer,
  callback?: function,
)

Viết giá trị của một bộ 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 bộ mô tả đặc điểm GATT có giá trị phải được ghi vào.

  • value

    ArrayBuffer

    Giá trị phải được gửi đến bộ mô tả từ xa như một phần của 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ề

  • Lời hứa<vô hiệu>

    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 được 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ộ. Việc không phản hồi yêu cầu này trong một thời gian dài có thể khiến bạn 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:ngoại vi được đặt thành true. Một số ứng dụng có thể khô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 một đặc tính GATT từ xa thay đổi theo yêu cầu đọc hoặc do thông báo/chỉ báo thay đổi giá trị. Sự kiện này sẽ chỉ được gửi nếu ứng dụng đã bật thông báo bằng cách gọi startCharacteristicNotifications.

Tham số

  • số gọi lại

    hàm

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

    (characteristic: Characteristic) => void

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 được 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ộ. Việc không phản hồi yêu cầu này trong một thời gian dài có thể khiến bạn 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:ngoại vi được đặt thành true. Một số ứng dụng có thể khô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 được kết nối yêu cầu đọc giá trị của một chỉ số mô tả đã đăng ký trên máy chủ GATT cục bộ. Việc không phản hồi yêu cầu này trong một thời gian dài có thể khiến bạn 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:ngoại vi được đặt thành true. Một số ứng dụng có thể khô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 bộ mô tả đặc điểm 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à sẽ luôn được gửi sau khi lệnh gọi readDescriptorValue thành công.

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 được kết nối yêu cầu ghi giá trị của một chỉ số mô tả đã đăng ký trên máy chủ GATT cục bộ. Việc không phản hồi yêu cầu này trong một thời gian dài có thể khiến bạn 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:ngoại vi được đặt thành true. Một số ứng dụng có thể khô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,
)

Đã kích hoạt một dịch vụ GATT mới trên mộ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

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 mọi đặc điểm và/hoặc mã mô tả được thêm vào hoặc bị xoá khỏi dịch vụ, cũng như "ServiceChanged" thông báo 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 dịch vụ GATT từng được phát hiện trên một 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