播放器组件

功能描述

播放器组件（ARMediaPlayerKit）是一款功能强大的播放器，支持播放本地或在线的媒体资源。ARMediaPlayerKit 已内置在 RTC SDK 中

使用须知

支持格式

• 目前支持的音频格式：MP3、WAV等
• 目前支持的视频格式：AVI、MP4、MKV、FLV等

支持协议

• 目前支持HTTP、RTMP 和 RTSP 协议的在线媒体流。

实现方法

本地播放媒体资源

集成 RTC SDK 后，参考如下步骤实现本地播放功能。

创建一个播放器实例

创建一个 ARMediaPlayerKit 实例 。如需同时播放不同的媒体资源，你可以创建多个实例。

注册一个播放观测器

1. 实现 MediaPlayerObserver 接口，并实例化 MediaPlayerObserver 对象。

2. 调用 MediaPlayerKit 接口的 registerPlayerObserver 方法注册一个播放器的观测器 ，监听以下播放事件：

   • onPlayerStateChanged，报告播放状态改变
   • onPositionChanged，报告当前播放进度
   • onPlayerEvent，报告定位播放结果

示例代码如下

private ARMediaPlayerKit arMediaPlayerKit = new ARMediaPlayerKit();//创建播放器对象

arMediaPlayerKit.open("http://vfx.mtime.cn/Video/2019/02/04/mp4/190204084208765161.mp4",0);//设置在线媒体流地址
arMediaPlayerKit.play();//开始播放

开始播放

1. 使用 setView 方法设置播放器的渲染视图。
2. 使用 setRenderMode 方法设置播放器视图的渲染模式。
3. 使用 open 方法打开媒体资源。媒体资源路径可以为网络路径或本地路径，支持绝对路径和相对路径。在收到 onPlayerStateChanged 回调报告播放状态为 PLAYER_STATE_OPEN_COMPLETED=(2) 后再进行下一步操作。
4. 使用 play 方法本地播放该媒体资源。

播放环节设置

调用 ARMediaPlayerKit 接口的其他方法你可以实现以下几种播放设置：

1. 你可以调用 getStreamCount 方法来获取该媒体文件中媒体流的数量

2. 若是你需要恢复/暂停播放，你可以使用 pause 方法来实现，需要从指定位置播放媒体文件你可以使用 seek 方法来实现

   ......

结束播放

1. 调用 stop 方法以结束全部环节的播放
2. 调用 unregisterPlayerObserver 方法可以取消注册该播放观测器 (可以根据你自己的需求进行选择)
3. destroy 方法可以销毁你当前创建的 MediaPlayerKit 实例