Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
a488a554
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看板
提交
a488a554
编写于
7月 22, 2023
作者:
L
lverpeng
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
add api10
Signed-off-by:
N
lverpeng
<
lverpeng118@163.com
>
上级
e79c03cb
变更
12
展开全部
隐藏空白更改
内联
并排
Showing
12 changed file
with
6341 addition
and
843 deletion
+6341
-843
zh-cn/application-dev/reference/apis/Readme-CN.md
zh-cn/application-dev/reference/apis/Readme-CN.md
+11
-1
zh-cn/application-dev/reference/apis/js-apis-bluetooth-a2dp.md
.../application-dev/reference/apis/js-apis-bluetooth-a2dp.md
+184
-0
zh-cn/application-dev/reference/apis/js-apis-bluetooth-access.md
...pplication-dev/reference/apis/js-apis-bluetooth-access.md
+207
-0
zh-cn/application-dev/reference/apis/js-apis-bluetooth-baseProfile.md
...ation-dev/reference/apis/js-apis-bluetooth-baseProfile.md
+388
-0
zh-cn/application-dev/reference/apis/js-apis-bluetooth-ble.md
...n/application-dev/reference/apis/js-apis-bluetooth-ble.md
+2539
-0
zh-cn/application-dev/reference/apis/js-apis-bluetooth-connection.md
...cation-dev/reference/apis/js-apis-bluetooth-connection.md
+1397
-0
zh-cn/application-dev/reference/apis/js-apis-bluetooth-constant.md
...lication-dev/reference/apis/js-apis-bluetooth-constant.md
+181
-0
zh-cn/application-dev/reference/apis/js-apis-bluetooth-hfp.md
...n/application-dev/reference/apis/js-apis-bluetooth-hfp.md
+128
-0
zh-cn/application-dev/reference/apis/js-apis-bluetooth-hid.md
...n/application-dev/reference/apis/js-apis-bluetooth-hid.md
+128
-0
zh-cn/application-dev/reference/apis/js-apis-bluetooth-pan.md
...n/application-dev/reference/apis/js-apis-bluetooth-pan.md
+158
-0
zh-cn/application-dev/reference/apis/js-apis-bluetooth-socket.md
...pplication-dev/reference/apis/js-apis-bluetooth-socket.md
+410
-0
zh-cn/application-dev/reference/apis/js-apis-bluetoothManager.md
...pplication-dev/reference/apis/js-apis-bluetoothManager.md
+610
-842
未找到文件。
zh-cn/application-dev/reference/apis/Readme-CN.md
浏览文件 @
a488a554
...
...
@@ -319,8 +319,18 @@
-
[
@ohos.request (上传下载)
](
js-apis-request.md
)
-
通信与连接
-
[
@ohos.bluetooth.a2dp(蓝牙a2dp模块)(推荐)
](
js-apis-bluetooth-a2dp.md
)
-
[
@ohos.bluetooth.access(蓝牙access模块)(推荐)
](
js-apis-bluetooth-access.md
)
-
[
@ohos.bluetooth.baseProfile(蓝牙baseProfile模块)(推荐)
](
js-apis-bluetooth-baseProfile.md
)
-
[
@ohos.bluetooth.ble(蓝牙ble模块)(推荐)
](
js-apis-bluetooth-ble.md
)
-
[
@ohos.bluetooth.connection(蓝牙connection模块)(推荐)
](
js-apis-bluetooth-connection.md
)
-
[
@ohos.bluetooth.constant(蓝牙constant模块)(推荐)
](
js-apis-bluetooth-constant.md
)
-
[
@ohos.bluetooth.hfp(蓝牙hfp模块)(推荐)
](
js-apis-bluetooth-hfp.md
)
-
[
@ohos.bluetooth.hid(蓝牙hid模块)(推荐)
](
js-apis-bluetooth-hid.md
)
-
[
@ohos.bluetooth.pan(蓝牙pan模块)(推荐)
](
js-apis-bluetooth-pan.md
)
-
[
@ohos.bluetooth.socket(蓝牙socket模块)(推荐)
](
js-apis-bluetooth-socket.md
)
-
[
@ohos.bluetooth (蓝牙)(待停用)
](
js-apis-bluetooth.md
)
-
[
@ohos.bluetoothManager (蓝牙)(
推荐
)
](
js-apis-bluetoothManager.md
)
-
[
@ohos.bluetoothManager (蓝牙)(
待停用
)
](
js-apis-bluetoothManager.md
)
-
[
@ohos.connectedTag (有源标签)
](
js-apis-connectedTag.md
)
-
[
@ohos.nfc.cardEmulation (标准NFC-cardEmulation)
](
js-apis-cardEmulation.md
)
-
[
@ohos.nfc.controller (标准NFC)
](
js-apis-nfcController.md
)
...
...
zh-cn/application-dev/reference/apis/js-apis-bluetooth-a2dp.md
0 → 100644
浏览文件 @
a488a554
# @ohos.bluetooth.a2dp (蓝牙a2dp模块)
a2dp模块提供了访问蓝牙音频接口的方法。
> **说明:**
>
> 本模块首批接口从API version 10开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块
```
js
import
a2dp
from
'
@ohos.bluetooth.a2dp
'
;
```
## a2dp.createA2dpSrcProfile<a name="createA2dpSrcProfile"></a>
createA2dpSrcProfile(): A2dpSourceProfile
创建a2dp profile实例。
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
**返回值:**
| 类型 | 说明 |
| ----------------------------- | ---------- |
| A2dpSourceProfile | 返回该profile的实例。 |
**示例:**
```
js
try
{
let
a2dpProfile
=
a2dp
.
createA2dpSrcProfile
();
console
.
info
(
'
a2dp success
'
);
}
catch
(
err
)
{
console
.
error
(
'
errCode:
'
+
err
.
code
+
'
, errMessage:
'
+
err
.
message
);
}
```
## A2dpSourceProfile
使用A2dpSourceProfile方法之前需要创建该类的实例进行操作,通过createA2dpSrcProfile()方法构造此实例。
### connect<a name="a2dp-connect"></a>
connect(deviceId: string): void
发起设备的A2dp服务连接请求。
**系统接口**
:此接口为系统接口。
**需要权限**
:ohos.permission.ACCESS_BLUETOOTH
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
| deviceId | string | 是 | 远端设备地址。 |
**错误码**
:
以下错误码的详细介绍请参见
[
蓝牙服务子系统错误码
](
../errorcodes/errorcode-bluetoothManager.md
)
。
| 错误码ID | 错误信息 |
| -------- | ---------------------------- |
|2900001 | Service stopped. |
|2900003 | Bluetooth switch is off. |
|2900004 | Profile is not supported. |
|2900099 | Operation failed. |
**示例:**
```
js
try
{
let
a2dpSrc
=
a2dp
.
createA2dpSrcProfile
();
a2dpSrc
.
connect
(
'
XX:XX:XX:XX:XX:XX
'
);
}
catch
(
err
)
{
console
.
error
(
'
errCode:
'
+
err
.
code
+
'
, errMessage:
'
+
err
.
message
);
}
```
### disconnect<a name="a2dp-disconnect"></a>
disconnect(deviceId: string): void
断开设备的a2dp服务连接。
**系统接口**
:此接口为系统接口。
**需要权限**
:ohos.permission.ACCESS_BLUETOOTH
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
| deviceId | string | 是 | 远端设备地址。 |
**错误码**
:
以下错误码的详细介绍请参见
[
蓝牙服务子系统错误码
](
../errorcodes/errorcode-bluetoothManager.md
)
。
| 错误码ID | 错误信息 |
| -------- | ---------------------------- |
|2900001 | Service stopped. |
|2900003 | Bluetooth switch is off. |
|2900004 | Profile is not supported. |
|2900099 | Operation failed. |
**示例:**
```
js
try
{
let
a2dpSrc
=
a2dp
.
createA2dpSrcProfile
();
a2dpSrc
.
disconnect
(
'
XX:XX:XX:XX:XX:XX
'
);
}
catch
(
err
)
{
console
.
error
(
'
errCode:
'
+
err
.
code
+
'
, errMessage:
'
+
err
.
message
);
}
```
### getPlayingState
getPlayingState(deviceId: string): PlayingState
获取设备的播放状态。
**需要权限**
:ohos.permission.ACCESS_BLUETOOTH
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
| device | string | 是 | 远端设备地址。 |
**返回值:**
| 类型 | 说明 |
| ----------------------------- | ---------- |
|
[
PlayingState
](
#PlayingState
)
| 远端设备的播放状态。 |
**错误码**
:
以下错误码的详细介绍请参见
[
蓝牙服务子系统错误码
](
../errorcodes/errorcode-bluetoothManager.md
)
。
| 错误码ID | 错误信息 |
| -------- | ---------------------------- |
|2900001 | Service stopped. |
|2900003 | Bluetooth switch is off. |
|2900004 | Profile is not supported. |
|2900099 | Operation failed. |
**示例:**
```
js
try
{
let
a2dpSrc
=
a2dp
.
createA2dpSrcProfile
();
let
state
=
a2dpSrc
.
getPlayingState
(
'
XX:XX:XX:XX:XX:XX
'
);
}
catch
(
err
)
{
console
.
error
(
'
errCode:
'
+
err
.
code
+
'
, errMessage:
'
+
err
.
message
);
}
```
## PlayingState<a name="PlayingState"></a>
枚举,蓝牙A2DP 播放状态。
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
| 名称 | 值 | 说明 |
| ----------------- | ------ | ------- |
| STATE_NOT_PLAYING | 0x0000 | 表示未播放。 |
| STATE_PLAYING | 0x0001 | 表示正在播放。 |
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-bluetooth-access.md
0 → 100644
浏览文件 @
a488a554
# @ohos.bluetooth.access (蓝牙access模块)
access模块提供了打开和关闭蓝牙、获取蓝牙状态的方法。
> **说明:**
>
> 本模块首批接口从API version 10开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块
```
js
import
access
from
'
@ohos.bluetooth.access
'
;
```
## access.enableBluetooth<a name="enableBluetooth"></a>
enableBluetooth(): void
开启蓝牙。
**需要权限**
:ohos.permission.ACCESS_BLUETOOTH
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
**错误码**
:
以下错误码的详细介绍请参见
[
蓝牙服务子系统错误码
](
../errorcodes/errorcode-bluetoothManager.md
)
。
| 错误码ID | 错误信息 |
| -------- | ------------------ |
|2900001 | Service stopped. |
|2900099 | Operation failed. |
**示例:**
```
js
try
{
access
.
enableBluetooth
();
}
catch
(
err
)
{
console
.
error
(
'
errCode:
'
+
err
.
code
+
'
, errMessage:
'
+
err
.
message
);
}
```
## access.disableBluetooth<a name="disableBluetooth"></a>
disableBluetooth(): void
关闭蓝牙。
**需要权限**
:ohos.permission.ACCESS_BLUETOOTH
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
**错误码**
:
以下错误码的详细介绍请参见
[
蓝牙服务子系统错误码
](
../errorcodes/errorcode-bluetoothManager.md
)
。
|错误码ID | 错误信息 |
| -------- | ------------------ |
|2900001 | Service stopped. |
|2900099 | Operation failed. |
**示例:**
```
js
try
{
access
.
disableBluetooth
();
}
catch
(
err
)
{
console
.
error
(
'
errCode:
'
+
err
.
code
+
'
, errMessage:
'
+
err
.
message
);
}
```
## access.getState<a name="getState"></a>
getState(): BluetoothState
获取蓝牙开关状态。
**需要权限**
:ohos.permission.ACCESS_BLUETOOTH
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
**返回值:**
| 类型 | 说明 |
| --------------------------------- | ---------------- |
|
[
BluetoothState
](
#bluetoothstate
)
| 表示蓝牙开关状态。 |
**错误码**
:
以下错误码的详细介绍请参见
[
蓝牙服务子系统错误码
](
../errorcodes/errorcode-bluetoothManager.md
)
。
|错误码ID | 错误信息 |
| -------- | ------------------ |
|2900001 | Service stopped. |
|2900099 | Operation failed. |
**示例:**
```
js
try
{
let
state
=
access
.
getState
();
}
catch
(
err
)
{
console
.
error
(
'
errCode:
'
+
err
.
code
+
'
, errMessage:
'
+
err
.
message
);
}
```
## access.on('stateChange')<a name="stateChange"></a>
on(type: "stateChange", callback: Callback
<
BluetoothState
>
): void
订阅蓝牙设备开关状态事件。
**需要权限**
:ohos.permission.ACCESS_BLUETOOTH
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------- | ----- | ---------------------------------------------------------- |
| type | string | 是 | 填写"stateChange"字符串,表示蓝牙状态改变事件。 |
| callback | Callback
<
[BluetoothState](#bluetoothstate)
>
| 是 | 表示回调函数的入参,蓝牙状态。回调函数由用户创建通过该接口注册。 |
**错误码**
:
以下错误码的详细介绍请参见
[
蓝牙服务子系统错误码
](
../errorcodes/errorcode-bluetoothManager.md
)
。
|错误码ID | 错误信息 |
| -------- | ------------------ |
|2900099 | Operation failed. |
**示例:**
```
js
function
onReceiveEvent
(
data
)
{
console
.
info
(
'
bluetooth state =
'
+
JSON
.
stringify
(
data
));
}
try
{
access
.
on
(
'
stateChange
'
,
onReceiveEvent
);
}
catch
(
err
)
{
console
.
error
(
'
errCode:
'
+
err
.
code
+
'
, errMessage:
'
+
err
.
message
);
}
```
## access.off('stateChange')<a name="stateChange"></a>
off(type: "stateChange", callback?: Callback
<
BluetoothState
>
): void
取消订阅蓝牙设备开关状态事件。
**需要权限**
:ohos.permission.ACCESS_BLUETOOTH
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | ---------------------------------------- |
| type | string | 是 | 填写"stateChange"字符串,表示蓝牙状态改变事件。 |
| callback | Callback
<
[BluetoothState](#bluetoothstate)
>
| 否 | 表示取消订阅蓝牙状态改变事件上报。不填该参数则取消订阅该type对应的所有回调。 |
**错误码**
:
以下错误码的详细介绍请参见
[
蓝牙服务子系统错误码
](
../errorcodes/errorcode-bluetoothManager.md
)
。
| 错误码ID | 错误信息 |
| -------- | ---------------------------- |
|2900099 | Operation failed. |
**示例:**
```
js
function
onReceiveEvent
(
data
)
{
console
.
info
(
'
bluetooth state =
'
+
JSON
.
stringify
(
data
));
}
try
{
access
.
on
(
'
stateChange
'
,
onReceiveEvent
);
access
.
off
(
'
stateChange
'
,
onReceiveEvent
);
}
catch
(
err
)
{
console
.
error
(
'
errCode:
'
+
err
.
code
+
'
, errMessage:
'
+
err
.
message
);
}
```
## BluetoothState<a name="BluetoothState"></a>
枚举,蓝牙开关状态。
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
| 名称 | 值 | 说明 |
| --------------------- | ---- | ------------------ |
| STATE_OFF | 0 | 表示蓝牙已关闭。 |
| STATE_TURNING_ON | 1 | 表示蓝牙正在打开。 |
| STATE_ON | 2 | 表示蓝牙已打开。 |
| STATE_TURNING_OFF | 3 | 表示蓝牙正在关闭。 |
| STATE_BLE_TURNING_ON | 4 | 表示蓝牙正在打开LE-only模式。 |
| STATE_BLE_ON | 5 | 表示蓝牙正处于LE-only模式。 |
| STATE_BLE_TURNING_OFF | 6 | 表示蓝牙正在关闭LE-only模式。 |
zh-cn/application-dev/reference/apis/js-apis-bluetooth-baseProfile.md
0 → 100644
浏览文件 @
a488a554
# @ohos.bluetooth.baseProfile (蓝牙baseProfile模块)
baseProfile模块提供了基础的profile方法。
> **说明:**
>
> 本模块首批接口从API version 10开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块
```
js
import
baseProfile
from
'
@ohos.bluetooth.baseProfile
'
;
```
## ConnectionStrategy<a name="ConnectionStrategy"></a>
枚举,表示Profile的连接策略。
**系统接口:**
此接口为系统接口。
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
| 名称 | 值 | 说明 |
| -------------------------------- | ------ | --------------- |
| CONNECTION_STRATEGY_UNSUPPORTED | 0 | 当设备未配对时的默认连接策略。
<br/>
此接口为系统接口。 |
| CONNECTION_STRATEGY_ALLOWED | 1 | 设备允许接受或发起配对时的连接策略。
<br/>
此接口为系统接口。 |
| CONNECTION_STRATEGY_FORBIDDEN | 2 | 设备不允许接受或发起配对时的连接策略。
<br/>
此接口为系统接口。 |
## StateChangeParam<a name="StateChangeParam"></a>
描述profile状态改变参数。
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
| 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | ----------------------------- | ---- | ---- | ------------------------------- |
| deviceId | string | 是 | 否 | 表示蓝牙设备地址。 |
| state | ProfileConnectionState | 是 | 否 | 表示蓝牙设备的profile连接状态。 |
## baseProfile.setConnectionStrategy<a name="setConnectionStrategy"></a>
setConnectionStrategy(deviceId: string, strategy: ConnectionStrategy, callback: AsyncCallback
<
void
>
): void
设置该设备Profile的连接策略。
**系统接口**
:此接口为系统接口。
**需要权限**
:ohos.permission.ACCESS_BLUETOOTH 和 ohos.permission.MANAGE_BLUETOOTH
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------ | ---- | ----------------------------------- |
| deviceId | string | 是 | 表示配对的远端设备地址,例如:"XX:XX:XX:XX:XX:XX"。 |
| strategy |
[
ConnectionStrategy
](
#connectionstrategy
)
| 是 |Profile的连接策略。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数。当设置成功,err为undefined,否则为错误对象。 |
**错误码**
:
以下错误码的详细介绍请参见
[
蓝牙服务子系统错误码
](
../errorcodes/errorcode-bluetoothManager.md
)
。
| 错误码ID | 错误信息 |
| -------- | ---------------------------- |
|2900001 | Service stopped. |
|2900003 | Bluetooth switch is off. |
|2900004 | Profile is not supported. |
|2900099 | Operation failed. |
**示例:**
```
js
import
a2dp
from
'
@ohos.bluetooth.a2dp
'
;
try
{
let
a2dpSrc
=
a2dp
.
createA2dpSrcProfile
();
let
setRet
=
a2dpSrc
.
setConnectionStrategy
(
'
XX:XX:XX:XX:XX:XX
'
,
0
,
(
err
,
data
)
=>
{
console
.
info
(
'
setConnectionStrategy, err:
'
+
JSON
.
stringify
(
err
)
+
'
, data:
'
+
JSON
.
stringify
(
data
));
});
}
catch
(
err
)
{
console
.
error
(
'
errCode:
'
+
err
.
code
+
'
, errMessage:
'
+
err
.
message
);
}
```
## baseProfile.setConnectionStrategy<a name="setConnectionStrategy"></a>
setConnectionStrategy(deviceId: string, strategy: ConnectionStrategy): Promise
<
void
>
设置该设备Profile的连接策略。
**系统接口**
:此接口为系统接口。
**需要权限**
:ohos.permission.ACCESS_BLUETOOTH 和 ohos.permission.MANAGE_BLUETOOTH
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------ | ---- | ----------------------------------- |
| deviceId | string | 是 | 表示配对的远端设备地址,例如:"XX:XX:XX:XX:XX:XX"。 |
| strategy |
[
ConnectionStrategy
](
#connectionstrategy
)
| 是 |Profile的连接策略。 |
**返回值:**
| 类型 | 说明 |
| ------------------- | ------------- |
| Promise
<
void
>
| 返回promise对象。 |
**错误码**
:
以下错误码的详细介绍请参见
[
蓝牙服务子系统错误码
](
../errorcodes/errorcode-bluetoothManager.md
)
。
| 错误码ID | 错误信息 |
| -------- | ---------------------------- |
|2900001 | Service stopped. |
|2900003 | Bluetooth switch is off. |
|2900004 | Profile is not supported. |
|2900099 | Operation failed. |
**示例:**
```
js
import
a2dp
from
'
@ohos.bluetooth.a2dp
'
;
try
{
let
a2dpSrc
=
a2dp
.
createA2dpSrcProfile
();
let
setRet
=
a2dpSrc
.
setConnectionStrategy
(
'
XX:XX:XX:XX:XX:XX
'
,
1
).
then
((
data
)
=>
{
console
.
info
(
'
setConnectionStrategy
'
);
},
(
err
)
=>
{
console
.
error
(
'
setConnectionStrategy errCode:
'
+
err
.
code
+
'
, errMessage:
'
+
err
.
message
);
});
}
catch
(
err
)
{
console
.
error
(
'
errCode:
'
+
err
.
code
+
'
, errMessage:
'
+
err
.
message
);
}
```
## baseProfile.getConnectionStrategy<a name="getConnectionStrategy"></a>
getConnectionStrategy(deviceId: string, callback: AsyncCallback
<
ConnectionStrategy
>
): void
获取该Profile的连接策略。
**系统接口**
:此接口为系统接口。
**需要权限**
:ohos.permission.ACCESS_BLUETOOTH 和 ohos.permission.MANAGE_BLUETOOTH
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------ | ---- | ----------------------------------- |
| deviceId | string | 是 | 表示配对的远端设备地址,例如:"XX:XX:XX:XX:XX:XX"。 |
| callback | AsyncCallback
<
[ConnectionStrategy](#connectionstrategy)
>
| 是 | 回调函数。当获取策略成功,err为undefined,否则为错误对象。 |
**错误码**
:
以下错误码的详细介绍请参见
[
蓝牙服务子系统错误码
](
../errorcodes/errorcode-bluetoothManager.md
)
。
| 错误码ID | 错误信息 |
| -------- | ---------------------------- |
|2900001 | Service stopped. |
|2900003 | Bluetooth switch is off. |
|2900004 | Profile is not supported. |
|2900099 | Operation failed. |
**示例:**
```
js
import
a2dp
from
'
@ohos.bluetooth.a2dp
'
;
try
{
let
a2dpSrc
=
a2dp
.
createA2dpSrcProfile
();
let
setRet
=
a2dpSrc
.
getConnectionStrategy
(
'
XX:XX:XX:XX:XX:XX
'
,
0
,
(
err
,
data
)
=>
{
console
.
info
(
'
getConnectionStrategy, err:
'
+
JSON
.
stringify
(
err
)
+
'
, data:
'
+
JSON
.
stringify
(
data
));
});
}
catch
(
err
)
{
console
.
error
(
'
errCode:
'
+
err
.
code
+
'
, errMessage:
'
+
err
.
message
);
}
```
## baseProfile.getConnectionStrategy<a name="getConnectionStrategy"></a>
getConnectionStrategy(deviceId: string): Promise
<
ConnectionStrategy
>
获取该Profile的连接策略。
**系统接口**
:此接口为系统接口。
**需要权限**
:ohos.permission.ACCESS_BLUETOOTH 和 ohos.permission.MANAGE_BLUETOOTH
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------ | ---- | ----------------------------------- |
| deviceId | string | 是 | 表示配对的远端设备地址,例如:"XX:XX:XX:XX:XX:XX"。 |
**返回值:**
| 类型 | 说明 |
| ------------------- | ------------- |
| Promise
<
[ConnectionStrategy](#connectionstrategy)
>
| 返回promise对象。 |
**错误码**
:
以下错误码的详细介绍请参见
[
蓝牙服务子系统错误码
](
../errorcodes/errorcode-bluetoothManager.md
)
。
| 错误码ID | 错误信息 |
| -------- | ---------------------------- |
|2900001 | Service stopped. |
|2900003 | Bluetooth switch is off. |
|2900004 | Profile is not supported. |
|2900099 | Operation failed. |
**示例:**
```
js
import
a2dp
from
'
@ohos.bluetooth.a2dp
'
;
try
{
let
a2dpSrc
=
a2dp
.
createA2dpSrcProfile
();
let
setRet
=
a2dpSrc
.
getConnectionStrategy
(
'
XX:XX:XX:XX:XX:XX
'
,
1
).
then
((
data
)
=>
{
console
.
info
(
'
getConnectionStrategy
'
);
},
(
error
)
=>
{
console
.
error
(
'
getConnectionStrategy errCode:
'
+
err
.
code
+
'
, errMessage:
'
+
err
.
message
);
});
}
catch
(
err
)
{
console
.
error
(
'
errCode:
'
+
err
.
code
+
'
, errMessage:
'
+
err
.
message
);
}
```
## baseProfile.getConnectedDevices<a name="getConnectedDevices"></a>
getConnectedDevices(): Array
<
string
>
获取已连接设备列表。
**需要权限**
:ohos.permission.ACCESS_BLUETOOTH
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
**返回值:**
| 类型 | 说明 |
| ------------------- | ------------------- |
| Array
<
string
>
| 返回当前已连接设备的地址。 |
**错误码**
:
以下错误码的详细介绍请参见
[
蓝牙服务子系统错误码
](
../errorcodes/errorcode-bluetoothManager.md
)
。
| 错误码ID | 错误信息 |
| -------- | ---------------------------- |
|2900001 | Service stopped. |
|2900003 | Bluetooth switch is off. |
|2900004 | Profile is not supported. |
|2900099 | Operation failed. |
**示例:**
```
js
import
a2dp
from
'
@ohos.bluetooth.a2dp
'
;
try
{
let
a2dpSrc
=
a2dp
.
createA2dpSrcProfile
();
let
retArray
=
a2dpSrc
.
getConnectedDevices
();
}
catch
(
err
)
{
console
.
error
(
"
errCode:
"
+
err
.
code
+
"
,errMessage:
"
+
err
.
message
);
}
```
## baseProfile.getConnectionState<a name="getConnectionState"></a>
getConnectionState(deviceId: string): ProfileConnectionState
获取设备profile的连接状态。
**需要权限**
:ohos.permission.ACCESS_BLUETOOTH
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------- |
| deviceId | string | 是 | 远端设备地址。 |
**返回值:**
| 类型 | 说明 |
| ------------------------------------------------- | ----------------------- |
|
[
ProfileConnectionState
](
js-apis-bluetooth-constant.md#profileconnectionstate
)
| 返回profile的连接状态。 |
**错误码**
:
以下错误码的详细介绍请参见
[
蓝牙服务子系统错误码
](
../errorcodes/errorcode-bluetoothManager.md
)
。
| 错误码ID | 错误信息 |
| -------- | ---------------------------- |
|2900001 | Service stopped. |
|2900003 | Bluetooth switch is off. |
|2900004 | Profile is not supported. |
|2900099 | Operation failed. |
**示例:**
```
js
import
a2dp
from
'
@ohos.bluetooth.a2dp
'
;
try
{
let
a2dpSrc
=
a2dp
.
createA2dpSrcProfile
();
let
ret
=
a2dpSrc
.
getConnectionState
(
'
XX:XX:XX:XX:XX:XX
'
);
}
catch
(
err
)
{
console
.
error
(
'
errCode:
'
+
err
.
code
+
'
, errMessage:
'
+
err
.
message
);
}
```
## baseProfile.on('connectionStateChange')
on(type: 'connectionStateChange', callback: Callback
<
StateChangeParam
>
): void
订阅连接状态变化事件。
**需要权限**
:ohos.permission.ACCESS_BLUETOOTH
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | ---------------------------------------- |
| type | string | 是 | 填写"connectionStateChange"字符串,表示连接状态变化事件。 |
| callback | Callback
<
[StateChangeParam](#statechangeparam)
>
| 是 | 表示回调函数的入参。 |
**示例:**
```
js
import
a2dp
from
'
@ohos.bluetooth.a2dp
'
;
try
{
function
onReceiveEvent
(
data
)
{
console
.
info
(
'
a2dp state =
'
+
JSON
.
stringify
(
data
));
}
let
a2dpSrc
=
a2dp
.
createA2dpSrcProfile
();
a2dpSrc
.
on
(
'
connectionStateChange
'
,
onReceiveEvent
);
}
catch
(
err
)
{
console
.
error
(
'
errCode:
'
+
err
.
code
+
'
, errMessage:
'
+
err
.
message
);
}
```
## baseProfile.off('connectionStateChange')
off(type: 'connectionStateChange', callback?: Callback
<
[StateChangeParam](#StateChangeParam)
>
): void
取消订阅a2dp连接状态变化事件。
**需要权限**
:ohos.permission.ACCESS_BLUETOOTH
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | ---------------------------------------- |
| type | string | 是 | 填写"connectionStateChange"字符串,表示连接状态变化事件。 |
| callback | Callback
<
[StateChangeParam](#StateChangeParam)
>
| 否 | 表示回调函数的入参。 |
**示例:**
```
js
import
a2dp
from
'
@ohos.bluetooth.a2dp
'
;
try
{
function
onReceiveEvent
(
data
)
{
console
.
info
(
'
a2dp state =
'
+
JSON
.
stringify
(
data
));
}
let
a2dpSrc
=
a2dp
.
createA2dpSrcProfile
();
a2dpSrc
.
on
(
'
connectionStateChange
'
,
onReceiveEvent
);
a2dpSrc
.
off
(
'
connectionStateChange
'
,
onReceiveEvent
);
}
catch
(
err
)
{
console
.
error
(
'
errCode:
'
+
err
.
code
+
'
, errMessage:
'
+
err
.
message
);
}
```
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-bluetooth-ble.md
0 → 100644
浏览文件 @
a488a554
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-bluetooth-connection.md
0 → 100644
浏览文件 @
a488a554
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-bluetooth-constant.md
0 → 100644
浏览文件 @
a488a554
# @ohos.bluetooth.constant (蓝牙constant模块)
constant模块提供了蓝牙中常量的定义。
> **说明:**
>
> 本模块首批接口从API version 10开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块
```
js
import
constant
from
'
@ohos.bluetooth.constant
'
;
```
## ProfileId<a name="ProfileId"></a>
蓝牙profile枚举。
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
| 名称 | 值 | 说明 |
| -------------------------------- | ------ | --------------- |
| PROFILE_A2DP_SOURCE | 1 | 表示A2DP profile。 |
| PROFILE_HANDSFREE_AUDIO_GATEWAY | 4 | 表示HFP profile。 |
| PROFILE_HID_HOST | 6 | 表示HID profile。 |
| PROFILE_PAN_NETWORK | 7 | 表示PAN profile。 |
## ProfileUuids<a name="ProfileUuids"></a>
枚举,表示Profile的UUID。
**系统接口:**
此接口为系统接口。
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
| 名称 | 值 | 说明 |
| ------------------------------------| ------ | --------------- |
| PROFILE_UUID_HFP_AG | '0000111F-0000-1000-8000-00805F9B34FB' | 代表HFPAG Profile的UUID。
<br/>
此接口为系统接口。 |
| PROFILE_UUID_HFP_HF | '0000111E-0000-1000-8000-00805F9B34FB' | 代表HFPHF Profile的UUID。
<br/>
此接口为系统接口。 |
| PROFILE_UUID_HSP_AG | '00001112-0000-1000-8000-00805F9B34FB' | 代表HSPAG Profile的UUID。
<br/>
此接口为系统接口。 |
| PROFILE_UUID_HSP_HS | '00001108-0000-1000-8000-00805F9B34FB' | 代表HSPHS Profile的UUID。
<br/>
此接口为系统接口。 |
| PROFILE_UUID_A2DP_SRC | '0000110A-0000-1000-8000-00805F9B34FB' | 代表A2DPSRC Profile的UUID。
<br/>
此接口为系统接口。 |
| PROFILE_UUID_A2DP_SINK | '0000110B-0000-1000-8000-00805F9B34FB' | 代表A2DPSINK Profile的UUID。
<br/>
此接口为系统接口。 |
| PROFILE_UUID_AVRCP_CT | '0000110E-0000-1000-8000-00805F9B34FB' | 代表AVRCPCT Profile的UUID。
<br/>
此接口为系统接口。 |
| PROFILE_UUID_AVRCP_TG | '0000110C-0000-1000-8000-00805F9B34FB' | 代表AVRCPTG Profile的UUID。
<br/>
此接口为系统接口。 |
| PROFILE_UUID_HID | '00001124-0000-1000-8000-00805F9B34FB' | 代表HID Profile的UUID。
<br/>
此接口为系统接口。 |
| PROFILE_UUID_HOGP | '00001812-0000-1000-8000-00805F9B34FB' | 代表HOGP Profile的UUID。
<br/>
此接口为系统接口。 |
## ProfileConnectionState
枚举,蓝牙设备的profile连接状态。
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
| 名称 | 值 | 说明 |
| ------------------- | ---- | -------------- |
| STATE_DISCONNECTED | 0 | 表示profile已断连。 |
| STATE_CONNECTING | 1 | 表示profile正在连接。 |
| STATE_CONNECTED | 2 | 表示profile已连接。 |
| STATE_DISCONNECTING | 3 | 表示profile正在断连。 |
## MajorClass<a name="MajorClass"></a>
枚举,蓝牙设备主要类别。
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
| 名称 | 值 | 说明 |
| ------------------- | ------ | ---------- |
| MAJOR_MISC | 0x0000 | 表示杂项设备。 |
| MAJOR_COMPUTER | 0x0100 | 表示计算机设备。 |
| MAJOR_PHONE | 0x0200 | 表示手机设备。 |
| MAJOR_NETWORKING | 0x0300 | 表示网络设备。 |
| MAJOR_AUDIO_VIDEO | 0x0400 | 表示音频和视频设备。 |
| MAJOR_PERIPHERAL | 0x0500 | 表示外围设备。 |
| MAJOR_IMAGING | 0x0600 | 表示成像设备。 |
| MAJOR_WEARABLE | 0x0700 | 表示可穿戴设备。 |
| MAJOR_TOY | 0x0800 | 表示玩具设备。 |
| MAJOR_HEALTH | 0x0900 | 表示健康设备。 |
| MAJOR_UNCATEGORIZED | 0x1F00 | 表示未分类设备。 |
## MajorMinorClass<a name="MajorMinorClass"></a>
枚举,主要次要蓝牙设备类别。
**系统能力**
:SystemCapability.Communication.Bluetooth.Core。
| 名称 | 值 | 说明 |
| ---------------------------------------- | ------ | --------------- |
| COMPUTER_UNCATEGORIZED | 0x0100 | 表示未分类计算机设备。 |
| COMPUTER_DESKTOP | 0x0104 | 表示台式计算机设备。 |
| COMPUTER_SERVER | 0x0108 | 表示服务器设备。 |
| COMPUTER_LAPTOP | 0x010C | 表示便携式计算机设备。 |
| COMPUTER_HANDHELD_PC_PDA | 0x0110 | 表示手持式计算机设备。 |
| COMPUTER_PALM_SIZE_PC_PDA | 0x0114 | 表示掌上电脑设备。 |
| COMPUTER_WEARABLE | 0x0118 | 表示可穿戴计算机设备。 |
| COMPUTER_TABLET | 0x011C | 表示平板电脑设备。 |
| PHONE_UNCATEGORIZED | 0x0200 | 表示未分类手机设备。 |
| PHONE_CELLULAR | 0x0204 | 表示便携式手机设备。 |
| PHONE_CORDLESS | 0x0208 | 表示无线电话设备。 |
| PHONE_SMART | 0x020C | 表示智能手机设备。 |
| PHONE_MODEM_OR_GATEWAY | 0x0210 | 表示调制解调器或网关手机设备。 |
| PHONE_ISDN | 0x0214 | 表示ISDN手机设备。 |
| NETWORK_FULLY_AVAILABLE | 0x0300 | 表示网络完全可用设备。 |
| NETWORK_1_TO_17_UTILIZED | 0x0320 | 表示使用网络1到17设备。 |
| NETWORK_17_TO_33_UTILIZED | 0x0340 | 表示使用网络17到33设备。 |
| NETWORK_33_TO_50_UTILIZED | 0x0360 | 表示使用网络33到50设备。 |
| NETWORK_60_TO_67_UTILIZED | 0x0380 | 表示使用网络60到67设备。 |
| NETWORK_67_TO_83_UTILIZED | 0x03A0 | 表示使用网络67到83设备。 |
| NETWORK_83_TO_99_UTILIZED | 0x03C0 | 表示使用网络83到99设备。 |
| NETWORK_NO_SERVICE | 0x03E0 | 表示网络无服务设备。 |
| AUDIO_VIDEO_UNCATEGORIZED | 0x0400 | 表示未分类音频视频设备。 |
| AUDIO_VIDEO_WEARABLE_HEADSET | 0x0404 | 表示可穿戴式音频视频设备。 |
| AUDIO_VIDEO_HANDSFREE | 0x0408 | 表示免提音频视频设备。 |
| AUDIO_VIDEO_MICROPHONE | 0x0410 | 表示麦克风音频视频设备。 |
| AUDIO_VIDEO_LOUDSPEAKER | 0x0414 | 表示扬声器音频视频设备。 |
| AUDIO_VIDEO_HEADPHONES | 0x0418 | 表示头戴式音频视频设备。 |
| AUDIO_VIDEO_PORTABLE_AUDIO | 0x041C | 表示便携式音频视频设备。 |
| AUDIO_VIDEO_CAR_AUDIO | 0x0420 | 表示汽车音频视频设备。 |
| AUDIO_VIDEO_SET_TOP_BOX | 0x0424 | 表示机顶盒音频视频设备。 |
| AUDIO_VIDEO_HIFI_AUDIO | 0x0428 | 表示高保真音响设备。 |
| AUDIO_VIDEO_VCR | 0x042C | 表示录像机音频视频设备。 |
| AUDIO_VIDEO_VIDEO_CAMERA | 0x0430 | 表示照相机音频视频设备。 |
| AUDIO_VIDEO_CAMCORDER | 0x0434 | 表示摄像机音频视频设备。 |
| AUDIO_VIDEO_VIDEO_MONITOR | 0x0438 | 表示监视器音频视频设备。 |
| AUDIO_VIDEO_VIDEO_DISPLAY_AND_LOUDSPEAKER | 0x043C | 表示视频显示器和扬声器设备。 |
| AUDIO_VIDEO_VIDEO_CONFERENCING | 0x0440 | 表示音频视频会议设备。 |
| AUDIO_VIDEO_VIDEO_GAMING_TOY | 0x0448 | 表示游戏玩具音频视频设备。 |
| PERIPHERAL_NON_KEYBOARD_NON_POINTING | 0x0500 | 表示非键盘非指向外围设备。 |
| PERIPHERAL_KEYBOARD | 0x0540 | 表示外设键盘设备。 |
| PERIPHERAL_POINTING_DEVICE | 0x0580 | 表示定点装置外围设备。 |
| PERIPHERAL_KEYBOARD_POINTING | 0x05C0 | 表示键盘指向外围设备。 |
| PERIPHERAL_UNCATEGORIZED | 0x0500 | 表示未分类外围设备。 |
| PERIPHERAL_JOYSTICK | 0x0504 | 表示周边操纵杆设备。 |
| PERIPHERAL_GAMEPAD | 0x0508 | 表示周边游戏板设备。 |
| PERIPHERAL_REMOTE_CONTROL | 0x05C0 | 表示远程控制外围设备。 |
| PERIPHERAL_SENSING_DEVICE | 0x0510 | 表示外围传感设备设备。 |
| PERIPHERAL_DIGITIZER_TABLET | 0x0514 | 表示外围数字化仪平板电脑设备。 |
| PERIPHERAL_CARD_READER | 0x0518 | 表示外围读卡器设备。 |
| PERIPHERAL_DIGITAL_PEN | 0x051C | 表示外设数码笔设备。 |
| PERIPHERAL_SCANNER_RFID | 0x0520 | 表示射频识别扫描仪外围设备。 |
| PERIPHERAL_GESTURAL_INPUT | 0x0522 | 表示手势输入外围设备。 |
| IMAGING_UNCATEGORIZED | 0x0600 | 表示未分类的图像设备。 |
| IMAGING_DISPLAY | 0x0610 | 表示图像显示设备。 |
| IMAGING_CAMERA | 0x0620 | 表示成像照相机设备。 |
| IMAGING_SCANNER | 0x0640 | 表示成像扫描仪设备。 |
| IMAGING_PRINTER | 0x0680 | 表示成像打印机设备。 |
| WEARABLE_UNCATEGORIZED | 0x0700 | 表示未分类的可穿戴设备。 |
| WEARABLE_WRIST_WATCH | 0x0704 | 表示可穿戴腕表设备。 |
| WEARABLE_PAGER | 0x0708 | 表示可穿戴寻呼机设备。 |
| WEARABLE_JACKET | 0x070C | 表示夹克可穿戴设备。 |
| WEARABLE_HELMET | 0x0710 | 表示可穿戴头盔设备。 |
| WEARABLE_GLASSES | 0x0714 | 表示可穿戴眼镜设备。 |
| TOY_UNCATEGORIZED | 0x0800 | 表示未分类的玩具设备。 |
| TOY_ROBOT | 0x0804 | 表示玩具机器人设备。 |
| TOY_VEHICLE | 0x0808 | 表示玩具车设备。 |
| TOY_DOLL_ACTION_FIGURE | 0x080C | 表示人形娃娃玩具设备。 |
| TOY_CONTROLLER | 0x0810 | 表示玩具控制器设备。 |
| TOY_GAME | 0x0814 | 表示玩具游戏设备。 |
| HEALTH_UNCATEGORIZED | 0x0900 | 表示未分类健康设备。 |
| HEALTH_BLOOD_PRESSURE | 0x0904 | 表示血压健康设备。 |
| HEALTH_THERMOMETER | 0x0908 | 表示温度计健康设备。 |
| HEALTH_WEIGHING | 0x090C | 表示体重健康设备。 |
| HEALTH_GLUCOSE | 0x0910 | 表示葡萄糖健康设备。 |
| HEALTH_PULSE_OXIMETER | 0x0914 | 表示脉搏血氧仪健康设备。 |
| HEALTH_PULSE_RATE | 0x0918 | 表示脉搏率健康设备。 |
| HEALTH_DATA_DISPLAY | 0x091C | 表示数据显示健康设备。 |
| HEALTH_STEP_COUNTER | 0x0920 | 表示阶梯计数器健康设备。 |
| HEALTH_BODY_COMPOSITION_ANALYZER | 0x0924 | 表示身体成分分析仪健康设备。 |
| HEALTH_PEAK_FLOW_MONITOR | 0x0928 | 表示湿度计健康设备。 |
| HEALTH_MEDICATION_MONITOR | 0x092C | 表示药物监视仪健康设备。 |
| HEALTH_KNEE_PROSTHESIS | 0x0930 | 表示膝盖假肢健康设备。 |
| HEALTH_ANKLE_PROSTHESIS | 0x0934 | 表示脚踝假肢健康设备。 |
| HEALTH_GENERIC_HEALTH_MANAGER | 0x0938 | 表示通用健康管理设备。 |
| HEALTH_PERSONAL_MOBILITY_DEVICE | 0x093C | 表示个人移动健康设备。 |
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-bluetooth-hfp.md
0 → 100644
浏览文件 @
a488a554
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-bluetooth-hid.md
0 → 100644
浏览文件 @
a488a554
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-bluetooth-pan.md
0 → 100644
浏览文件 @
a488a554
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-bluetooth-socket.md
0 → 100644
浏览文件 @
a488a554
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-bluetoothManager.md
浏览文件 @
a488a554
此差异已折叠。
点击以展开。
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录