有奖捉虫:云通信与企业服务文档专题,速来> HOT

转码进度

事件名称
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:只读文件 5:不支持的元素编辑锁定状态 6:可能有兼容问题的字体 7:设置了柔化边缘的 GIF 图片 8:存在不兼容的空格下划线 9:存在设置了分段动画的数学公式和文本混合内容 10:存在设置了分段动画的渐变色文本 11:存在不兼容的分散对齐方式 12:存在不兼容的多倍行距设置
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"
}
}