2024/08/14 14:11:36
确保云端播放器创建成功
创建云端播放器时,请关注如下事项:
-
你需要通过
region
参数分区域创建云端播放器:- 设置的
region
与你的媒体流源站在同一个区域。例如媒体流源站为阿里云 OSS,则需要将region
设置为cn
。 - 传入
region
的值为小写。
- 设置的
-
声网推荐你对请求 Header 中的
X-Request-ID
字段赋值,声网服务器会在响应 Header 中返回一个X-Custom-Request-ID
字段,以用于问题排查。 -
选择设置 UID 或 Account 作为云端播放器的用户名(请勿同时设置这两个字段),并保证每个云端播放器在频道内的用户名唯一。
-
为避免重复创建多个云端播放器导致重复输入媒体流,推荐使用
name
字段管理指定项目下的云端播放器:- 同一时间,一个项目下不允许出现重名的云端播放器,否则在尝试创建同名的云端播放器时会收到响应状态码
409(Conflict)
。
- 同一时间,一个项目下不允许出现重名的云端播放器,否则在尝试创建同名的云端播放器时会收到响应状态码
-
请注意云端播放器支持的音视频格式与协议,避免因使用不支持的音视频格式与协议导致输入媒体流失败。
- 请设置合理的
idleTimeout
的参数值,推荐使用默认值 300 秒,表示当媒体流为非播放状态 300 秒后云端播放器会自动销毁,停止输入在线媒体流。
- 请设置合理的
-
监听云端播放器创建成功事件后,当你成功创建一个云端播放器时,消息通知服务器会向你的服务器通知该事件。报告事件
payload
中status
字段为"connecting"
,表示业务服务器正在连接媒体流地址或正在探测音视频数据。