chrome.bluetoothLowEnergy

Mô tả

API chrome.bluetoothLowEnergy được dùng để giao tiếp với các thiết bị Bluetooth Smart (Năng lượng thấp) bằng Hồ sơ 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 dành riêng cho nhà sản xuất cần được đưa vào các trường "Dữ liệu dành riêng cho 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 các 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 UUID cần đưa vào trường "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 bit.

  • solicitUuids

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

    Danh sách UUID cần đưa vào trường "Solicit UUIDs" (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 bit.

  • Loại quảng cáo.

AdvertisementType

Chrome 47 trở lên

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

Enum

"broadcast"

"peripheral"

Characteristic

Thuộc tính

  • instanceId

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

    Trả về giá trị nhận dạng được chỉ định cho đặc điểm này. Sử dụng mã nhận dạng phiên bản để phân biệt các đặc điểm của 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 nhận vào một mã nhận dạng đặc điểm. Hiện tại, nếu phiên bản này đại diện cho một đặc điểm từ xa.

  • 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

    Dịch vụ GATT mà đặc điểm này thuộc về.

  • uuid

    chuỗi

    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 được lưu vào bộ nhớ đệm. Giá trị này sẽ được cập nhật khi giá trị của đặc điểm được đọc hoặc cập nhật thông qua thông báo hoặc chỉ báo.

CharacteristicProperty

Các giá trị đại diện cho các thuộc tính có thể có của một đặc điểm. Các quyền đặc điểm được suy luận từ những thuộc tính này. Vui lòng xem quy cách Bluetooth 4.x để biết ý nghĩa của từng thuộc tính riêng lẻ.

Enum

"broadcast"

"read"

"writeWithoutResponse"

"write"

"notify"

"indicate"

"authenticatedSignedWrites"

"extendedProperties"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

Thuộc tính

  • liên tục

    boolean

    Cờ cho biết liệu một kết nối với thiết bị có bị bỏ ngỏ khi trang sự kiện của ứng dụng được 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.

Descriptor

Thuộc tính

  • đặc điểm

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

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

  • instanceId

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

    Trả về giá trị nhận dạng được chỉ định cho bộ mô tả này. Sử dụng mã nhận dạng phiên bản để phân biệt các giá trị mô tả 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 mã nhận dạng giá trị mô tả. Hiện tại, 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 bộ mô tả này.

  • uuid

    chuỗi

    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 sẽ được cập nhật khi giá trị của bộ mô tả được đọc.

DescriptorPermission

Chrome 52 trở lên

Các giá trị biểu thị những quyền có thể có đối với một giá trị nhận dạng. Vui lòng xem quy cách Bluetooth 4.x để biết ý nghĩa của từng quyền riêng lẻ.

Enum

"read"

"write"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome 52 trở lên

Thuộc tính

  • xử lý

    chuỗi

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

  • deviceClass

    number không bắt buộc

    Lớp của thiết bị, một trường bit do http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband xác định.

  • tên

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

    Tên dễ đọc của thiết bị.

ManufacturerData

Chrome 47 trở lên

Thuộc tính

  • khác

    number[]

  • 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ì một 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ó nhận được thông báo khi trang sự kiện của ứng dụng được 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. Hã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 là true.

  • requestId

    số

    Mã nhận dạng 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. Các yêu cầu ghi và phản hồi lỗi sẽ bỏ qua tham 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 mà dịch vụ GATT thuộc về. Hiện tại, 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ã nhận dạng phiên bản để 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 nhận một giá trị nhận dạng dịch vụ. Hiện tại, nếu phiên bản này đại diện cho một dịch vụ từ xa.

  • isPrimary

    boolean

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

  • uuid

    chuỗi

    UUID của dịch vụ, ví dụ: 0000180d-0000-1000-8000-00805f9b34fb.

ServiceData

Chrome 47 trở lên

Thuộc tính

  • khác

    number[]

  • uuid

    chuỗi

Phương thức

connect()

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

Thiết lập kết nối giữa ứng dụng và thiết bị có địa chỉ đã cho. Một thiết bị có thể đã kết nối và các dịch vụ GATT của thiết bị đó có sẵn 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ị nên gọi hàm này để đảm bảo rằng kết nối với thiết bị được duy trì. Nếu thiết bị không kết nối, tất cả các dịch vụ GATT của thiết bị sẽ được phát hiện sau khi gọi thành công đến connect.

Thông số

  • deviceAddress

    chuỗi

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

  • 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).

  • callback

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

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

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên

    Các promise 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()

