调用此接口查询房间内所有虚拟播放器的播放任务。

接口地址信息

• 请求方法：POST
• URL：网易云信为该功能提供以下两个 API 请求地址，使用 V3 地址需在 URL 中指定 cname，您可以根据业务需求调用任一接口。
  • https://logic-dev.netease.im/v2/api/task/list
  • https://logic-dev.netease.im/v3/api/task/list?cname={cname}

URL 中参数说明：

参数名称	类型	示例	描述
cname	String	abc	房间名称。 仅在调用 V3 接口时需要设置。

接口请求频率

默认上限为 50 次/秒，若请求频率超出限制，可能会返回 429 错误码。
若您需要上调上限，请参考如何处理调用服务端 RESTful API 超出频率限制。

请求参数

• 请求中 Header 的设置请参考请求结构描述。

• 请求中 Body 须为 JSON 格式，参数说明如下：

参数名称	类型	是否必选	示例	描述
cid	Number	必选，仅适用于 V2 接口	1144509608259296	房间 ID。 该 ID 为创建云端播放任务接口调用成功后返回的房间 ID，仅在调用 V2 接口时需要设置。
taskType	Int	必选	2	服务器任务类型。固定为 2。

返回参数

参数名称	类型	示例	描述
cid	Number	1144707127429101	房间 ID。
taskId	String	2a784467d647bb87b60b719f6fa56333	任务唯一标识符，房间内唯一。
data	JSON 数组	-	云端播放任务信息。具体请参考 data 结构。

示例

请求示例

{
    "cid":1144509608259296
    "taskType": 2,  // 常量 2 
}

返回示例

{
    "code":200，
    "errmsg":"",
    "result": [{
        "cid": 1144509608259296,
        "taskId": "2a784467d647bb87b60b719f6fa56333",
        "data":{
            "streamUrl": "rtmp://example.yunxin.io/live/class32/101",
            "uid": 101,
            "idleTimeout": 300,
            "playTs": 1575508644,
            "mediaType":0, // 0音频， 1视频， 2音视频
            "volume":100, //设置音量大小，取值范围为[0,200]，默认值为100，表示播放原始声音，大于100表示增大音量，小于100表示减小音量
            "repeatTime":1 //重复播放次数，默认值为1，如果填-1表示无限循环，直到任务停止为止
            }
        }
    ]       
}

状态码

返回内容中，code 为 200 表示调用正常。
若 code 为其他值，请根据 code 与 errmsg 在在线媒体流状态码中查看问题原因。