媒体资源打开
open [1/2]
打开媒体资源。
Java
int open(String url, long startPos);
支持播放以 content:// 开头的 URI 文件。
信息
该方法为异步调用。
调用时机
该方法可以在加入频道前或后调用。
相关回调
调用该方法后，SDK 会触发 onPlayerStateChanged 回调。在收到播放状态为 OPEN_COMPLETED 的上报后，你可以调用 play 方法播放媒体文件。
参数
- url
- 媒体文件的路径，支持本地路径和在线路径。
- startPos
- 播放的起始位置（毫秒，默认值为 0）。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
open [2/2]
openWithMediaSource
打开媒体文件并配置播放场景。
Java
int openWithMediaSource(MediaPlayerSource source);
该方法支持打开不同类型的媒体文件，包括以 content:// 开头的 URI 文件和 assets 文件夹中的媒体文件，并设置播放选项。
信息
调用时机
你可以在加入频道前或加入频道后调用该方法。
参数
- source
- 媒体资源，详见 MediaPlayerSource。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
preloadSrc
预加载媒体资源。
Java
int preloadSrc(String src, long startPos);
调用该方法后，如果在 onPreloadEvent 回调中收到 PLAYER_PRELOAD_EVENT_COMPLETE 事件，表示预加载成功；如果收到 PLAYER_PRELOAD_EVENT_ERROR 事件，表示预加载失败。预加载成功后，如需播放该媒体资源，请调用 playPreloadedSrc；如需清空播放列表，请调用 stop()。
信息
- 在调用此方法前，请确保已成功调用
open或 openWithMediaSource 打开媒体资源。 - 声网不支持将重复的媒体资源预加载到播放列表中。但你可以将正在播放的媒体资源再次预加载到播放列表中。
参数
- src
- 媒体资源的 URL。
- startPos
- 媒体资源预加载到播放列表后开始播放的位置（单位为毫秒）。预加载直播流时，请将该参数设为 0。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
switchSrc
切换正在播放的媒体资源。
Java
int switchSrc(String src, boolean syncPts);
你可以调用此方法根据当前网络状态切换播放的媒体资源地址。例如：
- 当网络较差时，将播放的媒体资源切换为码率较低的媒体资源地址。
- 当网络良好时，将播放的媒体资源切换为码率较高的媒体资源地址。
PLAYER_EVENT_SWITCH_COMPLETE 事件，表示切换成功。如果切换失败，SDK 会自动重试 3 次。如果仍然失败，你将收到 onPlayerEvent 回调报告 PLAYER_EVENT_SWITCH_ERROR 事件，表示切换过程中发生错误。信息
- 请确保在调用
open之后再调用此方法。 - 为确保正常播放，调用此方法时请注意以下事项：
- 播放暂停时不要调用此方法。
- 切换过程中不要调用 seek 方法。
- 切换媒体资源前，请确保播放位置未超过待切换媒体资源的总时长。
参数
- src
- 媒体资源的 URL 地址。
- syncPts
- 是否在切换前后同步播放位置（毫秒）：
- true：同步切换前后的播放位置。
- false：（默认）不同步切换前后的播放位置。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。