鸿蒙Next ArkTS音频播放功能如何实现

我想在鸿蒙Next上用ArkTS实现音频播放功能，但不太清楚具体该怎么做。能请教下如何实现基础的音频播放吗？需要导入哪些模块？能不能给个简单的代码示例说明播放本地音频文件的流程？

1 回复

更多关于鸿蒙Next ArkTS音频播放功能如何实现的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


在鸿蒙Next中，使用ArkTS实现音频播放功能主要通过@ohos.multimedia.audio模块实现。以下是实现步骤和示例代码：

1. 添加权限

在module.json5中添加音频播放权限：

{
  "module": {
    "requestPermissions": [
      {
        "name": "ohos.permission.MICROPHONE"
      }
    ]
  }
}

2. 导入音频模块

import audio from '@ohos.multimedia.audio';

3. 创建音频播放器

// 获取音频管理器
let audioManager = audio.getAudioManager();
// 创建播放器
let audioPlayer: audio.AudioPlayer;
audioManager.createAudioPlayer((err, player) => {
  if (!err) {
    audioPlayer = player;
    console.info('AudioPlayer created successfully');
  }
});

4. 配置播放参数并准备播放

// 设置播放源（支持本地路径和网络URL）
let source = { 
  source: '/data/storage/el2/base/haps/entry/files/music.mp3', // 替换为实际路径
  loop: false  // 是否循环播放
};

audioPlayer.on('prepare', () => {
  console.info('AudioPlayer prepared');
  audioPlayer.play(); // 开始播放
});

audioPlayer.on('play', () => {
  console.info('AudioPlayer started playing');
});

// 准备播放
audioPlayer.prepare(source, (err) => {
  if (err) {
    console.error('Prepare failed');
  }
});

5. 控制播放

// 暂停
audioPlayer.pause();

// 停止（需重新prepare才能再次播放）
audioPlayer.stop();

// 跳转（单位：毫秒）
audioPlayer.seek(30000);

// 释放资源
audioPlayer.release();

6. 监听播放状态

audioPlayer.on('finish', () => {
  console.info('Playback finished');
});

audioPlayer.on('error', (err) => {
  console.error('Playback error: ' + JSON.stringify(err));
});

完整示例

import audio from '@ohos.multimedia.audio';

@Entry
@Component
struct AudioPlayerExample {
  private audioPlayer: audio.AudioPlayer | null = null;

  aboutToAppear() {
    this.initAudioPlayer();
  }

  initAudioPlayer() {
    let audioManager = audio.getAudioManager();
    audioManager.createAudioPlayer((err, player) => {
      if (!err) {
        this.audioPlayer = player;
        this.setupPlayer();
      }
    });
  }

  setupPlayer() {
    let source = {
      source: 'path/to/your/audio.mp3',
      loop: false
    };

    this.audioPlayer.on('prepare', () => {
      this.audioPlayer.play();
    });

    this.audioPlayer.prepare(source, (err) => {
      if (err) {
        console.error('Prepare failed');
      }
    });
  }

  // 在UI中绑定控制按钮
  build() {
    Column() {
      Button('Play').onClick(() => {
        this.audioPlayer.play();
      })
      Button('Pause').onClick(() => {
        this.audioPlayer.pause();
      })
    }
  }
}

注意事项：

  1. 确保音频文件路径正确
  2. 网络音频需要网络权限
  3. 及时调用release()释放资源
  4. 支持的音频格式：MP3、AAC、WAV等常见格式

通过以上代码即可实现基本的音频播放控制功能。

回到顶部