PlasoElectronSdk.insertObject(fileObject)。url,SDK 直接访问该 URL。info,普通资源通过 getExtFileName 获取 URL,预解析资源通过 getPreParseFileName 获取 URL。| 方式 | 说明 | 适用 |
|---|---|---|
url | 插入时直接给 SDK 一个可访问完整 URL | 长期公开可访问文件 |
info | 插入时给 SDK 一个业务标识,SDK 需要访问时回调业务方换取 URL | 私有文件、短时签名 URL、需要鉴权的文件 |
info 方式。UpimeFile,Electron 为 FileObject,但核心字段一致:| 字段 | 说明 |
|---|---|
type | 资源类型,取值以各端 SDK 枚举为准 |
title | 文件显示标题;建议带扩展名;gif 必须带 .gif,否则可能被当作 jpeg |
url | 完整文件 URL,SDK 直接访问 |
info | 业务自定义资源标识,SDK 通过回调换取 URL |
totalPages | 预解析 PDF/DOC/XLS 页数;预解析 PDF/DOC/XLS 场景必填 |
url 和 info 通常二选一。若都传,具体优先级以 SDK 当前版本为准;建议不要同时传,避免行为不清晰。{
type: FILE_TYPE.IMAGE,
title: '图片.png',
url: 'https://example.com/image.png'
}
{
type: FILE_TYPE.IMAGE,
title: '图片.png',
info: ['file', { id: 'image-001' }]
}{
type: FILE_TYPE.PPT,
title: '课件.pptx',
url: 'https://example.com/demo.pptx'
}{
type: FILE_TYPE.VIDEO,
title: '视频.mp4',
info: ['file', { id: 'video-001' }]
}{
type: FILE_TYPE.PDF,
title: '讲义.pdf',
info: ['file', { id: 'pdf-001' }]
}{
type: FILE_TYPE.WORD,
title: '资料.docx',
url: 'https://example.com/demo.docx'
}url 或 info,以各端 SDK 当前版本为准。{
type: FILE_TYPE.ISPRINGPPT,
title: '课件.pptx',
info: ['parsed', { id: 'ppt-001' }]
}{
type: FILE_TYPE.PDF,
title: '讲义.pdf',
info: ['parsed', { id: 'pdf-001' }],
totalPages: 12
}{
type: FILE_TYPE.DOC,
title: '资料.docx',
info: ['parsed', { id: 'doc-001' }],
totalPages: 12
}| 平台 | 回调 |
|---|---|
| Android | getExtFileName(info, callback) |
| iOS | getExtFileName info, result |
| Electron | onGetExtFileNameFn(info) |
| 播放器 SDK | getExtFileName(info) |
info 原样回调给接入方。info 传给客户服务端。onFilePath(null)。suffix。| 项 | 说明 |
|---|---|
入参 info | 来自插入资源时的 info |
入参 suffix | 当前要加载的解析产物路径,如 /info.json、/1.jpg、/index.html |
| 返回值 | 对应文件的公网可访问 URL 或短时签名 URL |
suffix 安全规则见《文档预解析》。info 插入过文件,历史课堂播放时仍然需要获取这些文件的 URL。此时播放器必须使用 jssdk 接入,并实现 getExtFileName。纯 URL 接入无法处理这类资源回调。