【高心星出品】
文章目录
- 音频播放组件的封装
- 开发步骤
- 封装类代码
- 测试代码
音频播放组件的封装
鸿蒙中提供了AVPlayer来实现音频播放的功能,播放的全流程包含:创建AVPlayer,设置播放资源,设置播放参数(音量/倍速/焦点模式),播放控制(播放/暂停/跳转/停止),重置,销毁资源。在进行应用开发的过程中,开发者可以通过AVPlayer的state属性主动获取当前状态或使用on(‘stateChange’)方法监听状态变化。如果应用在音频播放器处于错误状态时执行操作,系统可能会抛出异常或生成其他未定义的行为。
AVPlayer的状态机变化图:
开发步骤
- 创建实例createAVPlayer(),AVPlayer初始化idle状态。
- 设置业务需要的监听事件,搭配全流程场景使用。
- 设置资源:设置属性url,AVPlayer进入initialized状态。
- 准备播放:调用prepare(),AVPlayer进入prepared状态,此时可以获取duration,设置音量。
- 音频播控:播放play(),暂停pause(),跳转seek(),停止stop() 等操作。
- (可选)更换资源:调用reset()重置资源,AVPlayer重新进入idle状态,允许更换资源url。
- 退出播放:调用release()销毁实例,AVPlayer进入released状态,退出播放。
但是AVPlayer用起来太麻烦,下面我做一个简单的封装。
封装类代码
/***作者:gxx*时间:2024/11/1 14:32*功能:**/
import { media } from "@kit.MediaKit";
import { BusinessError } from "@kit.BasicServicesKit";
import { promptAction } from "@kit.ArkUI";export class MediaPlayer {private player: media.AVPlayerprivate source: media.AVFileDescriptor | stringprivate state: media.AVPlayerState = 'idle'constructor(player: media.AVPlayer, source: media.AVFileDescriptor | string) {// 创建出来playerthis.player = player;// 设置监听this.setListener()this.source = source;// 设置播放资源if (typeof source == 'string') {this.player.url = source} else {this.player.fdSrc = source}}// 设置监听private setListener() {// 播放错误this.player.on('error', (err: BusinessError) => {console.error('gxxt play err: ', err.message)})// 播放完毕this.player.on("endOfStream", () => {console.log('gxxt play 完毕')})this.player.on("stateChange", (state, reason) => {// 更新当前状态this.state = stateswitch (state) {case 'idle':console.log('gxxt play 刚创建')break;case 'initialized':console.log('gxxt play 初始化好了播放资源')this.player.prepare()break;case 'prepared':console.log('gxxt play 准备好的状态')break;case 'playing':console.log('gxxt play 播放中状态')break;case 'paused':console.log('gxxt play 暂停的状态')break;case 'stopped':console.log('gxxt play 停止的状态')break;case 'released':console.log('gxxt play 释放资源')break;}})}play() {// 如果当前状态是准备态或者暂停可以直接播放 否则先准备if (this.state == 'prepared' || this.state == 'paused') {this.player.play()} else if (this.state == 'stopped') {this.player.prepare(() => {// 停止状态进来的 要先准备 再开始播放this.player.play()})}}pause() {// 只有是播放状态才能暂停if (this.state == 'playing') {this.player.pause()} else {promptAction.showToast({ message: '当前状态不支持暂停' })}}// 停止播放stop() {this.player.stop()}//释放资源release() {this.player.release()}seekto(time: number) {// 滑动播放时间if (time < this.player.duration) {this.player.seek(time)}}
}
测试代码
创建AVPplayer对象并准备播放资源。
async aboutToAppear(): Promise<void> {// 创建播放器let avplayer = await media.createAVPlayer()// 获取test.mp3的文件描述符let filedes = getContext(this).resourceManager.getRawFdSync('test.mp3')// 创建播放资源let source: media.AVFileDescriptor = { offset: filedes.offset, fd: filedes.fd, length: filedes.length }this.player = new MediaPlayer(avplayer, source)
}
aboutToDisappear(): void {this.player?.release()}
通过按钮来控制音频的播放和暂停。
Button('播放').width('60%').margin(20).onClick(() => {this.player?.play()})
Button('暂停').width('60%').margin(20).onClick(() => {this.player?.pause()})
Button('停止').width('60%').margin(20).onClick(() => {this.player?.stop()})