chrome.bluetooth

Nội dung mô tả

Sử dụng API chrome.bluetooth để kết nối với thiết bị Bluetooth. Tất cả hàm đều báo cáo lỗi qua chrome.runtime.lastError.

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

AdapterState

Thuộc tính

  • xử lý

    string

    Địa chỉ của trình chuyển đổi, ở định dạng 'XX:XX:XX:XX:XX:XX'.

  • có sẵn

    boolean

    Cho biết liệu bộ chuyển đổi có sẵn hay không (tức là đã bật).

  • khám phá

    boolean

    Cho biết liệu bộ chuyển đổi hiện có đang tìm thấy bộ chuyển đổi đó hay không.

  • tên

    string

    Tên của bộ chuyển đổi mà con người có thể đọc được.

  • chạy bằng điện

    boolean

    Cho biết liệu bộ chuyển đổi có nguồn điện hay không.

BluetoothFilter

Chrome 67 trở lên

Thuộc tính

  • filterType

    FilterType không bắt buộc

    Loại bộ lọc để áp dụng cho danh sách thiết bị. Mặc định là tất cả.

  • giới hạn

    số không bắt buộc

    Số thiết bị Bluetoth tối đa cần trả về. Giá trị mặc định là 0 (không có giới hạn) nếu không chỉ định.

Device

Thuộc tính

  • xử lý

    string

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

  • batteryPercentage

    số không bắt buộc

    Chrome 77 trở lên

    Pin còn lại của thiết bị.

  • có thể kết nối

    boolean không bắt buộc

    Chrome 48 trở lên

    Cho biết thiết bị có thể kết nối hay không.

  • đã kết nối

    boolean không bắt buộc

    Cho biết liệu thiết bị hiện có được kết nối với hệ thống hay không.

  • nối chuyến

    boolean không bắt buộc

    Chrome 48 trở lên

    Cho biết liệu thiết bị hiện có đang kết nối với hệ thống hay không.

  • deviceClass

    số không bắt buộc

    Lớp của thiết bị, trường bit được xác định bởi http://www.bluetooth.org/en-us/specification/attributes-numbers/base Band.

  • deviceId

    số không bắt buộc

  • inquiryRssi

    số không bắt buộc

    Chrome 44 trở lên

    Cường độ tín hiệu đã nhận, tính bằng dBm. Trường này chỉ có sẵn và chỉ hợp lệ trong quá trình khám phá. Ngoài khám phá, giá trị của nó không được chỉ định.

  • inquiryTxPower

    số không bắt buộc

    Chrome 44 trở lên

    Mức công suất được truyền. Trường này chỉ có sẵn cho các thiết bị LE có bao gồm trường này trong AD. Mã này chỉ có sẵn và chỉ hợp lệ trong quá trình khám phá.

  • tên

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

    Tên thiết bị mà con người có thể đọc được.

  • đã ghép nối

    boolean không bắt buộc

    Cho biết thiết bị có được ghép nối với hệ thống hay không.

  • productId

    số không bắt buộc

  • vận tải

    Di chuyển không bắt buộc

    Chrome 76 trở lên

    Loại truyền tải của thiết bị Bluetooth.

  • loại

    DeviceType không bắt buộc

    Loại thiết bị, nếu Chrome nhận dạng được. Giá trị này lấy từ trường deviceClass và chỉ đại diện cho một phần nhỏ các loại thiết bị có thể có. Khi không chắc chắn, bạn nên sử dụng trực tiếp trường deviceClass.

  • uuid

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

    Mã nhận dạng duy nhất (UUID) của giao thức, hồ sơ và dịch vụ mà thiết bị quảng cáo. Đối với các thiết bị Bluetooth cổ điển, danh sách này được lấy từ dữ liệu EIR và bảng SDP. Đối với các thiết bị có năng lượng thấp, danh sách này lấy từ các dịch vụ chính của AD và GATT. Đối với các thiết bị ở chế độ kép, bạn có thể lấy dữ liệu này từ cả hai thiết bị.

  • vendorId

    số không bắt buộc

  • vendorIdSource

    VendorIdSource không bắt buộc

    Bản ghi mã thiết bị của thiết bị (nếu có).

DeviceType

Các loại thiết bị phổ biến được Chrome nhận dạng.

Liệt kê

"modem"

"carAudio"

"video"

"gamepad"

"keyboardMouseCombo"

FilterType

Chrome 67 trở lên

Các loại để lọc thiết bị Bluetooth.

Liệt kê

Transport

Chrome 76 trở lên

