HarmonyOS鸿蒙Next中avplayer创建后，不播放，不会执行任何回调

【背景知识】

AVPlayer是一个功能较完善的音视频播放API，集成了流媒体和本地资源解析，媒体资源解封装，视频解码和渲染功能，适用于对媒体资源进行端到端播放的场景，可直接播放mp4、mkv等格式的视频文件。

完整的视频播放需要：应用、XComponent、Player Framework、Graphic Framework、Audio Framework、显示HDI和音频HDI共同实现。

播放状态的详细说明请参考AVPlayerState。当播放处于prepared / playing / paused / completed状态时，播放引擎处于工作状态，这需要占用系统较多的运行内存。当客户端暂时不使用播放器时，调用reset()或release()回收内存资源，做好资源利用。

开发建议：当前指导仅介绍如何实现媒体资源播放，在应用开发过程中可能会涉及后台播放、播放冲突等情况，请根据实际需要参考以下说明：

• 如果要实现后台播放或熄屏播放，需要接入AVSession（媒体会话）和申请长时任务，避免播放被系统强制中断。
• 应用在播放过程中，若播放的媒体数据涉及音频，根据系统音频管理策略（参考处理音频焦点事件），可能会被其他应用打断，建议应用主动监听音频打断事件，根据其内容提示，做出相应的处理，避免出现应用状态与预期效果不一致的问题。
• 面对设备同时连接多个音频输出设备的情况，应用可以通过on(‘audioOutputDeviceChangeWithInfo’)监听音频输出设备的变化，从而做出相应处理。
• 如果需要访问在线媒体资源，需要申请ohos.permission.INTERNET权限。

支持的视频播放格式和主流分辨率如下：

【解决方案】

开发步骤及注意事项：详细的API说明请参考AVPlayer API参考。

1. 调用createAVPlayer()创建AVPlayer实例，初始化进入idle状态。
2. 设置业务需要的监听事件，搭配全流程场景使用。
3. 设置资源：设置属性url，AVPlayer进入initialized状态。
4. 设置窗口：获取并设置属性surfaceId，用于设置显示画面。应用需要从XComponent组件获取surfaceId，获取方式请参考XComponent。
5. 准备播放：调用prepare()，AVPlayer进入prepared状态，此时可以获取duration，设置缩放模式、音量等。
6. 视频播控：播放play()，暂停pause()，跳转seek()，停止stop()等操作。
7. （可选）更换资源：调用reset()重置资源，AVPlayer重新进入idle状态，允许更换资源url。
8. 退出播放：调用release()销毁实例，AVPlayer进入released状态，退出播放。

官方完整示例参考：完整示例。

代码步骤参考如下：

1. 导入所需要的模块。

   import { media } from '[@kit](/user/kit).MediaKit';
   import { fileIo as fs } from '[@kit](/user/kit).CoreFileKit';
   import { common } from '[@kit](/user/kit).AbilityKit';
   import { BusinessError } from '[@kit](/user/kit).BasicServicesKit';
   

2. 自定义对象类型。

   private count: number = 0;
   private surfaceID: string = ''; // surfaceID用于播放画面显示，具体的值需要通过Xcomponent接口获取，相关文档链接见上面Xcomponent创建方法。
   private isSeek: boolean = true; // 用于区分模式是否支持seek操作。
   private fileSize: number = -1;
   private fd: number = 0;
   
   constructor(surfaceID: string) {
     this.surfaceID = surfaceID;
   }
   

