调用 AddInteractionScriptComments 接口，新增一条或多条互动脚本评论。在绑定互动脚本的视频作为录播直播播放到指定时间节点时，会按照互动脚本配置的用户身份和昵称，发送预设的评论内容。

注意事项 #

• 请求频率：单用户请求频率限制为 10 次/秒。
• 使用限制：单次接口调用最多支持新增 1000 条评论。在一个互动脚本中，每秒最多支持添加 10 条评论。
• 前提条件：确保您拥有火山引擎主账号或具备以下权限的子账号。有关如何添加子账号，详见子账号管理。
  • 媒资库 > 视频管理 > 直播暂存 > 可编辑权限：用于在绑定直播暂存视频的互动脚本中新增评论。
  • 媒资库 > 视频管理 > 视频库 > 可编辑权限：用于在绑定视频库视频的互动脚本中新增评论。
  • 直播间的直播控制 > 可编辑权限：用于在绑定录播直播视频的互动脚本中新增评论。

请求说明 #

• 请求方式：POST
• 请求地址：https://livesaas.volcengineapi.com/?Action=AddInteractionScriptComments&Version=2023-08-01

调试 #

请求参数 #

下表仅列出该接口特有的请求参数和部分公共参数。更多信息详见公共参数。

Query #

Body #

Comments #

返回参数 #

FailList #

请求示例 #

POST https://livesaas.volcengineapi.com/?Action=AddInteractionScriptComments&Version=2023-08-01
{
    "Comments": [
        {
            "SendTime": 10,
            "Role": 1,
            "Nickname": "观众 A",
            "Content": "你好"
        },
        {
            "SendTime": 20,
            "Role": 1,
            "Nickname": "观众 B",
            "Content": "你好"
        }
    ],
    "InteractionScriptId": 1
}

返回示例 #

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "AddInteractionScriptComments",
        "Version": "2023-08-01",
        "Service": "livesaas",
        "Region": "cn-north-1",
        "SystemTime": 1697446406
    },
    "Result": {
        "SuccessAmount": 1,
        "FailList": [
            {
                "Index": 0,
                "FailType": 1
            }
        ],
        "LatestCommentId": 1
    }
}

错误码 #

访问公共错误码和错误码获取详细信息。