tencent cloud

文档反馈

视频标签

最后更新时间:2024-01-20 16:30:33

    功能说明

    数据万象支持自定义设置回调 URL,在任务完成后,系统向该 URL 发送 HTTP POST 请求,请求体中包含通知内容。您可通过配置的回调地址及时了解任务处理的进展和状态,以便进行其他业务操作。

    回调内容

    任务完成后,系统会向您设置的回调地址发送回调内容,该响应体返回为 application/xml 数据,包含完整节点数据的内容展示如下:
    <Response>
    <EventName>TaskFinish</EventName>
    <JobsDetail>
    <Code>Success</Code>
    <CreationTime>2022-07-01T10:05:48+0800</CreationTime>
    <EndTime>2022-07-01T10:06:02+0800</EndTime>
    <Input>
    <BucketId>test-123456789</BucketId>
    <Object>input/demo.mp4</Object>
    <Region>ap-chongqing</Region>
    </Input>
    <JobId>j535b10a4f8e211ec9452c1c27f56a659</JobId>
    <Message>Success</Message>
    <Operation>
    <UserData>This is my VideoTag job.</UserData>
    <VideoTag>
    <Scenario>Stream</Scenario>
    </VideoTag>
    <VideoTagResult>
    <StreamData>
    <Data>
    <ActionTags>
    <EndTime>11</EndTime>
    <StartTime>0</StartTime>
    <Tags>
    <Confidence>0.421531</Confidence>
    <Tag>说话</Tag>
    <TagCls>说话</TagCls>
    </Tags>
    </ActionTags>
    <ActionTags>
    <EndTime>12.88</EndTime>
    <StartTime>11.04</StartTime>
    <Tags/>
    </ActionTags>
    <ObjectTags>
    <Objects>
    <BBox>
    <X1>0.10181817412376404</X1>
    <X2>0.8069194555282593</X2>
    <Y1>0.6880248785018921</Y1>
    <Y2>0.8779844045639038</Y2>
    </BBox>
    <Confidence>0.808393</Confidence>
    <Name>电脑键盘</Name>
    </Objects>
    <TimeStamp>11</TimeStamp>
    </ObjectTags>
    <PersonTags/>
    <PlaceTags>
    <ClipFrameResult>办公室:0.55</ClipFrameResult>
    <ClipFrameResult>办公室:0.55</ClipFrameResult>
    <ClipFrameResult>办公室:0.59</ClipFrameResult>
    <ClipFrameResult>办公室:0.54</ClipFrameResult>
    <ClipFrameResult>办公室:0.42</ClipFrameResult>
    <ClipFrameResult>办公室:0.43</ClipFrameResult>
    <ClipFrameResult>办公室:0.33</ClipFrameResult>
    <ClipFrameResult>办公室:0.29</ClipFrameResult>
    <ClipFrameResult>办公室:0.15</ClipFrameResult>
    <ClipFrameResult>娱乐场:0.42</ClipFrameResult>
    <ClipFrameResult>办公室:0.33</ClipFrameResult>
    <EndIndex>275</EndIndex>
    <EndTime>11</EndTime>
    <StartIndex>0</StartIndex>
    <StartTime>0</StartTime>
    <Tags>
    <Confidence>0.591724</Confidence>
    <Tag>办公室</Tag>
    <TagCls>办公</TagCls>
    </Tags>
    <Tags>
    <Confidence>0.175342</Confidence>
    <Tag>超市/便利店/商店</Tag>
    <TagCls>商业</TagCls>
    </Tags>
    </PlaceTags>
    <PlaceTags>
    <ClipFrameResult>其他:0.09</ClipFrameResult>
    <ClipFrameResult>其他:0.21</ClipFrameResult>
    <ClipFrameResult>其他:0.19</ClipFrameResult>
    <ClipFrameResult>天空:0.28</ClipFrameResult>
    <ClipFrameResult>天空:0.25</ClipFrameResult>
    <ClipFrameResult>其他:0.30</ClipFrameResult>
    <ClipFrameResult>其他:0.28</ClipFrameResult>
    <ClipFrameResult>其他:0.49</ClipFrameResult>
    <ClipFrameResult>其他:0.56</ClipFrameResult>
    <ClipFrameResult>其他:0.58</ClipFrameResult>
    <EndIndex>322</EndIndex>
    <EndTime>12.88</EndTime>
    <StartIndex>276</StartIndex>
    <StartTime>11.04</StartTime>
    <Tags>
    <Confidence>0.581444</Confidence>
    <Tag>其他</Tag>
    <TagCls>其他</TagCls>
    </Tags>
    <Tags>
    <Confidence>0.283301</Confidence>
    <Tag>天空</Tag>
    <TagCls>自然/户外</TagCls>
    </Tags>
    </PlaceTags>
    <Tags>
    <Confidence>0.355083</Confidence>
    <Tag>MOBA类-王者荣耀</Tag>
    </Tags>
    <Tags>
    <Confidence>0.587103</Confidence>
    <Tag>游戏</Tag>
    </Tags>
    <Tags>
    <Confidence>0.544651</Confidence>
    <Tag>办公室</Tag>
    </Tags>
    <Tags>
    <Confidence>0.182886</Confidence>
    <Tag>超市/便利店/商店</Tag>
    </Tags>
    </Data>
    <SubErrCode>0</SubErrCode>
    <SubErrMsg>ok</SubErrMsg>
    </StreamData>
    </VideoTagResult>
    </Operation>
    <QueueId>p2242ab62c7c94486915508540933a2c6</QueueId>
    <StartTime>2022-07-01T10:05:50+0800</StartTime>
    <State>Success</State>
    <Tag>VideoTag</Tag>
    <VideoTag/>
    </JobsDetail>
    </Response>
    具体的数据内容如下:
    节点名称(关键字)
    父节点
    描述
    类型
    Response
    保存结果的容器
    Container
    Container 节点 Response 的内容:
    节点名称(关键字)
    父节点
    描述
    类型
    EventName
    Response
    固定值,为 TaskFinish
    String
    JobsDetail
    Response
    任务的详细信息
    Container 数组
    Container 节点 JobsDetail 的内容:
    如果任务是通过工作流触发的,Response.JobsDetail.Input还会包含 CosHeaders 节点,类型为 Container 数组。
    Container 节点 CosHeaders 的内容:
    节点名称(关键字)
    父节点
    描述
    类型
    Key
    Response.JobsDetail.Input.CosHeaders
    自定义 Header 的名称
    String
    Value
    Response.JobsDetail.Input.CosHeaders
    自定义 Header 的值
    String
    如果任务是通过工作流触发的,Response.JobsDetail 还会包含 Workflow 节点,类型为 Container。
    Container 节点 Workflow 的内容:
    节点名称(关键字)
    父节点
    描述
    类型
    RunId
    Response.Workflow
    工作流实例 ID
    String
    WorkflowId
    Response.Workflow
    工作流 ID
    String
    WorkflowName
    Response.Workflow
    工作流名称
    String
    Name
    Response.Workflow
    工作流节点名称
    String

    实际案例

    案例 1:通过任务接口触发的任务回调

    <Response>
    <EventName>TaskFinish</EventName>
    <JobsDetail>
    <Code>Success</Code>
    <CreationTime>2022-07-01T10:05:48+0800</CreationTime>
    <EndTime>2022-07-01T10:06:02+0800</EndTime>
    <Input>
    <BucketId>test-123456789</BucketId>
    <Object>input/demo.mp4</Object>
    <Region>ap-chongqing</Region>
    </Input>
    <JobId>j535b10a4f8e211ec9452c1c27f56a659</JobId>
    <Message>Success</Message>
    <Operation>
    <UserData>This is my VideoTag job.</UserData>
    <VideoTag>
    <Scenario>Stream</Scenario>
    </VideoTag>
    <VideoTagResult>
    <StreamData>
    <Data>
    <ActionTags>
    <EndTime>11</EndTime>
    <StartTime>0</StartTime>
    <Tags>
    <Confidence>0.421531</Confidence>
    <Tag>说话</Tag>
    <TagCls>说话</TagCls>
    </Tags>
    </ActionTags>
    <ActionTags>
    <EndTime>12.88</EndTime>
    <StartTime>11.04</StartTime>
    <Tags/>
    </ActionTags>
    <ObjectTags>
    <Objects>
    <BBox>
    <X1>0.10181817412376404</X1>
    <X2>0.8069194555282593</X2>
    <Y1>0.6880248785018921</Y1>
    <Y2>0.8779844045639038</Y2>
    </BBox>
    <Confidence>0.808393</Confidence>
    <Name>电脑键盘</Name>
    </Objects>
    <TimeStamp>11</TimeStamp>
    </ObjectTags>
    <PersonTags/>
    <PlaceTags>
    <ClipFrameResult>办公室:0.55</ClipFrameResult>
    <ClipFrameResult>办公室:0.55</ClipFrameResult>
    <ClipFrameResult>办公室:0.59</ClipFrameResult>
    <ClipFrameResult>办公室:0.54</ClipFrameResult>
    <ClipFrameResult>办公室:0.42</ClipFrameResult>
    <ClipFrameResult>办公室:0.43</ClipFrameResult>
    <ClipFrameResult>办公室:0.33</ClipFrameResult>
    <ClipFrameResult>办公室:0.29</ClipFrameResult>
    <ClipFrameResult>办公室:0.15</ClipFrameResult>
    <ClipFrameResult>娱乐场:0.42</ClipFrameResult>
    <ClipFrameResult>办公室:0.33</ClipFrameResult>
    <EndIndex>275</EndIndex>
    <EndTime>11</EndTime>
    <StartIndex>0</StartIndex>
    <StartTime>0</StartTime>
    <Tags>
    <Confidence>0.591724</Confidence>
    <Tag>办公室</Tag>
    <TagCls>办公</TagCls>
    </Tags>
    <Tags>
    <Confidence>0.175342</Confidence>
    <Tag>超市/便利店/商店</Tag>
    <TagCls>商业</TagCls>
    </Tags>
    </PlaceTags>
    <PlaceTags>
    <ClipFrameResult>其他:0.09</ClipFrameResult>
    <ClipFrameResult>其他:0.21</ClipFrameResult>
    <ClipFrameResult>其他:0.19</ClipFrameResult>
    <ClipFrameResult>天空:0.28</ClipFrameResult>
    <ClipFrameResult>天空:0.25</ClipFrameResult>
    <ClipFrameResult>其他:0.30</ClipFrameResult>
    <ClipFrameResult>其他:0.28</ClipFrameResult>
    <ClipFrameResult>其他:0.49</ClipFrameResult>
    <ClipFrameResult>其他:0.56</ClipFrameResult>
    <ClipFrameResult>其他:0.58</ClipFrameResult>
    <EndIndex>322</EndIndex>
    <EndTime>12.88</EndTime>
    <StartIndex>276</StartIndex>
    <StartTime>11.04</StartTime>
    <Tags>
    <Confidence>0.581444</Confidence>
    <Tag>其他</Tag>
    <TagCls>其他</TagCls>
    </Tags>
    <Tags>
    <Confidence>0.283301</Confidence>
    <Tag>天空</Tag>
    <TagCls>自然/户外</TagCls>
    </Tags>
    </PlaceTags>
    <Tags>
    <Confidence>0.355083</Confidence>
    <Tag>MOBA类-王者荣耀</Tag>
    </Tags>
    <Tags>
    <Confidence>0.587103</Confidence>
    <Tag>游戏</Tag>
    </Tags>
    <Tags>
    <Confidence>0.544651</Confidence>
    <Tag>办公室</Tag>
    </Tags>
    <Tags>
    <Confidence>0.182886</Confidence>
    <Tag>超市/便利店/商店</Tag>
    </Tags>
    </Data>
    <SubErrCode>0</SubErrCode>
    <SubErrMsg>ok</SubErrMsg>
    </StreamData>
    </VideoTagResult>
    </Operation>
    <QueueId>p2242ab62c7c94486915508540933a2c6</QueueId>
    <StartTime>2022-07-01T10:05:50+0800</StartTime>
    <State>Success</State>
    <Tag>VideoTag</Tag>
    <VideoTag/>
    </JobsDetail>
    </Response>

    案例 2:通过任务接口触发的任务回调, 格式为 JSON

    {
    "EventName": "TaskFinish",
    "JobsDetail": [{
    "Code": "Success",
    "CreationTime": "2022-07-01T10:05:48+0800",
    "EndTime": "2022-07-01T10:06:02+0800",
    "Input": {
    "BucketId": "test-123456789",
    "Object": "input/demo.mp4",
    "Region": "ap-chongqing"
    },
    "JobId": "j535b10a4f8e211ec9452c1c27f56a659",
    "Message": "Success",
    "Operation": {
    "UserData": "This is my VideoTag job.",
    "VideoTag": {
    "Scenario": "Stream"
    },
    "VideoTagResult": {
    "StreamData": {
    "Data": {
    "ActionTags": [{
    "EndTime": "11",
    "StartTime": "0",
    "Tags": {
    "Confidence": "0.421531",
    "Tag": "说话",
    "TagCls": "说话"
    }
    },
    {
    "EndTime": "12.88",
    "StartTime": "11.04"
    }
    ],
    "ObjectTags": {
    "Objects": {
    "BBox": {
    "X1": "0.10181817412376404",
    "X2": "0.8069194555282593",
    "Y1": "0.6880248785018921",
    "Y2": "0.8779844045639038"
    },
    "Confidence": "0.808393",
    "Name": "电脑键盘"
    },
    "TimeStamp": "11"
    },
    "PlaceTags": [{
    "ClipFrameResult": [
    "办公室:0.55",
    "办公室:0.55",
    "办公室:0.59",
    "办公室:0.54",
    "办公室:0.42",
    "办公室:0.43",
    "办公室:0.33",
    "办公室:0.29",
    "办公室:0.15",
    "娱乐场:0.42",
    "办公室:0.33"
    ],
    "EndIndex": "275",
    "EndTime": "11",
    "StartIndex": "0",
    "StartTime": "0",
    "Tags": [{
    "Confidence": "0.591724",
    "Tag": "办公室",
    "TagCls": "办公"
    },
    {
    "Confidence": "0.175342",
    "Tag": "超市/便利店/商店",
    "TagCls": "商业"
    }
    ]
    },
    {
    "ClipFrameResult": [
    "其他:0.09",
    "其他:0.21",
    "其他:0.19",
    "天空:0.28",
    "天空:0.25",
    "其他:0.30",
    "其他:0.28",
    "其他:0.49",
    "其他:0.56",
    "其他:0.58"
    ],
    "EndIndex": "322",
    "EndTime": "12.88",
    "StartIndex": "276",
    "StartTime": "11.04",
    "Tags": [{
    "Confidence": "0.581444",
    "Tag": "其他",
    "TagCls": "其他"
    },
    {
    "Confidence": "0.283301",
    "Tag": "天空",
    "TagCls": "自然/户外"
    }
    ]
    }
    ],
    "Tags": [{
    "Confidence": "0.355083",
    "Tag": "MOBA类-王者荣耀"
    },
    {
    "Confidence": "0.587103",
    "Tag": "游戏"
    },
    {
    "Confidence": "0.544651",
    "Tag": "办公室"
    },
    {
    "Confidence": "0.182886",
    "Tag": "超市/便利店/商店"
    }
    ]
    },
    "SubErrCode": "0",
    "SubErrMsg": "ok"
    }
    }
    },
    "QueueId": "p2242ab62c7c94486915508540933a2c6",
    "StartTime": "2022-07-01T10:05:50+0800",
    "State": "Success",
    "Tag": "VideoTag"
    }]
    }
    
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持