使用AVPlayer可以实现端到端播放原始媒体资源,本开发指导将以完整地播放一首音乐作为示例,向开发者讲解AVPlayer音频播放相关功能。
播放的全流程包含:创建AVPlayer,设置回调监听函数,设置播放资源,设置播放参数(音量/倍速/焦点模式),播放控制(播放/暂停/跳转/停止),重置,销毁播放器实例。
在进行应用开发的过程中,开发者可以通过AVPlayer的信息监听回调函数OH_AVPlayerOnInfoCallback和错误监听回调函数OH_AVPlayerOnErrorCallback主动获取播放过程信息。如果应用在音频播放器处于错误状态时执行操作,系统可能会抛出异常或生成其他未定义的行为。
图1 播放状态变化示意图

状态的详细说明请参考AVPlayerState。当播放处于prepared / playing / paused / completed状态时,播放引擎处于工作状态,这需要占用系统较多的运行内存。当客户端暂时不使用播放器时,调用reset()或release()回收内存资源,做好资源利用。
当前指导仅介绍如何实现媒体资源播放,在应用开发过程中可能会涉及后台播放、播放冲突等情况,请根据实际需要参考以下说明。
在CMake脚本中链接如下动态库:
target_link_libraries(entry PUBLIC
libavplayer.so
libnative_media_core.so
libhilog_ndk.z.so
) 使用OH_AVPlayer_SetOnInfoCallback()、OH_AVPlayer_SetOnErrorCallback()接口设置信息监听回调函数和错误监听回调函数,需要在CMake脚本中链接libnative_media_core.so动态库。
开发者使用系统日志能力时,需引入如下头文件。
#include <hilog/log.h>
并需要在CMake脚本中链接libhilog_ndk.z.so动态库。
开发者通过引入avplayer.h、avplayer_base.h和native_averrors.h头文件,使用音频播放相关API。
详细的API说明请参考AVPlayer API。
创建AVPlayer实例:调用OH_AVPlayer_Create(),AVPlayer初始化为AV_IDLE状态。
设置回调监听函数:使用OH_AVPlayer_SetOnInfoCallback()、OH_AVPlayer_SetOnErrorCallback()接口设置信息监听回调函数和错误监听回调函数,搭配全流程场景使用。支持的监听事件包括:
| 事件类型 | 说明 |
|---|---|
| OH_AVPlayerOnInfoCallback | 必要事件,监听播放器的过程信息。 需要播放器在AV_IDLE状态下、未调用设置资源接口前完成设置监听,若在调用设置资源接口后再设置监听,可能导致无法收到资源设置过程中上报的OH_AVPlayerOnInfoCallback事件。 |
| OH_AVPlayerOnErrorCallback | 必要事件,监听播放器的错误信息。 需要播放器在AV_IDLE状态下、未调用设置资源接口前完成设置监听,若在调用设置资源接口后再设置监听,可能导致无法收到资源设置过程中上报的OH_AVPlayerOnErrorCallback事件。 |
应用使用OH_AVPlayer_SetOnInfoCallback()、OH_AVPlayer_SetOnErrorCallback()接口设置信息监听回调函数和错误监听回调函数,可以获取更多信息,还可以通过设置 userData 区分不同播放实例。
设置资源:调用OH_AVPlayer_SetURLSource(),设置属性url,AVPlayer进入AV_INITIALIZED状态。
(可选)设置音频流类型:调用OH_AVPlayer_SetAudioRendererInfo(),设置AVPlayer音频流类型。
(可选)设置音频打断模式:调用OH_AVPlayer_SetAudioInterruptMode(),设置AVPlayer音频流打断模式。
准备播放:调用OH_AVPlayer_Prepare(),AVPlayer进入AV_PREPARED状态,此时可以获取时长,设置音量。
(可选)设置音频音效模式:调用OH_AVPlayer_SetAudioEffectMode(),设置AVPlayer音频音效模式。
音频播控:播放OH_AVPlayer_Play(),暂停OH_AVPlayer_Pause(),跳转OH_AVPlayer_Seek(),停止OH_AVPlayer_Stop()等操作。
(可选)更换资源:调用OH_AVPlayer_Reset()重置资源,AVPlayer重新进入AV_IDLE状态,允许更换资源url。
退出播放:调用OH_AVPlayer_Release()销毁实例,AVPlayer进入AV_RELEASED状态,退出播放。之后再操作AVPlayer实例则行为未知,可能导致应用进程崩溃,应用闪退。
AVPlayerNDKAudio
entry/src/main/ets/
└── pages
└── Index.ets (播放界面)
entry/src/main/
├── cpp
│ ├── types
│ │ └── libentry
│ │ └── Index.d.ts (NDK函数对应的js映射)
│ ├── CMakeLists.txt (CMake脚本)
│ └── napi_init.cpp (NDK函数)
└── resources
├── base
│ ├── element
│ │ ├── color.json
│ │ ├── float.json
│ │ └── string.json
│ └── media
│ ├── ic_video_play.svg (播放键图片资源)
│ └── ic_video_pause.svg (暂停键图片资源)
└── rawfile
└── test_01.mp3 (音频资源)