tencent cloud

智能媒资托管

产品简介
产品概述
功能介绍
产品优势
应用场景
基本概念
购买指南
快速入门
创建媒体库
发起请求
服务级 API 文档
History
Introduction
API Category
Making API Requests
PaaS Service APIs
Official Cloud Disk APIs
Data Types
Error Codes
业务级 API 文档
简介
访问令牌操作接口
租户空间操作接口
文件操作接口
目录或相簿操作接口
回收站操作接口
配额操作接口
查询任务操作接口
搜索操作接口
历史版本操作接口
目录和文件批量操作接口
收藏操作接口
Error Codes
SDK 文档
Android SDK
iOS SDK
鸿蒙 SDK
常见问题
企业网盘
产品简介
购买指南
快速入门
常见问题
Service Level Agreement
词汇表

获取文件链接

PDF
聚焦模式
字号
最后更新时间: 2026-01-07 11:03:08

简介

本文档提供关于获取文件下载链接、文档预览链接、缩略图链接的 API 概览以及 SDK 示例代码。
API
操作描述
获取文档预览链接
获取文件下载链接
获取照片/视频封面缩略图链接

获取文档预览

功能说明

用于获取文档预览链接。

示例代码

try {
val previewAccessUrl: String = smh.getPreviewAccessUrl(
//文件路径
filePath = "filePath",
//历史版本号
historyId = 123456,
//用途(用于标记该链接的使用场景)
purpose = Purpose.PREVIEW
)
} catch (e: Exception) {
e.printStackTrace()
}

获取文件下载链接

功能说明

用于获取文件下载链接。

示例代码

try {
val downloadAccessUrl: String = smh.getDownloadAccessUrl(
//文件路径
filePath = "filePath",
//历史版本号
historyId = 123456,
//文件路径是否已经 url 编码
encode = true
)
} catch (e: Exception) {
e.printStackTrace()
}

获取缩略图

功能说明

用于获取缩略图链接。

示例代码

示例1:
try {
val thumbnailUrl: String = smh.getThumbnailAccessUrl(
//文件名
name = "name",
//目录名
dir = Directory(),
//历史版本号
historyId = 123456,
//生成的预览图尺寸
size = 100,
//等比例缩放百分比,不传 Size 时生效
scale = 80,
//缩放宽度,不传高度时,高度按等比例缩放,不传 Size 和 Scale 时生效;
widthSize = 100,
//缩放高度,不传宽度时,宽度按等比例缩放,不传 Size 和 Scale 时生效;
heightSize = 100,
//用途(用于标记该链接的使用场景)
purpose = Purpose.PREVIEW
)
} catch (e: Exception) {
e.printStackTrace()
}
示例2:
try {
val thumbnailResult: ThumbnailResult = smh.getThumbnail(
//文件名
name = "name",
//目录名
dir = Directory(),
//生成的预览图尺寸
size = 100,
//等比例缩放百分比,不传 Size 时生效
scale = 80,
//缩放宽度,不传高度时,高度按等比例缩放,不传 Size 和 Scale 时生效;
widthSize = 100,
//缩放高度,不传宽度时,宽度按等比例缩放,不传 Size 和 Scale 时生效;
heightSize = 100,
//帧数,针对 gif 的降帧处理
frameNumber = 6,
//用途(用于标记该链接的使用场景)
purpose = Purpose.PREVIEW
)
val thumbnailUrl = thumbnailResult.location
} catch (e: Exception) {
e.printStackTrace()
}


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