实现云端播放器

---

简介

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

前提条件

• 在 ZEGO 控制台 创建项目，并申请有效的 AppID，详情请参考 控制台 - 项目管理 - 项目信息。
• 请联系 ZEGO 技术支持，开通云端播放器服务的权限，并配置相关的回调地址，用于接收事件通知。

实现流程

1 创建云端播放器

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

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

2 更新云端播放器

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

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

3 销毁云端播放器

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

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

常用功能

查询云端播放器任务列表

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

相关回调及校验说明

云端播放器创建、更新、销毁时，相关状态变化会通过 前提条件 中配置的回调地址抛出。开发者可以根据自己的业务场景，选择监听相关的回调事件，详情请参考 相关回调及校验说明。