鸿蒙OS 视频播放开发指导
场景介绍
视频播放包括播放控制、播放设置和播放查询,如播放的开始/停止、播放速度设置和是否循环播放等。
接口说明
接口名 | 功能描述 |
---|---|
Player(Context context) | 创建Player实例。 |
setSource(Source source) | 设置媒体源。 |
prepare() | 准备播放。 |
play() | 开始播放。 |
pause() | 暂停播放。 |
stop() | 停止播放。 |
rewindTo(long microseconds) | 拖拽播放。 |
setVolume(float volume) | 调节播放音量。 |
setVideoSurface(Surface surface) | 设置视频播放的窗口。 |
enableSingleLooping(boolean looping) | 设置为单曲循环。 |
isSingleLooping() | 检查是否单曲循环播放。 |
isNowPlaying() | 检查是否播放。 |
getCurrentTime() | 获取当前播放位置。 |
getDuration() | 获取媒体文件总时长。 |
getVideoWidth() | 获取视频宽度。 |
getVideoHeight() | 获取视频高度。 |
setPlaybackSpeed(float speed) | 设置播放速度。 |
getPlaybackSpeed() | 获取播放速度。 |
setAudioStreamType(int type) | 设置音频类型。 |
getAudioStreamType() | 获取音频类型。 |
setNextPlayer(Player next) | 设置当前播放结束后的下一个播放器。 |
reset() | 重置播放器。 |
release() | 释放播放资源。 |
setPlayerCallback(IPlayerCallback callback) | 注册回调,接收播放器的事件通知或异常通知。 |
开发步骤
- 创建 Player 实例,可调用 Player(Context context),创建本地播放器,用于在本设备播放。
- 构造数据源对象,并调用 Player 实例的 setSource(Source source)方法,设置媒体源,代码示例如下:
Player impl = new Player(context);
File file = new File("/path/test_audio.aac");
in = new FileInputStream(file);
FileDescriptor fd = in.getFD(); // 从输入流获取FD对象
Source source = new Source(fd);
impl.setSource(source);
- 调用 prepare(),准备播放。
- (可选)构造 IPlayerCallback,IPlayerCallback 需要实现 onPlayBackComplete 和 onError(int errorType, int errorCode) 两个方法,实现播放完成和播放异常时做相应的操作。代码示例如下:
@Override
public void onPlayBackComplete() {
HiLog.info("[PlayerCallback]", "onPlayBackComplete");
if (impl != null) {
impl.stop();
impl = null;
}
}
@Override
public void onError(int errorType, int errorCode) {
HiLog.error("[PlayerCallback]", "onError");
}
- 调用 play() 方法,开始播放。
- (可选)调用 pause() 方法和 resume() 方法,可以实现暂停和恢复播放。
- (可选)调用 rewindTo(long microseconds) 方法实现播放中的拖拽功能。
- (可选)调用 getDuration() 方法和 getCurrentTime() 方法,可以实现获取总播放时长以及当前播放位置功能。
- 调用 stop() 方法停止播放。
- 播放结束后,调用 release() 释放资源。
分享