接口描述
描述:可根据会议 ID 在会前和会中设置直播推流地址。
支持企业内的会议创建者、会议主持人与联席主持人在会中进行调用,会议创建者同时支持在会议外进行调用。
商业版和企业版最多支持添加1个微信视频号地址和10个推流平台,平台名称限制10个字符,且不允许纯空格和回车。
该接口暂不支持 OAuth2.0 鉴权访问。
请求方式:POST
接口请求域名:
https://api.meeting.qq.com/v1/meetings/{meetingId}/live_play/live-stream-address
输入参数
参数名称 | 必选 | 参数类型 | 参数描述 |
userid | 是 | String | 用户 ID。 |
instanceid | 是 | integer | 用户的终端设备类型: 0:PSTN 1:PC 2:Mac 3:Android 4:iOS 5:Web 6:iPad 7:Android Pad 8:小程序 9:voip、sip 设备 10:Linux 20:Rooms for Touch Windows 21:Rooms for Touch MacOS 22:Rooms for Touch Android 30:Controller for Touch Windows 32:Controller for Touch Android 33:Controller for Touch iOS |
push_stream_info | 是 | PushStreamInfo 对象数组 | 推流信息,暂只支持设置一条推流信息。 |
PushStreamInfo 对象
参数名称 | 必选 | 参数类型 | 参数描述 |
platform_type | 是 | Integer | 推流平台类型: 1:微信视频号平台 2:第三方推流平台 |
platform_name | 是 | String | 推流平台名称。(base64 编码) |
enable_push_addres | 是 | Boolean | 是否启用该推流地址,默认值为 true。 true:开启 false:不开启 |
push_address | 是 | String | 推流地址。 |
push_password | 是 | String | 推流密钥。 |
输出参数
错误码列表
状态码 | 错误码 | 错误描述 |
500 | 400004 | 请检查推流地址是否正确,不能有重复推流地址、视频号地址只能有一个、视频号地址前缀必须符合要求。 |
500 | 400007 | 无权限,需要会议创建者、主持人。 |
500 | 190001 | 存在未注册的用户。 |
500 | 400005 | 请检查 meeting_id 是否正确。 |
400 | 190004 | 参数非法,请对照接口文档检查您的参数。 |
500 | 400001 | 三方推流数量超过限制。 |
400 | 500014 | 账号无权限。 |
500 | 400006 | 无权限,需要会议创建者。 |
代码示例
输入示例
POSThttps://api.meeting.qq.com/v1/meetings/{meetingId}/live_play/live-stream-address{"instanceid":1,"userid":"testuser123","push_stream_info":[{"platform_name":"dGVzdDEyMw==","platform_type":1,"push_password":"123123123123123","enable_push_addres":true, "push_address":"rtmp://123123.123live.123.com/trtc_1451297868/"},{"platform_name":"MTIzdGVzdA==","platform_type":2,"push_password":"123123123123321","enable_push_addres":true,"push_address":"rtmp://321.321.fs.tv/123live/"}]}
输出示例
无。