接口说明
用于实时更新视频流画面中的人物大小、位置、背景图。
说明：
此接口不再建议使用，后续不再继续迭代新特性。当需要设置数智人背景、人物大小时的推荐使用方法：设置绿幕背景推流，自行使用流媒体软件抠绿叠加前后景、缩放人物大小。
注意：
此接口请求频次限制：单一session每5秒可请求一次。
调用协议
HTTPS + JSON
POST /v2/ivh/sessionmanager/sessionmanagerservice/updatesessionconfig
Header Content-Type: application/json;charset=utf-8
请求参数
参数名称 | 类型 | 必选 | 描述 |
ReqId | String | 是 | 单次请求唯一标识。 |
SessionId | String | 是 | 会话id。 |
SpaceParam | 否 | 空间信息，2D小样本支持此参数。 | |
ImageParam | 否 | 形象信息，3D形象支持此参数。 |
SpaceParam
名称 | 类型 | 必选 | 描述 |
BackgroundUrl | String | 否 | 背景 URL 地址（小于1M大小，最好与输出分辨率对齐，否则会被拉伸填充）要求：jpg、jpeg、png（其他格式不支持），不传使用上次背景图。 |
ImagePosition | float | 是 | 人物在背景图中的X位置，人物图片中轴居中X为0，取值范围为[-0.5,0.5]，不可移出背景图范围，线性值。 |
ImagePositionVertical | float | 是 | 人物在背景图中的Y位置，人物图片贴底Y为0，取值范围为[-0.5,0.25]，向下可以移出背景图，线性值。 |
ImageZoom | float | 是 | 人物相对于原始素材图的缩放比例，由缩放后的大小和原始人物素材图计算得到的缩放比例。计算公式：缩放后人物图片的宽度/(预览区域背景宽度/目标分辨率宽度)/人物原始素材的宽度。建议取值范围[0.25,2]。 |
ImageParam
名称 | 类型 | 必选 | 描述 |
ImageVerticalOffset | float | 否 | 3D形象上半身垂直方向转动角度。 |
ImageHorizontalOffset | float | 否 | 3D形象上半身水平方向转动角度。 |
ImageExtraParam | float | 否 |
返回参数
名称 | 类型 | 必选 | 描述 |
ReqId | String | 是 | 单次请求唯一标识。 |
请求示例
{"Header": {},"Payload": {"ReqId": "d7aa08da33dd4a662ad5be508c5b77cf","SessionId": "m123adfafvbadsafd","ImageParam": {"ImageVerticalOffset": 10,"ImageHorizontalOffset": 10,"ImageExtraParam": "{\\"JacketColor\\":{\\"colorValue\\":10491928},\\"DressColor\\": {\\"colorValue\\":10491928},\\"shoeColor\\": {\\"colorValue\\": 10491928}}"},"SpaceParam": {"BackgroundUrl": "https://virtualhuman-cos-prod-1251316161.cos.ap-nanjing.myqcloud.com/ai-resource/1518804312073965568","ImagePosition": -0.01,"ImagePositionVertical": -0.01,"ImageZoom": 1}}}
返回示例
{"Header": {"Code": 0,"Message": "","RequestID": "123",},"Payload": {"ReqId": "d7aa08da33dd4a662ad5be508c5b77cf",}}