Promise Chrome 52 trở lên 
chrome.bluetoothLowEnergy.createCharacteristic(
  characteristic: Characteristic,
  serviceId: string,
  callback?: function,
): Promise<string>

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ệ, lastError sẽ được đặt. Chức năng này chỉ hoạt động nếu ứng dụng có cả quyền bluetooth:low_energy và bluetooth:peripheral được đặt thành true. Không phải ứng dụng nào cũng có quyền truy cập vào thiết bị ngoại vi.

Thông số

  • đặc điểm

    Đặc điểm

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

  • serviceId

    chuỗi

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

  • callback

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

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

    (characteristicId: string) => void

    • characteristicId

      chuỗi

Giá trị trả về

  • Promise<string>

    Chrome 91 trở lên

    Các promise 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()

Promise Chrome 52 trở lên 
chrome.bluetoothLowEnergy.createDescriptor(
  descriptor: Descriptor,
  characteristicId: string,
  callback?: function,
): Promise<string>

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

Thông số

  • bộ mô tả

    Descriptor

    Bộ mô tả cần tạo.

  • characteristicId

    chuỗi

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

  • callback

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

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

    (descriptorId: string) => void

    • descriptorId

      chuỗi

Giá trị trả về

  • Promise<string>

    Chrome 91 trở lên

    Các promise 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()

Promise Chrome 52 trở lên 
chrome.bluetoothLowEnergy.createService(
  service: Service,
  callback?: function,
): Promise<string>

Tạo một 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ỉ hoạt động nếu ứng dụng có cả quyền bluetooth:low_energy và bluetooth:peripheral được đặt thành true. Không phải ứng dụng nào cũng có quyền truy cập vào thiết bị ngoại vi.

Thông số

  • dịch vụ

    Dịch vụ

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

  • callback

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

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

    (serviceId: string) => void

    • serviceId

      chuỗi

Giá trị trả về

  • Promise<string>

    Chrome 91 trở lên

    Các promise 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()

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

Đó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ỷ chính đường liên kết thực tế, vì có thể có các ứng dụng khác có kết nối đang mở.

Thông số

  • deviceAddress

    chuỗi

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

  • callback

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

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

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên

    Các promise 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()

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

Nhận đặc điểm GATT có mã nhận dạng phiên bản đã cho thuộc dịch vụ GATT đã cho, nếu đặc điểm đó tồn tại.

Thông số

  • characteristicId

    chuỗi

    Mã nhận dạng phiên bản của đặc điểm GATT được yêu cầu.

  • callback

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

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

    (result: Characteristic) => void

Giá trị trả về

  • Promise<Characteristic>

    Chrome 91 trở lên

    Các promise 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()

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

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

Thông số

  • serviceId

    chuỗi

    Mã nhận dạng phiên bản của dịch vụ GATT mà các đặc điểm cần được trả về.

  • callback

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

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

    (result: Characteristic[]) => void

Giá trị trả về

  • Promise<Characteristic[]>

    Chrome 91 trở lên

    Các promise 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()

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

Nhận bộ mô tả đặc điểm GATT có mã nhận dạng phiên bản đã cho.

Thông số

  • descriptorId

    chuỗi

    Mã nhận dạng phiên bản của giá trị mô tả đặc điểm GATT được yêu cầu.

  • callback

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

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

    (result: Descriptor) => void

Giá trị trả về

  • Promise<Descriptor>

    Chrome 91 trở lên

    Các promise 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()

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

Lấy danh sách các giá trị mô tả đặc điểm GATT thuộc về đặc điểm đã cho.

Thông số

  • characteristicId

    chuỗi

    Mã nhận dạng phiên bản của đặc điểm GATT mà các giá trị mô tả sẽ được trả về.

  • callback

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

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

    (result: Descriptor[]) => void

Giá trị trả về

  • Promise<Descriptor[]>

    Chrome 91 trở lên

    Các promise 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()

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

Lấy danh sách các dịch vụ GATT có trong dịch vụ đã cho.

Thông số

  • serviceId

    chuỗi

    Mã nhận dạng phiên bản của dịch vụ GATT mà các dịch vụ đi kèm sẽ được trả về.

  • callback

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

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

    (result: Service[]) => void

Giá trị trả về

  • Promise<Service[]>

    Chrome 91 trở lên

    Các promise 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()

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

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

Thông số

  • serviceId

    chuỗi

    Mã nhận dạng phiên bản của dịch vụ GATT được yêu cầu.

  • callback

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

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

    (result: Service) => void

Giá trị trả về

  • Promise<Service>

    Chrome 91 trở lên

    Các promise 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()

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

Nhận tất cả các dịch vụ GATT đã được phát hiện trên thiết bị từ xa có đị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ị, API này sẽ trả về một nhóm nhỏ (có thể trống) các dịch vụ. Cách khắc phục là thêm độ trễ dựa trên thời gian và/hoặc gọi nhiều lần cho đến khi trả về số lượng dịch vụ dự kiến.

