播放器控制

adjustPlayoutVolume

调节本地播放音量。

Java

int adjustPlayoutVolume(int volume);

调用时机

该方法可在加入频道前或加入频道后调用。

参数

volume

本地播放音量，取值范围为 0 到 100：

• 0：静音。
• 100：（默认）原始音量。

返回值

• 0：方法调用成功。
• < 0：方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• IMediaPlayer

adjustPublishSignalVolume

调节用于发布的媒体文件音量。

Java

int adjustPublishSignalVolume(int volume);

你可以调用该方法调节远端用户听到的媒体文件音量。

调用时机

该方法可以在加入频道前或加入频道后调用。

参数

volume

音量，取值范围为 0 到 400：

• 0：静音。
• 100：（默认）原始音量。
• 400：原始音量的四倍（将音频信号放大四倍）。

返回值

• 0：方法调用成功。
• < 0：方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• IMediaPlayer

mute

设置是否静音媒体文件。

Java

int mute(boolean muted);

调用时机

你可以在加入频道前或加入频道后调用该方法。

参数

muted

是否静音媒体文件：

• true：静音媒体文件。
• false：（默认）取消静音媒体文件。

返回值

• 0：方法调用成功。
• < 0：方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• IMediaPlayer

pause

暂停播放。

Java

int pause();

调用时机

你可以在加入频道前或加入频道后调用此方法。

返回值

• 0：方法调用成功。
• < 0：方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• IMediaPlayer

play

播放媒体文件。

Java

int play();

调用时机

• 在调用 open 或 openWithMediaSource 打开媒体文件并收到 onPlayerStateChanged 回调报告状态为 PLAYER_STATE_OPEN_COMPLETED 后调用该方法。
• 在调用 seek 后调用该方法。

返回值

• 0：方法调用成功。
• < 0：方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• IMediaPlayer

playPreloadedSrc

播放预加载的媒体资源。

Java

int playPreloadedSrc(String src);

调用 preloadSrc 将媒体资源预加载到播放列表后，可以调用 playPreloadedSrc 播放该预加载的媒体资源。调用该方法后，如果收到 onPlayerStateChanged 回调并报告 PLAYER_STATE_PLAYING 状态，则表示播放成功。 如果想更换要播放的预加载媒体资源，可以再次调用 playPreloadedSrc 并指定新的媒体资源 URL。若想重新播放该媒体资源，需要先调用 preloadSrc 重新预加载后再播放。若想清空播放列表，请调用 stop。

信息

如果在播放暂停时调用该方法，该方法在播放恢复之前不会生效。

参数

src

播放列表中媒体资源的 URL，必须与通过 preloadSrc 设置的 src 保持一致，否则无法播放该媒体资源。

返回值

• 0：方法调用成功。
• < 0：方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• IMediaPlayer

resume

恢复播放媒体文件。

Java

int resume();

返回值

• 0：方法调用成功。
• < 0：方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• IMediaPlayer

seek

跳转到新的播放位置。

Java

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 回调，报告跳转到新播放位置的结果。

参数

newPos

新的播放位置，单位为毫秒。

返回值

• 0：方法调用成功。
• < 0：方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• IMediaPlayer

stop [1/2]

停止播放媒体轨道。

Java

int stop();

调用该方法后，如需再次播放，需要调用 open 或 openWithMediaSource 重新打开媒体资源。

调用时机

请在播放后调用此方法。

返回值

• 0：方法调用成功。
• < 0：方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• IMediaPlayer

onSeek

当 SDK 定位媒体资源数据时触发的回调。

Java

long onSeek(long offset, int whence)

当你调用 openWithMediaSource 或 open 方法打开自定义媒体资源时，SDK 会触发该回调，请求媒体资源中指定位置的数据。

参数

offset

目标位置相对于起始点的偏移量，单位为字节。该值可以为正数或负数。

whence

起始点，可设置为以下值之一：

• 0：起始点为数据开头，定位后的实际数据偏移量为 offset。
• 1：起始点为当前位置，定位后的实际数据偏移量为当前位置加 offset。
• 2：起始点为数据末尾，定位后的实际数据偏移量为整个数据长度加 offset。
• 65536：不执行定位操作，返回文件大小。建议在播放 MP3、WAV 等纯音频文件时使用该值。

返回值

• whence 为 65536 时，返回媒体文件大小。
• whence 为 0、1 或 2 时，返回定位后的实际数据偏移量。
• -1：定位失败。

所属接口类

• IMediaPlayerCustomDataProvider