Public 成员函数 | |
---|---|
ARMediaPlayer (Context context) | |
int | open (String src, long startPos) |
int | play () |
int | pause () |
int | stop () |
int | seek (long pos) |
int | mute (boolean mute) |
boolean | isMuted () |
int | adjustPlayoutVolume (int volume) |
int | getPlayoutVolume () |
long | getPlayPosition () |
long | getDuration () |
int | getState () |
int | getStreamCount () |
int | setView (View videoView) |
int | setRenderMode (int mode) |
int | destroy () |
void | registerPlayerObserver (MediaPlayerObserver playerObserver) |
void | unregisterPlayerObserver (MediaPlayerObserver playerObserver) |
Private 属性 | |
---|---|
IMediaPlayerKit | mediaPlayer = null |
详细描述
构造及析构函数说明
ARMediaPlayerKit
ARMediaPlayerKit mediaPlayer = ARMediaPlayerKit ()
创建一个 ARMediaPlayer 实例
-
返回
一个 ARMediaPlayer 实例
成员函数说明
open
int open (String src,long startPos )
打开媒体文件
参数 | 描述 |
---|---|
src | 设置媒体文件的路径,本地路径或网络路径 |
startPos | 设置起始播放位置 (秒),默认值为 0 |
返回
-
0: 方法调用成功
-
< 0: 方法调用失败,详见 MediaPlayerError
play
int play ()
播放媒体文件
打开 (open()) 媒体文件或暂停 (pause()) 播放媒体文件后,你可以调用该方法播放媒体文件。
返回
-
0: 方法调用成功
-
< 0: 方法调用失败,详见 MediaPlayerError
pause
int pause ()
暂停播放
如果你想恢复播放,请调用 play() 方法。
返回
-
0: 方法调用成功
-
< 0: 方法调用失败,详见 MediaPlayerError
stop
int stop ()
停止播放
返回
-
0: 方法调用成功
-
< 0: 方法调用失败,详见 MediaPlayerError
seek
int seek (long pos)
从指定的位置播放媒体文件
成功调用该方法后,你会收到 onPlayerEvent 回调,报告当前播放器发生的事件,如定位开始、定位成功或定位失败。
参数 | 描述 |
---|---|
pos | 指定的位置 (秒) |
返回
-
0: 方法调用成功
-
< 0: 方法调用失败,详见 MediaPlayerError
mute
int mute (boolean mute)
设置是否静音
参数 | 描述 |
---|---|
mute | 静音选项: true: 静音 false: (默认)不静音 |
返回
-
0: 方法调用成功
-
< 0: 方法调用失败,详见 MediaPlayerError
isMuted
boolean isMuted ()
获取当前的静音状态
返回
- 方法调用成功,返回:
true
: 静音false
: (默认)不静音 - 方法调用失败,返回
false
adjustPlayoutVolume
int adjustPlayoutVolume (int volume)
调节本地播放音量
参数 | 描述 |
---|---|
volume | 本地播放音量,取值范围从 0 到 100: 0: 无声 100: (默认)媒体文件的原始播放音量 |
返回
-
0: 方法调用成功
-
< 0: 方法调用失败,详见 MediaPlayerError
getPlayoutVolume
int getPlayoutVolume ()
获取当前本地播放音量
返回
- < 0: 方法调用失败,详见 MediaPlayerError
- 其他:方法调用成功,返回当前本地播放音量
getPlayPosition
long getPlayPosition ()
获取当前播放进度
返回
- < 0: 方法调用失败,详见 MediaPlayerError
- 其他:播放进度 (毫秒)
getDuration
long getDuration ()
获取媒体文件总时长
返回
- < 0: 方法调用失败,详见 MediaPlayerError
- 其他:媒体文件总时长 (秒)
getState
int getState ()
获取播放器当前状态
- < 0: 方法调用失败,详见 MediaPlayerError
- 其他:播放器当前状态,详见 MediaPlayerState
getStreamCount
int getStreamCount ()
获取该媒体文件中媒体流的数量
返回
- < 0: 方法调用失败,详见 MediaPlayerError
- 其他:该媒体文件中媒体流的数量
setView
int setView (TextureView videoView)
设置播放器的渲染视图
参数 | 描述 |
---|---|
videoView | 视频渲染视图 |
返回
- 0: 方法调用成功
- < 0: 方法调用失败,详见 MediaPlayerError
setRenderMode
int setRenderMode (int mode)
设置播放器视图的渲染模式
参数 | 描述 |
---|---|
mode | 播放器视图的渲染模式: PLAYER_RENDER_MODE_HIDDEN(1)优先保证视窗被填满。视频尺寸等比缩放,直至整个视窗被视频填满。如果视频长宽与显示窗口不同,多出的视频将被截掉 PLAYER_RENDER_MODE_FIT(2)优先保证视频内容全部显示。视频尺寸等比缩放,直至视频窗口的一边与视窗边框对齐。如果视频长宽与显示窗口不同,视窗上未被填满的区域将被涂黑 PLAYER_RENDER_MODE_ADAPTIVE(3)已废弃,不再推荐使用。 |
返回
- 0: 方法调用成功
- < 0: 方法调用失败,详见 MediaPlayerError
destroy
int destroy ()
销毁 ARMediaPlayer 实例
返回
- 0: 方法调用成功
- < 0: 方法调用失败,详见 MediaPlayerError
registerPlayerObserver
void registerPlayerObserver
(MediaPlayerObserver playerObserver)
注册一个播放观测器
参数 | 描述 |
---|---|
playerObserver | 观测器,报告播放中的事件,详见 MediaPlayerObserver |
unregisterPlayerObserver
void unregisterPlayerObserver
(MediaPlayerObserver playerObserver)
取消注册该播放观测器
参数 | 描述 |
---|---|
playerObserver | 观测器,报告播放中的事件,详见 MediaPlayerObserver |