• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# @ohos.bluetooth (蓝牙)(系统接口)
2
3<!--Kit: Connectivity Kit-->
4<!--Subsystem: Communication-->
5<!--Owner: @enjoy_sunshine-->
6<!--Designer: @chengguohong; @tangjia15-->
7<!--Tester: @wangfeng517-->
8<!--Adviser: @zhang_yixin13-->
9
10蓝牙模块提供了基础的传统蓝牙能力以及BLE的扫描、广播等功能。
11
12> **说明:**
13> 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
14> 从API Version 9 开始,该接口不再维护,推荐使用[`@ohos.bluetooth.ble`](js-apis-bluetooth-ble.md)等相关profile接口。
15> 当前页面仅包含本模块的系统接口,其他公开接口参见[@ohos.bluetooth (蓝牙)](js-apis-bluetooth.md)。
16
17## 导入模块
18
19```js
20import bluetooth from '@ohos.bluetooth';
21```
22
23## bluetooth.cancelPairedDevice<sup>8+</sup><sup>(deprecated)</sup><a name="cancelPairedDevice"></a>
24
25cancelPairedDevice(deviceId: string): boolean
26
27删除配对的远程设备。
28
29> **说明:**<br/>
30> 从API version 8开始支持,从API version 9开始废弃。建议使用[bluetoothManager.cancelPairedDevice](js-apis-bluetoothManager-sys.md#bluetoothmanagercancelpaireddevicedeprecated)替代。
31
32**系统接口**:此接口为系统接口。
33
34**需要权限**:ohos.permission.DISCOVER_BLUETOOTH
35
36**系统能力**:SystemCapability.Communication.Bluetooth.Core37
38**参数:**
39
40| 参数名      | 类型     | 必填   | 说明                                    |
41| -------- | ------ | ---- | ------------------------------------- |
42| deviceId | string | 是    | 表示要删除的远程设备的地址,例如:"XX:XX:XX:XX:XX:XX"。 |
43
44**返回值:**
45
46| 类型      | 说明                         |
47| ------- | -------------------------- |
48| boolean | 启动取消配对,成功返回true,否则返回false。 |
49
50**示例:**
51
52```js
53let result : boolean = bluetooth.cancelPairedDevice("XX:XX:XX:XX:XX:XX");
54```
55