Thông số

  • deviceAddress

    chuỗi

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

  • callback

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

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

    (result: Service[]) => void

Giá trị trả về

  • Promise<Service[]>

    Chrome 91 trở lên

    Các promise 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()

Promise Chrome 52 trở lên 
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
  characteristicId: string,
  notification: Notification,
  callback?: function,
): Promise<void>

Thông báo cho một thiết bị từ xa về 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. Xin lưu ý rằng đặc điểm cần thiết lập chính xác thuộc tính "notify" (thông báo) hoặc "indicate" (chỉ báo) trong quá trình tạo để lệnh gọi này thành công. Chức năng này chỉ hoạt động nếu ứng dụng có cả quyền bluetooth:low_energy và bluetooth:peripheral được đặt thành true. Không phải ứng dụng nào cũng có quyền truy cập vào thiết bị ngoại vi.

Thông số

  • characteristicId

    chuỗi

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

  • thông báo

    Thông báo

  • callback

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

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

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên

    Các promise 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()

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

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

Thông số

  • characteristicId

    chuỗi

    Mã nhận dạng phiên bản của đặc điểm GATT có giá trị cần được đọc từ thiết bị từ xa.

  • callback

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

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

    (result: Characteristic) => void

Giá trị trả về

  • Promise<Characteristic>

    Chrome 91 trở lên

    Các promise 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()

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

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.

Thông số

  • descriptorId

    chuỗi

    Mã nhận dạng phiên bản của bộ mô tả đặc điểm GATT có giá trị cần được đọc từ thiết bị từ xa.

  • callback

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

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

    (result: Descriptor) => void

Giá trị trả về

  • Promise<Descriptor>

    Chrome 91 trở lên

    Các promise 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()

Promise Chrome 47 trở lên 
chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
): Promise<number>

Tạo một quảng cáo và đăng ký quảng cáo đó. Để gọi hàm này, ứng dụng phải có quyền bluetooth:low_energy và bluetooth:peripheral được đặt thành true. Ngoài ra, API này chỉ dành cho các ứng dụng tự động chạy ở Chế độ Kiosk hoặc bằng cách đặt công tắc dòng lệnh "--enable-ble-advertising-in-apps". Xem tại https://developer.chrome.com/apps/manifest/bluetooth Lưu ý: Một số phần cứng hỗ trợ cả chế độ trung tâm và chế độ thiết bị ngoại vi cùng lúc, nhưng trên phần cứng không hỗ trợ chế độ này, việc thực hiện lệnh 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à chế độ 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 khác có vai trò trung tâm hoạt động đúng cách (bao gồm cả việc phát hiện các thiết bị Bluetooth năng lượng thấp).

Thông số

  • quảng cáo

    Quảng cáo

    Quảng cáo cần quảng cáo.

  • callback

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

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

    (advertisementId: number) => void

    • advertisementId

      số

Giá trị trả về

  • Promise<number>

    Chrome 91 trở lên

    Các promise 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()

Promise Chrome 52 trở lên 
chrome.bluetoothLowEnergy.registerService(
  serviceId: string,
  callback?: function,
): Promise<void>

Đă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ệ, lastError sẽ được đặt. Chức năng này chỉ hoạt động nếu ứng dụng có cả quyền bluetooth:low_energy và bluetooth:peripheral được đặt thành true. Không phải ứng dụng nào cũng có quyền truy cập vào thiết bị ngoại vi.

Thông số

  • serviceId

    chuỗi

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

  • callback

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

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

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên

    Các promise 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()

Promise Chrome 52 trở lên 
chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
): Promise<void>

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

Thông số

  • serviceId

    chuỗi

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

  • callback

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

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

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên

    Các promise 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()

Promise Chrome 61 trở lên 
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
): Promise<void>

Đặ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à dừng tất cả quảng cáo hiện có.

Thông số

  • callback

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

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

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên

    Các promise 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,
): void

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

Thông số

  • phản hồi

    Đáp

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

setAdvertisingInterval()

Promise Chrome 55 trở lên 
chrome.bluetoothLowEnergy.setAdvertisingInterval(
  minInterval: number,
  maxInterval: number,
  callback?: function,
): Promise<void>

Đặt khoảng thời gian giữa 2 quảng cáo liên tiếp. Lưu ý: Đây là nỗ lực tối đa. Khoảng thời gian thực tế có thể khác biệt đáng kể so với khoảng thời gian được yêu cầu. Trên một số phần cứng, có 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 quy cách Bluetooth 4.2.

