媒体资源打开
- HarmonyOS
更新时间不可用
open
打开媒体资源。
public abstract open(url:string, startPos:number):number;该方法支持打开以 content:// 开头的 URI 文件。
媒体播放器支持的格式详见媒体播放器。
注意：
该方法为异步调用。
调用时机
加入频道前后均可调用。
调用限制
无。
相关回调
调用该方法后会触发 onPlayerStateChanged 回调。在收到报告播放状态为 OPEN_COMPLETED 后，你可以调用 play 方法播放媒体文件。
参数
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
所属接口类
openWithMediaSource
打开媒体资源并进行播放设置。
public abstract openWithMediaSource(source: MediaPlayerSource) :number ;该方法支持你打开不同类型的媒体资源，包括以 content:// 开头的 URI 文件、assets 文件夹中的媒体文件、以及其他自定义的媒体资源文件，并可进行播放设置。
媒体播放器支持的格式详见媒体播放器。
调用时机
该方法在加入频道前后均可调用。
调用限制
该方法为异步调用。如需播放媒体文件，需要在收到 onPlayerStateChanged 回调报告状态为 OPEN_COMPLETED 后再调用 play 方法播放媒体文件。
参数
| 参数名 | 描述 |
|---|---|
source | 媒体资源，详见 MediaPlayerSource。 |
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
所属接口类
preloadSrc
预加载媒体资源。
public abstract preloadSrc(src:string, startPos:number):number;详情
你可以调用该方法将一个媒体资源预加载到播放列表中。如果需要预加载多个媒体资源，你可以多次调用该方法。
调用该方法后，如果收到 onPreloadEvent 回调报告事件 PLAYER_PRELOAD_EVENT_COMPLETE，则预加载成功；如果你收到 onPreloadEvent 回调报告事件 PLAYER_PRELOAD_EVENT_ERROR，则预加载失败。
预加载成功后，如果你想播放媒体资源，请调用 playPreloadedSrc；如果你想清空播放列表，请调用 stop。
注：
SDK 不支持你预加载重复的媒体资源到播放列表，但支持你将正在播放的媒体资源再次预加载到播放列表。
参数
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
所属接口类
switchSrc
切换媒体资源。
public abstract switchSrc(src:string, syncPts:boolean):number;详情
你可以根据当前网络状态调用该方法切换播放的媒体资源的码率。例如：
- 在网络较差时，将播放的媒体资源切换为较低码率的媒体资源地址。
- 在网络较好时，将播放的媒体资源切换为较高码率的媒体资源地址。
调用该方法后，如果你收到 onPlayerEvent 回调报告事件 SWITCH_COMPLETE，则媒体资源切换成功；如果你收到 onPlayerEvent 回调报告事件 SWITCH_ERROR，则媒体资源切换失败。
参数
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
所属接口类
unloadSrc
释放预加载的媒体资源。
public abstract unloadSrc(src:string):number;详情
注意：
该方法不支持释放当前播放的媒体资源。
参数
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。