Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
96d5cf74
D
Docs
项目概览
OpenHarmony
/
Docs
大约 1 年 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
提交
96d5cf74
编写于
6月 29, 2022
作者:
L
lverpeng
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
示例代码,接口完整性测试docs修改
Signed-off-by:
N
lverpeng
<
lverpeng118@163.com
>
上级
16e1f18e
变更
2
隐藏空白更改
内联
并排
Showing
2 changed file
with
41 addition
and
33 deletion
+41
-33
zh-cn/application-dev/reference/apis/js-apis-bluetooth.md
zh-cn/application-dev/reference/apis/js-apis-bluetooth.md
+35
-20
zh-cn/application-dev/reference/apis/js-apis-system-bluetooth.md
...pplication-dev/reference/apis/js-apis-system-bluetooth.md
+6
-13
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-bluetooth.md
浏览文件 @
96d5cf74
...
...
@@ -222,12 +222,12 @@ cancelPairedDevice(deviceId: string): boolean
删除配对的远程设备。
此接口为系统接口。
**需要权限**
:ohos.permission.DISCOVER_BLUETOOTH
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
**系统API**
:该接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
...
...
@@ -388,7 +388,7 @@ startBluetoothDiscovery(): boolean
开启蓝牙扫描,可以发现远端设备。
**需要权限**
:ohos.permission.
USE
_BLUETOOTH;ohos.permission.LOCATION
**需要权限**
:ohos.permission.
DISCOVER
_BLUETOOTH;ohos.permission.LOCATION
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
...
...
@@ -1143,7 +1143,7 @@ startBLEScan(filters: Array<ScanFilter>, options?: ScanOptions): void
发起BLE扫描流程。
**需要权限**
:ohos.permission.DISCOVER_BLUETOOTH;ohos.permission.MANAGE_BLUETOOTH;
ohos.permission.LOCATION
**需要权限**
:ohos.permission.DISCOVER_BLUETOOTH;ohos.permission.MANAGE_BLUETOOTH;ohos.permission.LOCATION
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
...
...
@@ -1422,7 +1422,7 @@ a2dpSrc.on('connectionStateChange', onReceiveEvent);
### off('connectionStateChange')<sup>8+</sup>
off(type: "connectionStateChange", callback: Callback
<
[StateChangeParam](#StateChangeParam)
>
): void
off(type: "connectionStateChange", callback
?
: Callback
<
[StateChangeParam](#StateChangeParam)
>
): void
取消订阅a2dp连接状态变化事件。
...
...
@@ -1451,12 +1451,14 @@ a2dpSrc.off('connectionStateChange', onReceiveEvent);
```
### getPlayingState
### getPlayingState
<sup>9+</sup>
getPlayingState(device: string): PlayingState
获取设备的播放状态。
**需要权限**
:ohos.permission.USE_BLUETOOTH
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
**参数:**
...
...
@@ -1576,7 +1578,7 @@ hfpAg.on('connectionStateChange', onReceiveEvent);
### off('connectionStateChange')<sup>8+</sup>
off(type: "connectionStateChange", callback: Callback
<
[StateChangeParam](#StateChangeParam)
>
): void
off(type: "connectionStateChange", callback
?
: Callback
<
[StateChangeParam](#StateChangeParam)
>
): void
取消订阅HFP连接状态变化事件。
...
...
@@ -1616,12 +1618,12 @@ connect(device: string): boolean
连接设备的HidHost服务。
此接口为系统接口。
**需要权限**
:ohos.permission.DISCOVER_BLUETOOTH
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
**系统API**
:该接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
...
...
@@ -1648,12 +1650,12 @@ disconnect(device: string): boolean
断开连接设备的HidHost服务。
此接口为系统接口。
**需要权限**
:ohos.permission.DISCOVER_BLUETOOTH
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
**系统API**
:该接口为系统接口,三方应用不支持调用。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
...
...
@@ -1706,7 +1708,7 @@ hidHost.on('connectionStateChange', onReceiveEvent);
### off('connectionStateChange')<sup>9+</sup>
off(type: "connectionStateChange", callback: Callback
<
[StateChangeParam](#StateChangeParam)
>
): void
off(type: "connectionStateChange", callback
?
: Callback
<
[StateChangeParam](#StateChangeParam)
>
): void
取消订阅HidHost连接状态变化事件。
...
...
@@ -1964,6 +1966,15 @@ server端特征值发生变化时,主动通知已连接的client设备。
**示例:**
```
js
// 创建descriptors
let
descriptors
=
[];
let
arrayBuffer
=
new
ArrayBuffer
(
8
);
let
descV
=
new
Uint8Array
(
arrayBuffer
);
descV
[
0
]
=
11
;
let
descriptor
=
{
serviceUuid
:
'
00001810-0000-1000-8000-00805F9B34FB
'
,
characteristicUuid
:
'
00001820-0000-1000-8000-00805F9B34FB
'
,
descriptorUuid
:
'
00001830-0000-1000-8000-00805F9B34FB
'
,
descriptorValue
:
arrayBuffer
};
descriptors
[
0
]
=
descriptor
;
let
arrayBufferC
=
new
ArrayBuffer
(
8
);
let
characteristic
=
{
serviceUuid
:
'
00001810-0000-1000-8000-00805F9B34FB
'
,
characteristicUuid
:
'
00001820-0000-1000-8000-00805F9B34FB
'
,
characteristicValue
:
arrayBufferC
,
descriptors
:
descriptors
};
...
...
@@ -2542,14 +2553,9 @@ client端获取蓝牙低功耗设备的所有服务,即服务发现。
```
js
// Promise 模式
let
device
=
bluetooth
.
BLE
.
createGattClientDevice
(
'
XX:XX:XX:XX:XX:XX
'
);
device
.
connect
();
var
services
=
device
.
getServices
();
console
.
log
(
"
bluetooth services size is
"
,
services
.
length
);
for
(
let
i
=
0
;
i
<
services
.
length
;
i
++
)
{
console
.
log
(
'
bluetooth serviceUuid is
'
+
services
[
i
].
serviceUuid
);
}
gattClientDevice
.
getServices
().
then
(
result
=>
{
console
.
info
(
"
getServices successfully:
"
+
JSON
.
stringify
(
result
));
});
```
...
...
@@ -2882,6 +2888,15 @@ setNotifyCharacteristicChanged(characteristic: BLECharacteristic, enable: boolea
**示例:**
```
js
// 创建descriptors
let
descriptors
=
[];
let
arrayBuffer
=
new
ArrayBuffer
(
8
);
let
descV
=
new
Uint8Array
(
arrayBuffer
);
descV
[
0
]
=
11
;
let
descriptor
=
{
serviceUuid
:
'
00001810-0000-1000-8000-00805F9B34FB
'
,
characteristicUuid
:
'
00001820-0000-1000-8000-00805F9B34FB
'
,
descriptorUuid
:
'
00001830-0000-1000-8000-00805F9B34FB
'
,
descriptorValue
:
arrayBuffer
};
descriptors
[
0
]
=
descriptor
;
let
arrayBufferC
=
new
ArrayBuffer
(
8
);
let
characteristic
=
{
serviceUuid
:
'
00001810-0000-1000-8000-00805F9B34FB
'
,
characteristicUuid
:
'
00001820-0000-1000-8000-00805F9B34FB
'
,
characteristicValue
:
arrayBufferC
,
descriptors
:
descriptors
};
...
...
zh-cn/application-dev/reference/apis/js-apis-system-bluetooth.md
浏览文件 @
96d5cf74
...
...
@@ -37,6 +37,7 @@ import bluetooth from '@system.bluetooth';
```
bluetooth.startBLEScan({
interval:0,
success() {
console.log('call bluetooth.startBLEScan success.');
},
...
...
@@ -71,7 +72,6 @@ import bluetooth from '@system.bluetooth';
```
bluetooth.stopBLEScan({
interval:0,
success() {
console.log('call bluetooth.stopBLEScan success.');
},
...
...
@@ -120,19 +120,12 @@ import bluetooth from '@system.bluetooth';
**示例:**
```
bluetooth.startBLEScan({
success() {
bluetooth.subscribeBLEFound({
success(data) {
const [device] = data.devices;
if (!!device) {
bluetooth.stopBLEScan();
}
}
});
bluetooth.subscribeBLEFound({
success(data) {
console.log('call bluetooth.subscribeBLEFound success, data: ${data}.');
},
fail(
code, data
) {
console.log('
Failed to start BLE device scan, code: ${code}, data: ${data}
');
fail(
data, code
) {
console.log('
call bluetooth.startBLEScan failed, data: ${data}, code: ${code}.
');
}
});
```
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录