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 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 đư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 "truyền tin", thì loại quảng cáo được gửi sẽ là ADV_NONCONN_IND và thiết bị sẽ truyền tin bằng Địa chỉ MAC ngẫu nhiên. Nếu bạn đặt thành "phần ngoại vi", thì 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ộ 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 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 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.

  • 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

    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 đ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 thông báo hoặc chỉ báo.

CharacteristicProperty

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 ra từ các thuộc tính này. Vui lòng xem thông số kỹ thuật Bluetooth 4.x để biết ý nghĩa của từng thuộc tính.

Enum

"broadcast"

"read"

"writeWithoutResponse"

"write"

"notify"

"chỉ báo"

"authenticatedSignedWrites"

"extendedProperties"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"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ó đượ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 các chỉ số 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 nhận 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

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

  • uuid

    chuỗi

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

  • value

    ArrayBuffer không bắt buộc

    Giá trị chỉ số mô tả 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 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 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

    số 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 thiết bị mà con người đọc được.

ManufacturerData

Chrome 47 trở lên

Thuộc tính

  • dữ liệu

    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ì 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 ứ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ã 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à đúng.

  • requestId

    số

    Mã nhận dạng của yêu cầu mà nội dung này là phản hồi.

  • value

    ArrayBuffer không bắt buộc

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

  • dữ liệu

    number[]

  • uuid

    chuỗi

Phương thức

connect()

Promise 
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ị đó 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ị phải 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 được kết nối, tất cả dịch vụ GATT của thiết bị sẽ được phát hiện sau khi gọi thành công đến connect.

Tham số

  • deviceAddress

    chuỗi

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

  • các tài sản

    ConnectProperties không bắt buộc

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

  • lệnh gọi lại

    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 Tệp kê khai 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ệ, lastError sẽ được đặt. Hàm 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.

Tham 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.

  • lệnh gọi lại

    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

    Lời hứa chỉ được hỗ trợ cho Tệp kê khai 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ột chỉ số 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ệ, thì lastError sẽ được đặt. Hàm 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.

Tham số

  • chỉ số mô tả

    Thông số mô tả

    Chỉ số 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.

  • lệnh gọi lại

    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

    Lời hứa chỉ được hỗ trợ cho Tệp kê khai 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,
)

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ả 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.

Tham số

  • dịch vụ

    Dịch vụ

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

  • lệnh gọi lại

    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

    Lời hứa chỉ được hỗ trợ cho Tệp kê khai 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,
)

Đó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ỷ bỏ 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ở.

Tham số

  • deviceAddress

    chuỗi

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

  • lệnh gọi lại

    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 Tệp kê khai 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,
)

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

Tham số

  • characteristicId

    chuỗi

    Mã thực thể của đặc điểm GATT đã yêu cầu.

  • lệnh gọi lại

    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 Tệp kê khai 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,
)

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

Tham số

  • serviceId

    chuỗi

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

  • lệnh gọi lại

    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 Tệp kê khai 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,
)

Nhận chỉ số mô tả đặc điểm GATT bằng mã thực thể đã cho.

Tham số

  • descriptorId

    chuỗi

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

  • lệnh gọi lại

    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 Tệp kê khai 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,
)

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

Tham số

  • characteristicId

    chuỗi

    Mã nhận dạng thực thể của đặc điểm GATT có chỉ số mô tả sẽ được trả về.

  • lệnh gọi lại

    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 Tệp kê khai 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,
)

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

Tham số

  • serviceId

    chuỗi

    Mã phiên bản của dịch vụ GATT có các dịch vụ được đưa vào sẽ được trả về.

  • lệnh gọi lại

    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 Tệp kê khai 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,
)

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

Tham số

  • serviceId

    chuỗi

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

  • lệnh gọi lại

    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 Tệp kê khai 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,
)

Nhận tất cả dịch vụ GATT được phát hiện 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 tập hợp con (có thể trống) của các dịch vụ. Một giải pháp là thêm độ trễ dựa trên thời gian và/hoặc gọi lại nhiều lần cho đến khi số lượng dịch vụ dự kiến được trả về.

Tham số

  • deviceAddress

    chuỗi

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

  • lệnh gọi lại

    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 Tệp kê khai 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ề 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 thiết lập 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ả 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.

Tham số

  • characteristicId

    chuỗi

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

  • thông báo

    Thông báo

  • lệnh gọi lại

    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 Tệp kê khai 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,
)

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.

