1# @ohos.bluetooth.hfp (蓝牙hfp模块)
2
3hfp模块提供了访问蓝牙呼叫接口的方法。
4
5> **说明：**
6>
7> 本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
8
9
10
11## 导入模块
12
13```js
14import { hfp } from '@kit.ConnectivityKit';
15```
16
17
18## BaseProfile
19
20type BaseProfile = baseProfile.BaseProfile
21
22基础Profile接口定义
23
24**系统能力**：SystemCapability.Communication.Bluetooth.Core。
25
26| 类型                            | 说明         |
27| ----------------------------- | ---------- |
28| [baseProfile.BaseProfile](js-apis-bluetooth-baseProfile.md#baseprofile) | 基础Profile接口定义。 |
29
30
31## hfp.createHfpAgProfile
32
33createHfpAgProfile(): HandsFreeAudioGatewayProfile
34
35创建hfp profile实例。
36
37**系统能力**：SystemCapability.Communication.Bluetooth.Core。
38
39**返回值：**
40
41| 类型                            | 说明         |
42| ----------------------------- | ---------- |
43| HandsFreeAudioGatewayProfile | 返回该profile的实例。 |
44
45**错误码**：
46
47以下错误码的详细介绍请参见[蓝牙服务子系统错误码](errorcode-bluetoothManager.md)。
48
49| 错误码ID | 错误信息 |
50| -------- | ---------------------------- |
51|401 | Invalid parameter. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. 3. Parameter verification failed.                 |
52|801 | Capability not supported.          |
53
54**示例：**
55
56```js
57import { AsyncCallback, BusinessError } from '@kit.BasicServicesKit';
58try {
59    let hfpAgProfile = hfp.createHfpAgProfile();
60    console.info('hfpAg success');
61} catch (err) {
62    console.error('errCode: ' + (err as BusinessError).code + ', errMessage: ' + (err as BusinessError).message);
63}
64```
65
66
67## HandsFreeAudioGatewayProfile
68
69使用HandsFreeAudioGatewayProfile方法之前需要创建该类的实例进行操作，通过createHfpAgProfile()方法构造此实例。
70