Loại truyền tải của thiết bị Bluetooth.

Liệt kê

"le"

VendorIdSource

Cơ quan phân bổ cho mã nhà cung cấp.

Liệt kê

"bluetooth"

"usb"

Phương thức

getAdapterState()

Cam kết 
chrome.bluetooth.getAdapterState(
  callback?: function,
)

Nhận thông tin về bộ chuyển đổi Bluetooth.

Tham số

  • số gọi lại

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

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

    (adapterInfo: AdapterState)=>void

    • adapterInfo

      AdapterState

      Đối tượng chứa thông tin về bộ chuyển đổi.

Giá trị trả về

  • Promise<AdapterState>

    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.

getDevice()

Cam kết 
chrome.bluetooth.getDevice(
  deviceAddress: string,
  callback?: function,
)

Nhận thông tin về thiết bị Bluetooth mà hệ thống đã biết.

Tham số

  • deviceAddress

    string

    Địa chỉ của thiết bị cần tải.

  • số gọi lại

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

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

    (deviceInfo: Device)=>void

    • deviceInfo

      Thiết bị

      Đối tượng chứa thông tin thiết bị.

Giá trị trả về

  • Hứa hẹn<Thiết bị>

    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.

getDevices()

Cam kết 
chrome.bluetooth.getDevices(
  filter?: BluetoothFilter,
  callback?: function,
)

Nhận danh sách các thiết bị Bluetooth mà hệ thống đã biết, bao gồm cả thiết bị đã ghép nối và thiết bị mới phát hiện gần đây.

Tham số

  • filter

    BluetoothFilter không bắt buộc

    Chrome 67 trở lên

    Một số tiêu chí để lọc danh sách thiết bị bluetooth được trả về. Nếu bạn không đặt hoặc đặt bộ lọc thành {}, danh sách thiết bị được trả về sẽ chứa tất cả thiết bị Bluetooth. Hiện tại, tính năng này chỉ được hỗ trợ trong ChromeOS. Đối với các nền tảng khác, hệ thống sẽ trả về một danh sách đầy đủ.

  • số gọi lại

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

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

    (deviceInfos: Device[])=>void

    • deviceInfos

      Thiết bị[]

      Mảng đối tượng chứa thông tin thiết bị.

Giá trị trả về

  • Hứa hẹn<Thiết bị[]>

    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.

startDiscovery()

Cam kết 
chrome.bluetooth.startDiscovery(
  callback?: function,
)

Bắt đầu khám phá. Các thiết bị mới phát hiện sẽ được trả lại thông qua sự kiện onDeviceAdded. Bạn phải lấy các thiết bị đã phát hiện trước đây mà bộ chuyển đổi đã biết bằng getDevices và chỉ cập nhật các thiết bị này thông qua sự kiện onDeviceChanged nếu thông tin về các thiết bị đó thay đổi.

Khám phá sẽ không bắt đầu được nếu ứng dụng này đã gọi startDiscovery. Khám phá có thể tốn nhiều tài nguyên: nên gọi lệnh StopDiscovery càng sớm càng tốt.

Tham số

  • số gọi lại

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

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

    ()=>void

Giá trị trả về

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

stopDiscovery()

Cam kết 
chrome.bluetooth.stopDiscovery(
  callback?: function,
)

Dừng khám phá.

Tham số

  • số gọi lại

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

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

    ()=>void

Giá trị trả về

  • 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

onAdapterStateChanged

chrome.bluetooth.onAdapterStateChanged.addListener(
  callback: function,
)

Được kích hoạt khi trạng thái của bộ điều hợp Bluetooth thay đổi.

Tham số

onDeviceAdded

chrome.bluetooth.onDeviceAdded.addListener(
  callback: function,
)

Được kích hoạt khi có thông tin về thiết bị Bluetooth mới.

Tham số

  • số gọi lại

    hàm

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

    (device: Device)=>void

onDeviceChanged

chrome.bluetooth.onDeviceChanged.addListener(
  callback: function,
)

Được kích hoạt khi thông tin về một thiết bị Bluetooth đã biết thay đổi.

Tham số

  • số gọi lại

    hàm

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

    (device: Device)=>void

onDeviceRemoved

chrome.bluetooth.onDeviceRemoved.addListener(
  callback: function,
)

Được kích hoạt khi một thiết bị Bluetooth được phát hiện trước đó nằm ngoài phạm vi đủ lâu để được coi là không hoạt động trở lại và khi một thiết bị đã ghép nối bị xoá.

Tham số

  • số gọi lại

    hàm

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

    (device: Device)=>void