如何使用 wx.getBackgroundAudioManager 获取全局唯一的背景音频管理器？

推荐答案

// www.javascriptcn.com code example
// 获取全局唯一的背景音频管理器
const backgroundAudioManager = wx.getBackgroundAudioManager();

// 设置音频源
backgroundAudioManager.src = 'https://example.com/audio.mp3';

// 播放音频
backgroundAudioManager.play();

// 监听播放事件
backgroundAudioManager.onPlay(() => {
  console.log('音频开始播放');
});

// 监听暂停事件
backgroundAudioManager.onPause(() => {
  console.log('音频暂停');
});

// 监听停止事件
backgroundAudioManager.onStop(() => {
  console.log('音频停止');
});

// 监听结束事件
backgroundAudioManager.onEnded(() => {
  console.log('音频播放结束');
});

本题详细解读

1. wx.getBackgroundAudioManager 的作用

wx.getBackgroundAudioManager 是微信小程序提供的一个 API，用于获取全局唯一的背景音频管理器。通过这个管理器，开发者可以控制背景音频的播放、暂停、停止等操作，并且可以监听音频的各种事件。

2. 背景音频管理器的常用属性和方法

• src: 设置或获取音频的播放地址。
• title: 设置或获取音频的标题。
• epname: 设置或获取音频的专辑名称。
• singer: 设置或获取音频的歌手名称。
• coverImgUrl: 设置或获取音频的封面图片地址。
• play(): 播放音频。
• pause(): 暂停音频。
• stop(): 停止音频。
• seek(position): 跳转到指定位置播放音频，position 为时间，单位为秒。
• onPlay(callback): 监听音频播放事件。
• onPause(callback): 监听音频暂停事件。
• onStop(callback): 监听音频停止事件。
• onEnded(callback): 监听音频播放结束事件。

3. 使用场景

wx.getBackgroundAudioManager 通常用于需要在小程序后台播放音频的场景，比如音乐播放器、语音播报等。由于它是全局唯一的，因此在整个小程序中只有一个背景音频管理器实例，适合用于管理全局的音频播放状态。

4. 注意事项

• 背景音频管理器在小程序进入后台后仍然可以继续播放音频。
• 音频播放时，小程序会显示一个音频播放控制条，用户可以通过这个控制条控制音频的播放、暂停、停止等操作。
• 如果音频播放地址是跨域的，需要确保服务器支持跨域访问。

通过以上代码和解读，开发者可以轻松掌握如何使用 wx.getBackgroundAudioManager 来管理小程序的背景音频播放。