tencent cloud

文档反馈

视频标签

最后更新时间:2022-08-09 14:33:56

    功能说明

    数据万象支持自定义设置回调 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

    如果任务是通过工作流触发的,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 电话支持