chrome.bluetoothLowEnergy

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 Hồ sơ thuộc tính chung (GATT).

Phạm vi cung cấp

Chỉ dành cho ChromeOS

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 đư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ụ cần đư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" (UUID thu hút) 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 "phát sóng", thì loại quảng cáo được gửi sẽ là ADV_NONCONN_IND và thiết bị sẽ phát sóng bằng một Địa chỉ MAC ngẫu nhiên. Nếu được đặt thành "thiết bị 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 bằng Địa chỉ MAC của Bộ chuyển đổi 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 thực thể để phân biệt giữa 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 lấy giá trị nhận dạng đặc điểm. Có, nếu thực thể 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

    Không bắt buộc ArrayBuffer

    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. Quyền đối với đặc điểm được suy luận từ các thuộc tính này. Vui lòng xem thông số kỹ thuật của Bluetooth 4.x để biết ý nghĩa của từng thuộc tính.

Enum

"broadcast"

"read"

"writeWithoutResponse"

"write"

"notify"

"indicate"

"authenticatedSignedWrites"

"extendedProperties"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

Thuộc tính

  • bền vững

    boolean

    Cờ cho biết liệu kết nối với thiết bị có được 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 điểm GATT mà chỉ số 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 chỉ số mô tả này. Sử dụng mã nhận dạng thực thể để phân biệt giữa các chỉ số mô tả 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 lấy giá trị nhận dạng chỉ số mô tả. Có, nếu thực thể này đại diện cho một đặc điểm từ xa.

  • Chrome 52 trở lên

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

  • uuid

    chuỗi

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

  • value

    Không bắt buộc ArrayBuffer

    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 chỉ số mô tả được đọc.

DescriptorPermission

Chrome 52 trở lên

Các giá trị đại diện cho các quyền có thể có đối với một chỉ số mô tả. Vui lòng xem thông số kỹ thuật của 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ị, ở đị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 được xác định bởi http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband.

  • 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

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

  • bền vững

    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 ứ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

    Không bắt buộc ArrayBuffer

    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

    Không bắt buộc ArrayBuffer

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

    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ể đã được 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 duy trì kết nối với thiết bị. Nếu thiết bị không được kết nối, thì tất 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 cầ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

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

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. Hàm này chỉ hoạt động nếu ứng dụng có cả bộ 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ề

  • <string> hứa hẹn

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

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

Tạo một chỉ số mô tả GATT được lưu trữ cục bộ. Phần 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ì lastError sẽ được đặt. Hàm này chỉ hoạt động nếu ứng dụng có cả bộ 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 mô tả cần tạo.

  • characteristicId

    chuỗi

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

  • <string> hứa hẹn

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

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

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ộ. Hàm này chỉ hoạt động nếu ứng dụng có cả bộ 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ề

  • <string> hứa hẹn

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

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 việc này không phải lúc nào cũng huỷ liên kết vật lý vì có thể có các ứng dụng khác có kết nối 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

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

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

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

Thông số

  • characteristicId

    chuỗi

    Mã thực thể 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

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

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

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

Thông số

  • serviceId

    chuỗi

    Mã thực thể của dịch vụ GATT có 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

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

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

Lấy chỉ số mô tả đặc điểm GATT có mã thực thể đã cho.

Thông số

  • descriptorId

    chuỗi

    Mã nhận dạng thực thể của chỉ số 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

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

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

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

Thông số

  • characteristicId

    chuỗi

    Mã thực thể của đặc điểm GATT có chỉ số mô tả cần đượ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

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

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ã thực thể của dịch vụ GATT có các dịch vụ đi kèm cần đượ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

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

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

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

Thông số

  • serviceId

    chuỗi

    Mã thực thể 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ề

  • <Service> hứa hẹn

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

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

Lấy tất 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ị, thì API này sẽ trả về một nhóm nhỏ (có thể trống) các dịch vụ. 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 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 có dịch vụ GATT cần đượ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

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

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

Thông báo cho 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. Lưu ý: đặc điểm cần đặt chính xác thuộc tính "notify" (thông báo) hoặc "indicate" (cho biết) trong quá trình tạo để lệnh gọi này thành công. Hàm này chỉ hoạt động nếu ứng dụng có cả bộ 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

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

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

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

Thông số

  • characteristicId

    chuỗi

    Mã nhận dạng thực thể 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

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

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

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

Thông số

  • descriptorId

    chuỗi

    Mã nhận dạng thực thể của chỉ số 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

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

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 đặt bộ quyền bluetooth:low_energy và bluetooth:peripheral 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 nút chuyển dòng lệnh "--enable-ble-advertising-in-apps". Xem https://developer.chrome.com/apps/manifest/bluetooth Lưu ý: Trên một số phần cứng, chế độ trung tâm và ngoại vi được hỗ trợ 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ế độ 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 có vai trò trung tâm khác hoạt động chính xác (bao gồm cả việc khám phá 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 để 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

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

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ệ, thì lastError sẽ được đặt. Hàm này chỉ hoạt động nếu ứng dụng có cả bộ 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

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

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ệ, thì lastError sẽ được đặt. Hàm này chỉ hoạt động nếu ứng dụng có cả bộ 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

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

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

    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,
): void

Gửi phản hồi cho yêu cầu đọc/ghi đặc điểm hoặc chỉ số mô tả. Hàm này chỉ hoạt động nếu ứng dụng có cả bộ 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

    Câu trả lờ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 hai 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, 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 của 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 thông số kỹ thuật).

  • 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). Giá trị này không được vượt quá 10240 mili giây (theo thông số kỹ thuật).

  • 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

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

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 được chỉ định. Sau khi 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ã thực thể của đặc điểm GATT mà bạn nên bật thông báo.

  • 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

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

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 được 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 lạ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

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

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 huỷ đăng ký được, thì cách duy nhất để dừ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

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

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ệ, thì lastError sẽ được đặt. Hàm này chỉ hoạt động nếu ứng dụng có cả bộ 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

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

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

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

Thông số

  • characteristicId

    chuỗi

    Mã nhận dạng thực thể của đặc điểm GATT có giá trị cần được ghi.

  • 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

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

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

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

Thông số

  • descriptorId

    chuỗi

    Mã nhận dạng thực thể của chỉ số mô tả đặc điểm GATT có giá trị cần được ghi.

  • value

    ArrayBuffer

    Giá trị cần được gửi đến chỉ số 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

    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ì 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ả bộ 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 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 bạn không phản hồi yêu cầu này trong thời gian dài, thì 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ả bộ 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 chỉ số 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ì 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ả bộ 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,
)

Được kích hoạt khi giá trị của một chỉ số 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 đến readDescriptorValue thành công.

Thông số

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 chỉ số 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ì 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ả bộ 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 phát hiện thấy một dịch vụ GATT mới trên 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 dịch vụ GATT từ xa thay đổi. Điều này liên quan đến mọi đặc điểm và/hoặc chỉ số 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 đã được phát hiện trước đó trên thiết bị từ xa bị xoá.

Thông số

  • callback

    hàm

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

    (service: Service) => void