添加会议背景

最近更新时间:2024-07-08 11:48:53

我的收藏

接口描述

描述
对成功预定的会议添加会议背景,支持多个背景图片的添加。一场会议最多添加7个背景,且仅支持不超过10MB大小的 PNG 格式图片,分辨率最小为1920*1080。添加成功返回新增的会议背景信息。目前暂不支持 OAuth2.0 鉴权访问。
背景图片上传方式为异步上传,您可以通过订阅 素材上传结果 获得上传结果通知。
请求方式:POST
接口请求域名
https://api.meeting.qq.com/v1/meetings/{meeting_id}/backgrounds


输入参数

HTTP 请求头公共参数请参见签名验证章节的 公共参数说明
参数名称
必选
参数类型
参数描述
meeting_id
String
会议 ID。
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
default_image_order
Integer
图片列表中会议需要使用的背景图片序号,从1开始计数。
image_list
ImageList 对象数组
图片对象列表。

ImageList 对象

参数名称
必选
参数类型
参数描述
image_md5
String
背景图片 MD5(图片内容 MD5 的十六进制表示)。
image_url
String
背景图片 URL。

输出参数

参数名称
参数类型
参数描述
background_number
Integer
背景数量。
selected_background_id
String
会议应用的背景 ID。
background_list
BackgroundList 对象数组
背景对象列表。

BackgroundList 对象

参数名称
参数类型
参数描述
background_id
String
背景 ID。
image_md5
String
背景图片 MD5(图片内容 MD5 的十六进制表示)。

错误码列表

状态码
错误码
错误描述
500
20014
背景图片大小非法。
400
20026
应用背景序号超出范围。
400
190004
参数非法,请对照接口文档检查您的参数。
400
20018
会议背景数量超过最大值。
500
202001
会议明细获取失败,请检查会议是否存在。
500
20013
背景图片 URL 非法。
500
9042
没有权限。
500
190001
存在未注册的用户。

示例

输入示例

POST
https://api.meeting.qq.com/v1/meetings/6524541286408448530/backgrounds
{
"userid":"creator1",
"instanceid":1,
"default_image_order":2,
"image_list":[
{
"image_md5":"c8c7xxxxxxxxxxxxxxxxxxxxxxxx8a2e",
"image_url":"https://xxxxxx.cos.myqcloud.com/flower.png"
},
{
"image_url":"https://xxxxxx.cos.myqcloud.com/cat.png",
"image_md5":"c3daxxxxxxxxxxxxxxxxxxxxxxxx62a4"
}
]
}

输出示例

{
"background_number":2,
"selected_background_id":"f1fexxxxxxxxxxxxxxxxxxxxxxxx2d59",
"background_list":[
{
"background_id":"ca4exxxxxxxxxxxxxxxxxxxxxxxx6e93",
"image_md5":"c8c7xxxxxxxxxxxxxxxxxxxxxxxx8a2e"
},
{
"background_id":"f1fexxxxxxxxxxxxxxxxxxxxxxxx2d59",
"image_md5":"c3daxxxxxxxxxxxxxxxxxxxxxxxx62a4"
}
]
}