文档预览
文档预览功能支持 ppt、xls、doc、pdf 等格式文档进行在线预览,便于您进行文档内容管理与访问。
说明 要使用文档预览功能,您需要先开通智能媒体管理 IMM,并在 OSS 中绑定 IMM,详情请参阅智能媒体管理快速开始。
参数
操作名称:imm/previewdoc
参数说明如下:
名称 | 取值 | 描述 |
---|---|---|
copy | 0/1 | 指定预览文件是否能够复制文档内容。
值为 1,表示支持复制。 值为 0,表示不支持复制。 |
流程介绍
说明 无论源文件权限是否为公共读,出于安全性考虑此处建议使用 URL 签名方式。
文档预览流程如下:
- 客户端向服务端发起预览请求,并提供要预览的文件名。
- 服务端根据请求文件进行 URL 签名,将签名完成的 URL 提供给客户端。
- 客户端拿到签名后直接访问 OSS 查看文件。
示例
假如请求的 Bucket 为 doc-demo,该 Bucket 所在区域为华东 1,对应的域名为 oss-cn-hangzhou.aliyuncs.com,请求预览的文件为
example.docx。通过配置参数 copy_1 可以复制预览的文档内容。
http://doc-demo.oss-cn-hangzhou.aliyuncs.com/example.docx?x-oss-process=imm/previewdoc,copy_1
对于上面的 URL 采用 AccessKey ID、AccessKey Secret 签名后得到 SignURL 进行访问。
通过 SDK 请求示例:
# 创建存储空间实例,所有文件相关的方法都需要通过存储空间实例来调用。
bucket = oss2.Bucket(oss2.Auth(access_key_id, access_key_secret), endpoint, bucket_name)
# 文档预览,获取signURL。
process = 'imm/previewdoc,copy_1'
params = {}
params.update({bucket.PROCESS: process})
url = bucket.sign_url("GET", objectKey, 3600, params=params)
#打印结果
print url
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论