Thông 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). Giá trị này không được thấp hơn 20 mili giây (theo quy cách).

  • maxInterval

    số

    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 quy cách).

  • callback

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

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

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên

    Các promise 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()

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

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ể theo dõi thông báo bằng sự kiện onCharacteristicValueChanged.

Thông số

  • characteristicId

    chuỗi

    Mã nhận dạng phiên bản của đặc điểm GATT mà thông báo sẽ được bật.

  • 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).

  • callback

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

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

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên

    Các promise 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()

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

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

Thông số

  • characteristicId

    chuỗi

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

  • callback

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

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

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên

    Các promise 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()

Promise Chrome 47 trở lên 
chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
): Promise<void>

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

Thông số

  • advertisementId

    số

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

  • callback

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

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

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên

    Các promise 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()

Promise Chrome 52 trở lên 
chrome.bluetoothLowEnergy.unregisterService(
  serviceId: string,
  callback?: function,
): Promise<void>

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ệ, lastError sẽ được đặt. Chức năng này chỉ hoạt động nếu ứng dụng có cả quyền bluetooth:low_energy và bluetooth:peripheral được đặt thành true. Không phải ứng dụng nào cũng có quyền truy cập vào thiết bị ngoại vi.

Thông số

  • serviceId

    chuỗi

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

  • callback

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

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

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên

    Các promise 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()

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

Ghi giá trị của một đặc điểm cụ thể từ thiết bị ngoại vi từ xa.

Thông số

  • characteristicId

    chuỗi

    Mã nhận dạng phiên bản của đặc điểm GATT mà giá trị cần được ghi vào.

  • value

    ArrayBuffer

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

  • callback

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

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

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên

    Các promise 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()

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

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

Thông số

  • descriptorId

    chuỗi

    Mã nhận dạng phiên bản của bộ mô tả đặc điểm GATT mà giá trị cần được ghi vào.

  • value

    ArrayBuffer

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

  • callback

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

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

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên

    Các promise 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 không phản hồi yêu cầu này trong thời gian dài, kết nối có thể bị ngắt. Sự kiện này chỉ có sẵn nếu ứng dụng có cả quyền bluetooth:low_energy và bluetooth:peripheral được đặt thành true. Không phải ứng dụng nào cũng có quyền truy cập vào thiết bị ngoại vi.

Thông số

  • callback

    hàm

    Tham số callback 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 điểm GATT từ xa thay đổi, do kết quả 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 sẽ chỉ được gửi nếu ứng dụng đã bật thông báo bằng cách gọi startCharacteristicNotifications.

Thông 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 không phản hồi yêu cầu này trong thời gian dài, kết nối có thể bị ngắt. Sự kiện này chỉ có sẵn nếu ứng dụng có cả quyền bluetooth:low_energy và bluetooth:peripheral được đặt thành true. Không phải ứng dụng nào cũng có quyền truy cập vào thiết bị ngoại vi.

Thông số

  • callback

    hàm

    Tham số callback 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 một bộ mô tả được đăng ký trên máy chủ GATT cục bộ. Nếu không phản hồi yêu cầu này trong thời gian dài, kết nối có thể bị ngắt. Sự kiện này chỉ có sẵn nếu ứng dụng có cả quyền bluetooth:low_energy và bluetooth:peripheral được đặt thành true. Không phải ứng dụng nào cũng có quyền truy cập vào thiết bị ngoại vi.

Thông số

  • callback

    hàm

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

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

onDescriptorValueChanged

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

Kích hoạt khi giá trị của một 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 để mang lại sự thuận tiện và sẽ luôn được gửi sau khi gọi thành công đến readDescriptorValue.

Thông số

  • callback

    hàm

    Tham số callback 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 một bộ mô tả đã đăng ký trên máy chủ GATT cục bộ. Nếu không phản hồi yêu cầu này trong thời gian dài, kết nối có thể bị ngắt. Sự kiện này chỉ có sẵn nếu ứng dụng có cả quyền bluetooth:low_energy và bluetooth:peripheral được đặt thành true. Không phải ứng dụng nào cũng có quyền truy cập vào thiết bị ngoại vi.

Thông số

  • callback

    hàm

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

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

onServiceAdded

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

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

Thông số

  • callback

    hàm

    Tham số callback 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 một dịch vụ GATT từ xa thay đổi. Điều này liên quan đến mọi đặc điểm và/hoặc thông tin mô tả được thêm hoặc xoá khỏi dịch vụ, cũng như thông báo "ServiceChanged" từ thiết bị từ xa.

Thông số

  • callback

    hàm

    Tham số callback 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 từng được phát hiện trên một thiết bị từ xa đã bị xoá.

Thông số

  • callback

    hàm

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

    (service: Service) => void