使用SoundPlayer开发系统音效播放功能

支持的音效类型

支持的音效类型SystemSoundType信息如下表所示。可通过systemSoundManager.SystemSoundType.PHOTO_SHUTTER等具体类型，作为load、play或unload方法的入参。

开发步骤

以下各步骤示例为片段代码，可通过点击示例代码右下方的链接获取完整示例。

1. 在调用SystemSoundPlayer的接口前，需要先通过createSystemSoundPlayer创建实例。

   收起

   自动换行

   深色代码主题

   复制

   import { systemSoundManager } from '@kit.AudioKit';
   // ...
   
   // SystemSoundPlayer对象。
   let systemSoundPlayer: systemSoundManager.SystemSoundPlayer | null = null;
   
   // ...
     systemSoundManager.createSystemSoundPlayer().then((systemSoundPlayerInstance) => {
       console.info('Succeeded in creating the system sound player.');
       systemSoundPlayer = systemSoundPlayerInstance;
     }).catch((err: BusinessError) => {
       console.error(`Failed to create the system sound player. Code: ${err.code}, message: ${err.message}`);
     });

   SoundPlayer.ets

2. 调用load接口，加载指定类型音效资源。

   收起

   自动换行

   深色代码主题

   复制

   import { systemSoundManager } from '@kit.AudioKit';
   // ...
   
   // 音效类型。
   let systemSoundType: systemSoundManager.SystemSoundType = systemSoundManager.SystemSoundType.PHOTO_SHUTTER;
   
   // ...
     systemSoundPlayer?.load(systemSoundType).then(() => {
       console.info('Succeeded in calling the load method.');
     }).catch((err: BusinessError) => {
       console.error(`Failed to call the load method. Code: ${err.code}, message: ${err.message}`);
     });

   SoundPlayer.ets

3. 调用play接口，播放已加载的音效资源。

   收起

   自动换行

   深色代码主题

   复制

   import { systemSoundManager } from '@kit.AudioKit';
   // ...
   
   // 音效类型。
   let systemSoundType: systemSoundManager.SystemSoundType = systemSoundManager.SystemSoundType.PHOTO_SHUTTER;
   
   // ...
     systemSoundPlayer?.play(systemSoundType).then(() => {
       console.info('Succeeded in calling the play method.');
     }).catch((err: BusinessError) => {
       console.error(`Failed to call the play method. Code: ${err.code}, message: ${err.message}`);
     });

   SoundPlayer.ets

4. 调用unload接口，卸载之前已加载的音效资源。

   收起

   自动换行

   深色代码主题

   复制

   import { systemSoundManager } from '@kit.AudioKit';
   // ...
   
   // 音效类型。
   let systemSoundType: systemSoundManager.SystemSoundType = systemSoundManager.SystemSoundType.PHOTO_SHUTTER;
   
   // ...
     systemSoundPlayer?.unload(systemSoundType).then(() => {
       console.info('Succeeded in calling the unload method.');
     }).catch((err: BusinessError) => {
       console.error(`Failed to call the unload method. Code: ${err.code}, message: ${err.message}`);
     });

   SoundPlayer.ets

5. 调用release接口，释放系统音效播放器。

   收起

   自动换行

   深色代码主题

   复制

   systemSoundPlayer?.release().then(() => {
     console.info('Succeeded in calling the release method.');
   }).catch((err: BusinessError) => {
     console.error(`Failed to call the release method. Code: ${err.code}, message: ${err.message}`);
   });

   SoundPlayer.ets