试听背景音乐

功能介绍

方案样例提供 LocalMusicList 组件,用于:

  • 背景音乐列表展示
  • 背景音乐试听功能

音乐试听功能基于 InnerAudioContext 实例实现,支持完整的音频控制能力,请参考 详情;

InnerAudioContext 实例核心功能

基础控制

  • 【InnerAudioContext.paly】:播放音频
  • 【InnerAudioContext.pause】:暂停音频
  • 【InnerAudioContext.stop】:停止音频
  • 【InnerAudioContext.resume】:恢复播放
  • 【InnerAudioContext.seek】:跳转到指定时间点(单位:秒)

事件监听

  • 【InnerAudioContext.onTimeUpdate】:实时获取播放进度更新(注:进度数据由系统返回,iOS/Android可能存在差异)

资源管理

  • 【InnerAudioContext.destroyPlayer】:支持手动销毁音频实例(建议在组件卸载时主动销毁)

交互流程

sequenceDiagram
rect rgb(191, 223, 255)
    面板->>面板: 1.展示默认背景音乐列表并创建InnerAudioContext实例
    用户->>面板: 2.选中音乐
    面板->>InnerAudioContext: play(音频文件)
    InnerAudioContext-->>用户: 播放试听
    用户->>面板: 2.取消选中
    面板->>InnerAudioContext: pause()
    InnerAudioContext-->>用户: 停止播放
    面板->>面板: 3.用户退出面板
    面板->>InnerAudioContext: destroyPlayer()
end

rect rgb(200, 150, 255)
    Note right of 面板: 用户交互层
    Note left of InnerAudioContext: 音频播放服务
end

注意事项

  • 1.单个页面建议复用同一个 InnerAudioContext 实例;

  • 2.进度监听需考虑平台差异性;

  • 3.及时销毁不再使用的实例;