3. 注册AVPlayer回调函数。

   setAVPlayerCallback(avPlayer: media.AVPlayer) {
     // startRenderFrame首帧渲染回调函数。
     avPlayer.on('startRenderFrame', () => {
       console.info(`AVPlayer start render frame`);
     });
     // seek操作结果回调函数。
     avPlayer.on('seekDone', (seekDoneTime: number) => {
       console.info(`AVPlayer seek succeeded, seek time is ${seekDoneTime}`);
     });
     // error回调监听函数,当avPlayer在操作过程中出现错误时调用reset接口触发重置流程。
     avPlayer.on('error', (err: BusinessError) => {
       console.error(`Invoke avPlayer failed, code is ${err.code}, message is ${err.message}`);
       avPlayer.reset(); // 调用reset重置资源，触发idle状态。
     });
     // 状态机变化回调函数。
     avPlayer.on('stateChange', async (state: string, reason: media.StateChangeReason) => {
       switch (state) {
         case 'idle': // 成功调用reset接口后触发该状态机上报。
           console.info('AVPlayer state idle called.');
           avPlayer.release(); // 调用release接口销毁实例对象。
           break;
         case 'initialized': // avplayer设置播放源后触发该状态上报。
           console.info('AVPlayer state initialized called.');
           avPlayer.surfaceId = this.surfaceID; // 设置显示画面，当播放的资源为纯音频时无需设置。
           avPlayer.prepare();
           break;
         case 'prepared': // prepare调用成功后上报该状态机。
           console.info('AVPlayer state prepared called.');
           avPlayer.play(); // 调用播放接口开始播放。
           break;
         case 'playing': // play成功调用后触发该状态机上报。
           console.info('AVPlayer state playing called.');
           if (this.count !== 0) {
             if (this.isSeek) {
               console.info('AVPlayer start to seek.');
               avPlayer.seek(avPlayer.duration); // seek到视频末尾。
             } else {
               // 当播放模式不支持seek操作时继续播放到结尾。
               console.info('AVPlayer wait to play end.');
             }
           } else {
             avPlayer.pause(); // 调用暂停接口暂停播放。
           }
           this.count++;
           break;
         case 'paused': // pause成功调用后触发该状态机上报。
           console.info('AVPlayer state paused called.');
           avPlayer.play(); // 再次播放接口开始播放。
           break;
         case 'completed': // 播放结束后触发该状态机上报。
           console.info('AVPlayer state completed called.');
           avPlayer.stop(); // 调用播放结束接口。
           break;
         case 'stopped': // stop接口成功调用后触发该状态机上报。
           console.info('AVPlayer state stopped called.');
           avPlayer.reset(); // 调用reset接口初始化avplayer状态。
           break;
         case 'released':
           console.info('AVPlayer state released called.');
           break;
         default:
           console.info('AVPlayer state unknown called.');
           break;
       }
     });
   }
   

4. 使用fs文件系统打开沙箱地址获取媒体文件地址并通过url属性进行播放示例。

   async avPlayerUrlDemo() {
     // 创建avPlayer实例对象。
     let avPlayer: media.AVPlayer = await media.createAVPlayer();
     // 创建状态机变化回调函数。
     this.setAVPlayerCallback(avPlayer);
     let fdPath = 'fd://';
     let context = getContext(this) as common.UIAbilityContext;
     // 通过UIAbilityContext获取沙箱地址filesDir，以Stage模型为例。
     let pathDir = context.filesDir;
     let path = pathDir + '/H264_AAC.mp4';
     // 打开相应的资源文件地址获取fd，并为url赋值触发initialized状态机上报。
     let file = await fs.open(path);
     fdPath = fdPath + '' + file.fd;
     this.isSeek = true; // 支持seek操作。
     avPlayer.url = fdPath;
   }
   

5. 使用资源管理接口获取打包在HAP内的媒体资源文件并通过fdSrc属性进行播放示例。

   async avPlayerFdSrcDemo() {
     // 创建avPlayer实例对象。
     let avPlayer: media.AVPlayer = await media.createAVPlayer();
     // 创建状态机变化回调函数。
     this.setAVPlayerCallback(avPlayer);
     // 通过UIAbilityContext的resourceManager成员的getRawFd接口获取媒体资源播放地址。
     // 返回类型为{fd,offset,length},fd为HAP包fd地址，offset为媒体资源偏移量，length为播放长度。
     let context = getContext(this) as common.UIAbilityContext;
     let fileDescriptor = await context.resourceManager.getRawFd('H264_AAC.mp4');
     let avFileDescriptor: media.AVFileDescriptor =
       { fd: fileDescriptor.fd, offset: fileDescriptor.offset, length: fileDescriptor.length };
     this.isSeek = true; // 支持seek操作。
     // 为fdSrc赋值触发initialized状态机上报。
     avPlayer.fdSrc = avFileDescriptor;
   }
   

