taskId、targetPath、页数和解析状态。getPreParseFileName / onGetPreParseFileNameFn,携带 info 和 suffix。suffix 的短时签名 URL。下图给出预解析总体方案架构:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
appId | string | 是 | 应用 ID |
sourcePath | string | 是 | 原文件 OSS 路径,如 oss://bucket/path/file.pptx |
taskType | number | 是 | 任务类型 |
callbackUrl | string | 是 | 解析结果回调地址 |
validBegin | number | 是 | Unix 秒级时间戳 |
validTime | number | 是 | 有效期,建议 300 秒 |
signature | string | 是 | 签名 |
exportBoard | boolean | 否 | 是否生成导出板书所需文件 |
| 值 | 类型 |
|---|---|
4 | PPT |
5 | Word/Excel |
8 |
{
"code": 0,
"msg": "success",
"obj": {
"taskId": "task-id"
}
}{
"code": 1001,
"msg": "源文件路径不存在"
}| 场景 | 权限 |
|---|---|
| 读取源文件 | GetObject |
| 写入解析产物 | PutObject |
| 列出解析产物 | ListObjects |
| 导出板书读取解析信息 | GetObject、ListObjects |
callbackUrl。| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
taskId | string | 是 | 解析任务 ID |
taskStatus | number | 是 | 100 成功,101 失败 |
targetPath | string | 成功时必填 | 解析产物目录 |
convertPages | number | 部分类型成功时返回 | 转换页数 |
taskId 幂等更新任务状态。重复回调不能产生重复业务副作用。>= 500;suffix,例如:/index.html/ispring.html/info.json/1.jpg/2.jpg/1.jpg?x-oss-process=...suffix 生成短时 URL。suffix 必须做规范化和白名单校验。../、反斜杠、绝对路径、空路径。| 平台 | 回调 |
|---|---|
| Android | getPreParseFileName(info, suffix, callback) |
| iOS | getPreParseFileName info, suffix, result |
| Electron | onGetPreParseFileNameFn(info, { suffix }) |
| 播放器 SDK | getPreParseFileName(info, { suffix }) |
getPreParseFileName。