腾讯会议
有奖：语音产品征文挑战赛火热进行中> HOT
文档中心 > 腾讯会议 > 开放平台文档 > 服务端 API > REST APIs > 会议布局和背景管理 > 添加会议背景

添加会议背景

最近更新时间：2024-04-24 17:50:13

我的收藏

本页目录：

接口描述

描述：
对成功预定的会议添加会议背景，支持多个背景图片的添加。一场会议最多添加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"
        }
    ]
}
?
中国站
http://www.vxiaotou.com