1# 使用AudioHaptic开发音振协同播放功能
2
3AudioHaptic<sup>11+</sup>提供音频与振动协同播放及管理的方法，适用于需要在播放音频时同步发起振动的场景，如来电铃声随振、键盘按键反馈、消息通知反馈等。
4
5## 开发指导
6
7使用AudioHaptic播放音频并同步开启振动，涉及到音频及振动资源的管理、音频时延模式及音频流使用类型的配置、音振播放器的创建及管理等。本开发指导将以一次音振协同播放的过程为例，向开发者讲解如何使用AudioHaptic进行音振协同播放，建议配合[AudioHaptic的API说明](../../reference/apis-audio-kit/js-apis-audioHaptic.md#audiohapticmanager)阅读。
8
9### 权限申请
10
11如果应用创建的AudioHapticPlayer需要触发振动，则需要校验应用是否拥有该权限：`ohos.permission.VIBRATE`。
12
131. [声明权限](../../security/AccessToken/declare-permissions.md)。
142. [向用户申请授权](../../security/AccessToken/request-user-authorization.md)。
15
16### 开发步骤及注意事项
17
181. 获取音振管理器实例，并注册音频及振动资源，资源支持情况可以查看[AudioHapticManager](../../reference/apis-audio-kit/js-apis-audioHaptic.md#audiohapticmanager)。
19
20   ```ts
21   import { audio, audioHaptic } from '@kit.AudioKit';
22   import { BusinessError } from '@kit.BasicServicesKit';
23
24   let audioHapticManagerInstance: audioHaptic.AudioHapticManager = audioHaptic.getAudioHapticManager();
25
26   let audioUri = 'data/audioTest.wav'; // 需更改为目标音频资源的Uri
27   let hapticUri = 'data/hapticTest.json'; // 需更改为目标振动资源的Uri
28   let id = 0;
29
30   audioHapticManagerInstance.registerSource(audioUri, hapticUri).then((value: number) => {
31     console.info(`Promise returned to indicate that the source id of the registerd source ${value}.`);
32     id = value;
33   }).catch ((err: BusinessError) => {
34     console.error(`Failed to register source ${err}`);
35   });
36   ```
37
382. 设置音振播放器参数，各参数作用可以查看[AudioHapticManager](../../reference/apis-audio-kit/js-apis-audioHaptic.md#audiohapticmanager)。
39
40   ```ts
41   let latencyMode: audioHaptic.AudioLatencyMode = audioHaptic.AudioLatencyMode.AUDIO_LATENCY_MODE_FAST;
42   audioHapticManagerInstance.setAudioLatencyMode(id, latencyMode);
43
44   let usage: audio.StreamUsage = audio.StreamUsage.STREAM_USAGE_NOTIFICATION;
45   audioHapticManagerInstance.setStreamUsage(id, usage);
46   ```
47
483. 创建AudioHapticPlayer实例。
49
50   ```ts
51   let options: audioHaptic.AudioHapticPlayerOptions = {muteAudio: false, muteHaptics: false};
52   let audioHapticPlayer: audioHaptic.AudioHapticPlayer | undefined = undefined;
53
54   audioHapticManagerInstance.createPlayer(id, options).then((value: audioHaptic.AudioHapticPlayer) => {
55     console.info(`Promise returned to indicate that the audio haptic player instance.`);
56     audioHapticPlayer = value;
57   }).catch ((err: BusinessError) => {
58     console.error(`Failed to create player ${err}`);
59   });
60   console.info(`Create the audio haptic player successfully.`);
61   ```
62
634. 调用start()方法，开启音频播放并同步开启振动。
64
65   ```ts
66   audioHapticPlayer.start().then(() => {
67     console.info(`Promise returned to indicate that start playing successfully.`);
68   }).catch ((err: BusinessError) => {
69     console.error(`Failed to start playing. ${err}`);
70   });
71   ```
72
735. 调用stop()方法，停止音频播放并同步停止振动。
74
75   ```ts
76   audioHapticPlayer.stop().then(() => {
77     console.info(`Promise returned to indicate that stop playing successfully.`);
78   }).catch ((err: BusinessError) => {
79     console.error(`Failed to stop playing. ${err}`);
80   });
81   ```
82
836. 释放AudioHapticPlayer实例。
84
85   ```ts
86   audioHapticPlayer.release().then(() => {
87     console.info(`Promise returned to indicate that release the audio haptic player successfully.`);
88   }).catch ((err: BusinessError) => {
89     console.error(`Failed to release the audio haptic player. ${err}`);
90   });
91   ```
92
937. 将已注册的音频及振动资源移除注册
94
95   ```ts
96   audioHapticManagerInstance.unregisterSource(id).then(() => {
97     console.info(`Promise returned to indicate that unregister source successfully`);
98   }).catch ((err: BusinessError) => {
99     console.error(`Failed to unregistere source ${err}`);
100   });
101   ```
102
103## 相关实例
104
105针对音振协同开发，有以下相关实例可供参考：
106
107- [音振协同示例（ArkTS）（API11）](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Media/AudioHaptic)
108