• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# @ohos.bluetooth.pan (蓝牙pan模块)
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本模块提供基于蓝牙个人局域网协议(Personal Area Networking,[PAN](../../connectivity/terminology.md#pan))的蓝牙共享网络能力,支持获取连接状态等方法。
11
12> **说明:**
13>
14> 本模块首批接口从API version 10开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
15
16## 导入模块
17
18```js
19import { pan } from '@kit.ConnectivityKit';
20```
21
22## BaseProfile
23
24type BaseProfile = baseProfile.BaseProfile
25
26基础Profile接口定义,提供订阅和获取连接状态等公共能力。
27
28**系统能力**:SystemCapability.Communication.Bluetooth.Core
29
30| 类型                            | 说明         |
31| ----------------------------- | ---------- |
32| [baseProfile.BaseProfile](js-apis-bluetooth-baseProfile.md#baseprofile) | 基础Profile接口定义。 |
33
34## pan.createPanProfile
35
36createPanProfile(): PanProfile
37
38创建蓝牙[NAP](../../connectivity/terminology.md#nap)实例。通过该实例可使用本端作为NAP设备的接口,如:获取和其他设备间的蓝牙个人局域网服务连接状态。
39
40**系统能力**:SystemCapability.Communication.Bluetooth.Core
41
42**返回值:**
43
44| 类型                            | 说明         |
45| ----------------------------- | ---------- |
46| PanProfile | 返回NAP实例。<br>- 该类继承于[BaseProfile](#baseprofile),因此可以使用其父类中的方法。<br>- 和该实例角色相对应的是[PANU](../../connectivity/terminology.md#panu)角色。 |
47
48**错误码**:
49
50以下错误码的详细介绍请参见[蓝牙服务子系统错误码](errorcode-bluetoothManager.md)。
51
52| 错误码ID | 错误信息 |
53| -------- | ---------------------------- |
54|401 | Invalid parameter. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. 3. Parameter verification failed.                 |
55|801 | Capability not supported.          |
56
57**示例:**
58
59```js
60import { BusinessError } from '@kit.BasicServicesKit';
61
62try {
63    let panProfile : pan.PanProfile= pan.createPanProfile();
64    console.info('pan success');
65} catch (err) {
66    console.error('errCode: ' + (err as BusinessError).code + ', errMessage: ' + (err as BusinessError).message);
67}
68```
69