播放器控制
- Android
更新时间不可用
adjustPlayoutVolume
调节本地播放音量。
int adjustPlayoutVolume(int volume);调用时机
该方法可在加入频道前或加入频道后调用。
参数
返回值
- 0:方法调用成功。
- < 0:方法调用失败。详见错误码了解详情和解决建议。
所属接口类
adjustPublishSignalVolume
调节用于发布的媒体文件音量。
int adjustPublishSignalVolume(int volume);你可以调用该方法调节远端用户听到的媒体文件音量。
调用时机
该方法可以在加入频道前或加入频道后调用。
参数
返回值
- 0:方法调用成功。
- < 0:方法调用失败。详见错误码了解详情和解决建议。
所属接口类
mute
设置是否静音媒体文件。
int mute(boolean muted);调用时机
你可以在加入频道前或加入频道后调用该方法。
参数
返回值
- 0:方法调用成功。
- < 0:方法调用失败。详见错误码了解详情和解决建议。
所属接口类
pause
暂停播放。
int pause();调用时机
你可以在加入频道前或加入频道后调用此方法。
返回值
- 0:方法调用成功。
- < 0:方法调用失败。详见错误码了解详情和解决建议。
所属接口类
play
播放媒体文件。
int play();调用时机
- 在调用
open或 openWithMediaSource 打开媒体文件并收到 onPlayerStateChanged 回调报告状态为PLAYER_STATE_OPEN_COMPLETED后调用该方法。 - 在调用 seek 后调用该方法。
返回值
- 0:方法调用成功。
- < 0:方法调用失败。详见错误码了解详情和解决建议。
所属接口类
playPreloadedSrc
播放预加载的媒体资源。
int playPreloadedSrc(String src);调用 preloadSrc 将媒体资源预加载到播放列表后,可以调用 playPreloadedSrc 播放该预加载的媒体资源。调用该方法后,如果收到 onPlayerStateChanged 回调并报告 PLAYER_STATE_PLAYING 状态,则表示播放成功。
如果想更换要播放的预加载媒体资源,可以再次调用 playPreloadedSrc 并指定新的媒体资源 URL。若想重新播放该媒体资源,需要先调用 preloadSrc 重新预加载后再播放。若想清空播放列表,请调用 stop。
注: 如果在播放暂停时调用该方法,该方法在播放恢复之前不会生效。
参数
| 参数名 | 描述 |
|---|---|
src | 播放列表中媒体资源的 URL,必须与通过 preloadSrc 设置的 |
返回值
- 0:方法调用成功。
- < 0:方法调用失败。详见错误码了解详情和解决建议。
所属接口类
resume
恢复播放媒体文件。
int resume();返回值
- 0:方法调用成功。
- < 0:方法调用失败。详见错误码了解详情和解决建议。
所属接口类
seek
跳转到新的播放位置。
int seek(long newPos);如果在播放完成后调用 seek,即收到回调 onPlayerStateChanged,播放状态为 PLAYER_STATE_PLAYBACK_COMPLETED 或 PLAYER_STATE_PLAYBACK_ALL_LOOPS_COMPLETED,SDK 会从指定位置开始播放媒体文件,并触发 onPlayerStateChanged 回调,播放状态为 PLAYER_STATE_PLAYING。
如果在播放暂停时调用 seek,调用成功后,SDK 会跳转到指定位置。要恢复播放,请调用 resume 或 play。
调用时机
你可以在加入频道前或后调用此方法。
相关回调
调用该方法成功后,你会收到 onPlayerEvent 回调,报告跳转到新播放位置的结果。
参数
返回值
- 0:方法调用成功。
- < 0:方法调用失败。详见错误码了解详情和解决建议。
所属接口类
stop [1/2]
停止播放媒体轨道。
int stop();调用该方法后,如需再次播放,需要调用 open 或 openWithMediaSource 重新打开媒体资源。
调用时机
请在播放后调用此方法。
返回值
- 0:方法调用成功。
- < 0:方法调用失败。详见错误码了解详情和解决建议。
所属接口类
onSeek
当 SDK 定位媒体资源数据时触发的回调。
long onSeek(long offset, int whence)当你调用 openWithMediaSource 或 open 方法打开自定义媒体资源时,SDK 会触发该回调,请求媒体资源中指定位置的数据。
参数
返回值
whence为 65536 时,返回媒体文件大小。whence为 0、1 或 2 时,返回定位后的实际数据偏移量。- -1:定位失败。