tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
互动白板
    文档

    文档转码事件

    最后更新时间：2023-12-21 10:55:21

      转码进度

      事件名称
      TranscodeProgressChanged
      事件说明
      当文档转码进度发生改变时通知 App 后台。 EventData 数据结构定义
      参数名称
      类型
      描述
      TaskId
      String
      发生进度改变的文档 TaskId
      Progress
      Integer
      当前转码进度
      Resolution
      String
      文档分辨率，在文档转码服务解析出文件分辨率之前改值为空字符串
      Title
      String
      文档标题，在文档转码服务解析出文件标题之前改值为空字符串
      Pages
      Integer
      文档总页数，在文档转码服务解析出文件总页数之前改值为0
      示例
      {
        "EventType": "TranscodeProgressChanged",
        "ExpireTime": 1590046391,
        "SdkAppId": 1400000001,
        "Sign": "a2dabb362a9b811c0e26953a6276a41c",
        "Timestamp": 1575545412,
        "EventData": {
          "TaskId": "bj0mt2l23osdj300hl30",
          "Progress": 24,
          "Resolution": "1024x768",
          "Title": "测试.ppt",
          "Pages": 16
        }
      }

      转码结束

      事件名称
      TranscodeFinished
      事件说明
      当文档转码完成时通知 App 后台
      EventData 数据结构定义
      参数名称
      类型
      描述
      TaskId
      String
      转码完成的文档 TaskId
      Resolution
      String
      文档分辨率
      Title
      String
      文档标题
      Pages
      Integer
      文档总页数
      ResultUrl
      String
      文档转码结果
      ThumbnailUrl
      String
      缩略图 Url
      ThumbnailResolution
      String
      缩略图分辨率
      CompressFileUrl
      String
      转码结果打包压缩文件的下载 Url
      Error.Code
      String
      如果文档转码发生错误会有该字段，具体错误码描述请参考接口文档 查询文档转码任务
      Error.Message
      String
      如果文档转码发生错误的具体错误描述
      示例
      示例1 转码成功的回调
      {
        "ExpireTime": 1590046391,
        "SdkAppId": 1400000001,
        "Sign": "a2dabb362a9b811c0e26953a6276a41c",
        "Timestamp": 1575545412,
        "EventType": "TranscodeFinished",
        "EventData": {
          "TaskId": "bj0mt2l23osdj300hl30",
          "Resolution": "1024x768",
          "Title": "测试.ppt",
          "Pages": 16,
          "ResultUrl": "https://transcode-result/0agdnligqtgtvkm65emb/index.html",
          "ThumbnailUrl": "https://transcode-thumbnal/0agdnligqtgtvkm65emb/",
          "ThumbnailResolution": "793x1122",
          "CompressFileUrl": ""
        }
      }
      示例2 转码失败的回调
      {
        "ExpireTime": 1590046391,
        "SdkAppId": 1400000001,
        "Sign": "a2dabb362a9b811c0e26953a6276a41c",
        "Timestamp": 1575545412,
        "EventType": "TranscodeFinished",
        "EventData": {
          "Error": {
            "Code": "InvalidParameter.UrlFormatError",
            "Message": "文档下载 URL 不合法"
          },
          "TaskId": "bj0mt2l23osdj300hl30",
          "Resolution": "",
          "Title": "",
          "Pages": 0,
          "ResultUrl": "",
          "ThumbnailUrl": "",
          "ThumbnailResolution": "",
          "CompressFileUrl": ""
        }
      }

      PPT 检测结束

      事件名称
      PPTCheckFinished
      事件说明
      当 PPT 检测结束完成时通知 App 后台。
      EventData 数据结构定义
      参数名称
      类型
      描述
      TaskId
      String
      任务 Id
      IsOK
      bool
      PPT 文件是否正常
      ResultUrl
      String
      修复后的 PPT URL，只有创建任务时参数 AutoHandleUnsupportedElement=true，才有返回值
      Slides
      Array of ErrSlide
      错误 PPT 页面列表
      ErrSlide 结构定义：
      参数名称
      类型
      描述
      Page
      String
      页面
      Errs
      Array of ErrInfo
      错误元素列表
      ErrInfo 结构定义：
      参数名称
      类型
      描述
      Name
      String
      元素名称
      Type
      int
      0：不支持的墨迹类型，1：不支持自动翻页，2：存在已损坏音视频，3：存在不可访问资源，4：只读文件
      Detail
      String
      错误详情
      示例
      示例1 检测无异常的回调
      {
        "ExpireTime": 1590046391,
        "SdkAppId": 1400000001,
        "Sign": "a2dabb362a9b811c0e26953a6276a41c",
        "Timestamp": 1575545412,
        "EventType": "PPTCheckFinished",
        "EventData": {
          "TaskId": "bj0mt2l23osdj300hl30",
          "IsOK": true
        }
      }
      示例2 检测异常的回调
      {
        "ExpireTime": 1590046391,
        "SdkAppId": 1400000001,
        "Sign": "a2dabb362a9b811c0e26953a6276a41c",
        "Timestamp": 1575545412,
        "EventType": "PPTCheckFinished",
        "EventData": {
          "TaskId": "bj0mt2l23osdj300hl30",
          "IsOK": false,
          "ResultUrl": "https://xxx/xxx/测试_fixed.ppt",
          "Slides": [
            {
              "Page": "幻灯片5",
              "Errs": [{
                "Name": "Ink 1",
                "Type": 0,
                "Detail": "wps墨迹"
              }]
            }
          ]
        }
      }
      示例3 检测失败的回调
      {
        "ExpireTime": 1590046391,
        "SdkAppId": 1400000001,
        "Sign": "a2dabb362a9b811c0e26953a6276a41c",
        "Timestamp": 1575545412,
        "EventType": "PPTCheckFinished",
        "EventData": {
          "Error": {
            "Code": "InvalidParameter.UrlFormatError",
            "Message": "文档下载 URL 不合法"
          },
          "TaskId": "bj0mt2l23osdj300hl30"
        }
      }
      
      联系我们

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

      联系我们
      技术支持

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

      提交工单
      7x24 电话支持
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      隐私条款服务条款缓存条款