BluetoothRemoteGATTCharacteristic

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

Giao diện BluetoothRemoteGATTCharacteristic của Web Bluetooth API biểu diễn một đặc tính GATT, là phần tử dữ liệu cơ bản cung cấp thêm thông tin về dịch vụ của thiết bị ngoại vi.

EventTarget BluetoothRemoteGATTCharacteristic

Thuộc tính thể hiện

BluetoothRemoteGATTCharacteristic.service Read only Experimental

Trả về BluetoothRemoteGATTService mà đặc tính này thuộc về.

BluetoothRemoteGATTCharacteristic.uuid Read only Experimental

Trả về một chuỗi chứa UUID của đặc tính, ví dụ '00002a37-0000-1000-8000-00805f9b34fb' cho đặc tính Heart Rate Measurement.

BluetoothRemoteGATTCharacteristic.properties Read only Experimental

Trả về các thuộc tính của đặc tính này.

BluetoothRemoteGATTCharacteristic.value Read only Experimental

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

Phương thức thể hiện

BluetoothRemoteGATTCharacteristic.getDescriptor() Experimental

Trả về một Promise được giải quyết thành BluetoothRemoteGATTDescriptor đầu tiên cho một UUID mô tả nhất định.

BluetoothRemoteGATTCharacteristic.getDescriptors() Experimental

Trả về một Promise được giải quyết thành một Array gồm tất cả các đối tượng BluetoothRemoteGATTDescriptor cho một UUID mô tả nhất định.

BluetoothRemoteGATTCharacteristic.readValue() Experimental

Trả về một Promise được giải quyết thành một DataView chứa bản sao của thuộc tính value nếu thuộc tính này sẵn có và được hỗ trợ. Nếu không, nó sẽ ném ra lỗi.

BluetoothRemoteGATTCharacteristic.writeValue() Deprecated

Đặt thuộc tính value thành các byte chứa trong một ArrayBuffer nhất định, ghi giá trị đặc tính với phản hồi tùy chọn, rồi trả về Promise tương ứng.

BluetoothRemoteGATTCharacteristic.writeValueWithResponse() Experimental

Đặt thuộc tính value thành các byte chứa trong một ArrayBuffer nhất định, ghi giá trị đặc tính với phản hồi bắt buộc, rồi trả về Promise tương ứng.

BluetoothRemoteGATTCharacteristic.writeValueWithoutResponse() Experimental

Đặt thuộc tính value thành các byte chứa trong một ArrayBuffer nhất định, ghi giá trị đặc tính mà không cần phản hồi, rồi trả về Promise tương ứng.

BluetoothRemoteGATTCharacteristic.startNotifications() Experimental

Trả về một Promise được giải quyết khi navigator.bluetooth được thêm vào ngữ cảnh thông báo đang hoạt động.

BluetoothRemoteGATTCharacteristic.stopNotifications() Experimental

Trả về một Promise được giải quyết khi navigator.bluetooth bị xóa khỏi ngữ cảnh thông báo đang hoạt động.

Sự kiện

characteristicvaluechanged Experimental

Được kích hoạt trên BluetoothRemoteGATTCharacteristic khi giá trị của nó thay đổi.

Thông số kỹ thuật

Specification
Web Bluetooth
# bluetoothgattcharacteristic-interface

Tương thích trình duyệt