Tham số

  • characteristicId

    chuỗi

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

  • lệnh gọi lại

    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 Tệp kê khai 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,
)

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

Tham 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 từ thiết bị từ xa.

  • lệnh gọi lại

    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 Tệp kê khai 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,
)

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: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 khác có vai trò trung tâm hoạt động chính xác (bao gồm cả việc phát hiện thiết bị Bluetooth năng lượng thấp).

Tham số

  • quảng cáo

    Quảng cáo

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

  • lệnh gọi lại

    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<số>

    Chrome 91 trở lên

    Lời hứa chỉ được hỗ trợ cho Tệp kê khai 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ụ đã 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ả 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.

Tham số

  • serviceId

    chuỗi

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

  • lệnh gọi lại

    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 Tệp kê khai 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,
)

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ả 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.

Tham 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.

  • lệnh gọi lại

    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 Tệp kê khai 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 hoạt động 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ó.

Tham số

  • lệnh gọi lại

    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 Tệp kê khai 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 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ả 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.

Tham số

  • phản hồi

    Đáp

    Nội dung phản hồi 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 ý: Chúng tôi sẽ cố gắng hết sức để thực hiện việc này. Khoảng thời gian thực tế có thể khác đá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 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). Thời gian 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). Thời gian này không được vượt quá 10240 mili giây (theo thông số kỹ thuật).

  • lệnh gọi lại

    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 Tệp kê khai 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,
)

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

Tham 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.

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

  • lệnh gọi lại

    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 Tệp kê khai 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,
)

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.

Tham 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ẽ bị dừng.

  • lệnh gọi lại

    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 Tệp kê khai 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,
)

Huỷ đăng ký quảng cáo và ngừng quảng cáo. Nếu quảng cáo không đăng ký, thì cách duy nhất để dừ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ý.

  • lệnh gọi lại

    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 Tệp kê khai 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,
)

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ả 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.

Tham 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.

  • lệnh gọi lại

    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 Tệp kê khai 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,
)

Ghi 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

    chuỗi

    Mã nhận dạng thực thể của đặc điểm GATT có 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.

  • lệnh gọi lại

    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 Tệp kê khai 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,
)

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

Tham 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 vào.

  • value

    ArrayBuffer

    Giá trị cần được gửi đến chỉ số từ xa trong yêu cầu ghi.

  • lệnh gọi lại

    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 Tệp kê khai 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ộ. Việc không phản hồi yêu cầu này trong thời gian dài có thể dẫn đến việc bị ngắt kết nối. Sự kiện này chỉ có sẵn nếu ứng dụng đặt cả quyền bluetooth:low_energy và bluetooth:peripheral 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.

Tham số

  • lệnh gọi lại

    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.

Tham số

onCharacteristicWriteRequest

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

Được kích hoạt khi một thiết bị trung tâm đã kết nối yêu cầu ghi giá trị của một đặc điểm đã đăng ký trên máy chủ GATT cục bộ. Việc không phản hồi yêu cầu này trong thời gian dài có thể dẫn đến việc bị ngắt kết nối. Sự kiện này chỉ có sẵn nếu ứng dụng đặt cả quyền bluetooth:low_energy và bluetooth:peripheral 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.

Tham số

  • lệnh gọi lại

    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ộ. Việc không phản hồi yêu cầu này trong thời gian dài có thể dẫn đến việc bị ngắt kết nối. Sự kiện này chỉ có sẵn nếu ứng dụng đặt cả quyền bluetooth:low_energy và bluetooth:peripheral 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.

Tham số

  • lệnh gọi lại

    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 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 gọi thành công đến readDescriptorValue.

Tham 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ộ. Việc không phản hồi yêu cầu này trong thời gian dài có thể dẫn đến việc bị ngắt kết nối. Sự kiện này chỉ có sẵn nếu ứng dụng đặt cả quyền bluetooth:low_energy và bluetooth:peripheral 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.

Tham số

  • lệnh gọi lại

    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 một dịch vụ GATT mới trên thiết bị từ xa.

Tham số

  • lệnh gọi lại

    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 nội dung 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.

Tham số

  • lệnh gọi lại

    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 thiết bị từ xa đã bị xoá.

Tham số

  • lệnh gọi lại

    hàm

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

    (service: Service) => void