6. 使用fs文件系统打开沙箱地址获取媒体文件地址并通过dataSrc属性进行播放。 seek模式。

   async avPlayerDataSrcSeekDemo() {
     // 创建avPlayer实例对象。
     let avPlayer: media.AVPlayer = await media.createAVPlayer();
     // 创建状态机变化回调函数。
     this.setAVPlayerCallback(avPlayer);
     // dataSrc播放模式的的播放源地址，当播放为Seek模式时fileSize为播放文件的具体大小，下面会对fileSize赋值。
     let src: media.AVDataSrcDescriptor = {
       fileSize: -1,
       callback: (buf: ArrayBuffer, length: number, pos: number | undefined) => {
         let num = 0;
         if (buf == undefined || length == undefined || pos == undefined) {
           return -1;
         }
         num = fs.readSync(this.fd, buf, { offset: pos, length: length });
         if (num > 0 && (this.fileSize >= pos)) {
           return num;
         }
         return -1;
       }
     };
     let context = getContext(this) as common.UIAbilityContext;
     // 通过UIAbilityContext获取沙箱地址filesDir，以Stage模型为例。
     let pathDir = context.filesDir;
     let path = pathDir + '/H264_AAC.mp4';
     await fs.open(path).then((file: fs.File) => {
       this.fd = file.fd;
     });
     // 获取播放文件的大小。
     this.fileSize = fs.statSync(path).size;
     src.fileSize = this.fileSize;
     this.isSeek = true; // 支持seek操作。
     avPlayer.dataSrc = src;
   }
   

   No seek模式。

   async avPlayerDataSrcNoSeekDemo() {
     // 创建avPlayer实例对象。
     let avPlayer: media.AVPlayer = await media.createAVPlayer();
     // 创建状态机变化回调函数。
     this.setAVPlayerCallback(avPlayer);
     let context = getContext(this) as common.UIAbilityContext;
     let src: media.AVDataSrcDescriptor = {
       fileSize: -1,
       callback: (buf: ArrayBuffer, length: number) => {
         let num = 0;
         if (buf == undefined || length == undefined) {
           return -1;
         }
         num = fs.readSync(this.fd, buf);
         if (num > 0) {
           return num;
         }
         return -1;
       }
     };
     // 通过UIAbilityContext获取沙箱地址filesDir，以Stage模型为例。
     let pathDir = context.filesDir;
     let path = pathDir + '/H264_AAC.mp4';
     await fs.open(path).then((file: fs.File) => {
       this.fd = file.fd;
     });
     this.isSeek = false; // 不支持seek操作。
     avPlayer.dataSrc = src;
   }
   

7. 通过url设置网络地址来实现播放直播码流的demo。

   async avPlayerLiveDemo() {
     // 创建avPlayer实例对象。
     let avPlayer: media.AVPlayer = await media.createAVPlayer();
     // 创建状态机变化回调函数。
     this.setAVPlayerCallback(avPlayer);
     this.isSeek = false; // 不支持seek操作。
     avPlayer.url = 'https://xxx.xxx.xxx.xxx:xx/xx/index.m3u8'; // 播放hls网络直播码流。
   }
   

8. 通过setMediaSource设置自定义头域及媒体播放优选参数实现初始播放参数设置。

   async preDownloadDemo() {
     // 创建avPlayer实例对象。
     let avPlayer: media.AVPlayer = await media.createAVPlayer();
     let mediaSource: media.MediaSource =
       media.createMediaSourceWithUrl("https://xxx", { "User-Agent": "User-Agent-Value" });
     let playbackStrategy: media.PlaybackStrategy = {
       preferredWidth: 1,
       preferredHeight: 2,
       preferredBufferDuration: 3,
       preferredHdr: false
     };
     // 设置媒体来源和播放策略。
     avPlayer.setMediaSource(mediaSource, playbackStrategy);
   }
   

9. 通过selectTrack设置音频轨道，通过deselectTrack取消上次设置的音频轨道并恢复到视频默认音频轨道。

   async multiTrackDemo() {
     // 创建avPlayer实例对象。
     let avPlayer: media.AVPlayer = await media.createAVPlayer();
     let audioTrackIndex: Object = 0;
     avPlayer.getTrackDescription(
       (error: BusinessError, arrList: Array<media.MediaDescription>) => {
         if (arrList != null) {
           for (let i = 0; i < arrList.length; i++) {
             if (i != 0) {
               // 获取音频轨道列表。
               audioTrackIndex = arrList[i][media.MediaDescriptionKey.MD_KEY_TRACK_INDEX];
             }
           }
         } else {
           console.error(`audio getTrackDescription fail, error:${error}`);
         }
       });
     // 选择其中一个音频轨道。
     avPlayer.selectTrack(parseInt(audioTrackIndex.toString()));
     // 取消选择上次选中的音频轨道，并恢复到默认音频轨道。
     avPlayer.deselectTrack(parseInt(audioTrackIndex.toString()));
   }