文档预览功能支持PPT、XLS、DOC、PDF等格式文件的在线预览,便于您进行文档内容管理与访问。

说明 要使用文档预览功能,您需要先开通智能媒体管理IMM,并在OSS中绑定IMM,详情请参见快速开始

参数

操作名称:imm/previewdoc

参数说明如下:

名称 取值 描述
copy 0/1 指定预览文件是否能够复制文档内容。

值为 1,表示支持复制。

值为 0,表示不支持复制。

流程介绍

说明 无论源文件权限是否为公共读,出于安全性考虑此处建议使用URL签名方式。

文档预览流程如下:

  1. 客户端向服务端发起预览请求,并提供要预览的文件名。
  2. 服务端根据请求文件进行URL签名,将签名完成的URL提供给客户端。
  3. 客户端拿到签名后直接访问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