确保云端播放器创建成功

更新时间不可用

了解如何在输入在线媒体流中确保云端播放器创建成功,包括适用场景、配置步骤、实现要点和注意事项。

创建云端播放器时,请关注如下事项:

  • 你需要通过 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",表示业务服务器正在连接媒体流地址或正在探测音视频数据。