实现云端播放器

简介

本文介绍如何基于服务端 API 快速实现并维护一个云端播放器。

注意

开发者需注意媒体资源的版权问题，加密的版权音乐可能会播放失败。

调用 CreatePlayer 接口，设置媒体资源 StreamUrl，指定房间 RoomId，创建一个云端播放器，详情请参考创建云端播放器。创建成功后，云端播放器会自动加载传入的媒体资源，将其推流到指定房间内进行播放。

注意

同一个 AppID 下，最多允许同时存在 50 个正在运行中（未被销毁）的云端播放器。如果您需要提高上限，请联系 ZEGO 技术支持处理。
调用 CreatePlayer 接口时：
- 如果传入的 RoomId 不存在，将自动创建并登录房间。
- 如果传入的 StreamId 不存在，将自动创建一条流，推送到指定房间内。如果未传入 StreamId，由 ZEGO 服务器随机分配一个 ID。

创建成功后，ZEGO 服务端会返回播放器的 PlayerId（唯一标识）；同时，播放器会加载媒体资源，并推流到指定 RoomId 的房间内，开始播放。

在房间内播放媒体资源的过程中，开发者可以随时调用 UpdatePlayer 接口，设置 PlayerId（唯一标识）、AudioOptions（音频转码参数配置）、VideoOptions（视频转码参数配置），更新指定的云端播放器，详情请参考更新云端播放器。

通过 UpdatePlayer 接口，开发者还可以实现暂停播放、进度跳转、更换播放的媒体资源等功能。

开发者可以根据自己的业务场景，调用 DeletePlayer 接口，设置 PlayerId（唯一标识），销毁指定的云端播放器，详情请参考销毁云端播放器。

接口调用成功后，媒体资源将会自动停止播放，对应的推流会自动终止。

开发者可以通过调用 DescribePlayers 接口，指定房间 RoomId 查询该房间内的所有云端播放器任务列表及详细信息、或指定 PlayerId 查询该播放器的相关信息，详情请参考查询云端播放器任务列表。