有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

接口描述

描述:可根据会议 ID 在会前和会中设置直播推流地址。
支持企业内的会议创建者、会议主持人与联席主持人在会中进行调用,会议创建者同时支持在会议外进行调用。
商业版和企业版最多支持添加1个微信视频号地址和10个推流平台,平台名称限制10个字符,且不允许纯空格和回车。
该接口暂不支持 OAuth2.0 鉴权访问。
请求方式:POST
接口请求域名
https://api.meeting.qq.com/v1/meetings/{meetingId}/live_play/live-stream-address

输入参数

HTTP 请求头公共参数参考签名验证章节里的 公共参数说明
参数名称
必选
参数类型
参数描述
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
推流平台名称。
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
无权限,需要会议创建者。

代码示例

输入示例

POST
https://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/"
}
]
}

输出示例

无。