礼物进阶互动效果
收藏我的收藏
收藏礼物进阶互动开通文档参考：https://developer.open-douyin.com/docs/resource/zh-CN/interaction/jierushuoming/hudongshuju/liwushuju
注意
礼物进阶互动效果配置为不区分阵营时，本接入指南无需接入，配置为需要区分阵营时才需要接入
同步对局状态
开发者在对局开始时调用，同步对局开始事件；在对局结束时再次调用，同步对局结束事件。
// 同步对局状态 var res = await sdk.GetRoundApi().UpdateRoundStatusInfoAsync(_RoundStatusInfo);
调用参数
参数类 | 属性 | | 说明 | 参数备注 |
IRoundStatusInfo | long RoundId | | 对局 ID，同一个直播间 RoomID 下，RoundId 需要是递增的 | |
| long StartTime | | 本局开始时间，秒级时间戳 | |
| long EndTime | | 本局结束时间，秒级时间戳。同步的对局状态为对局结束时，该字段必传。 | |
| int Status | | 当前房间的游戏对局状态（1=已开始、2=已结束） | |
| List<IGroupResultInfo>？GroupResultList | | | 当对局状态为已结束时，该内容必填 |
| | string GroupId | 阵营 ID，取值来源来自开发者平台「进阶礼物配置」的 group_id，如：red | |
| | int Result | 对局结果（1=胜利、2=失败、3=平局） | |
返回说明：
返回类 | 属性 | 说明 |
IRoundDataRes | string ErrMsg | 错误描述，当 ErrCode 为 0 时 ErrMsg 为 “” |
| long ErrCode | 错误码，0 代表成功 |
上报阵营数据
观众通过评论、点赞、送礼等方式加入玩法时，调用该接口上报当前观众的阵营数据。
// 同步阵营数据 var res = await sdk.GetRoundApi().UpdateUserGroupInfoAsync(_roundUserGroupInfo);
调用参数：
参数类 | 属性 | 说明 |
IRoundUserGroupInfo | string GroupId | 阵营 ID，取值来源来自开发者平台「进阶礼物配置」的 group_id，如：red |
| string OpenId | 用户open_id |
| long RoundId | 对局 ID，同一个直播间 RoomID 下，RoundId 需要是递增的 |
返回说明：
返回类 | 属性 | 说明 |
IRoundDataRes | string ErrMsg | 错误描述，当 ErrCode 为 0 时 ErrMsg 为 “” |
| long ErrCode | 错误码，0 代表成功 |
错误码
错误码 | 错误码描述 | 排查建议 |
40001 | 参数错误 | 请求体中的必传参数是否都上传 |
4014034 | 请求过于频繁 | 接口有频控限制，建议降低请求的并发量 |
40004 | token 过期 | 重新请求 |
