客户端上传

上传地址和凭证方式

方式简介：客户端向服务端获取上传地址和凭证后直接上传媒体资源到OSS。

阶段一：获取上传地址和凭证

客户端向应用服务端（AppServer）发起HTTP请求，携带本次上传的业务参数（如 Title、FileName、CateId、Tags 等媒资元数据）。AppServer收到后，使用持有的AK/SK调用VOD的CreateUploadVideo接口。VOD服务返回三个关键结果：

• UploadAuth：临时上传令牌。

• UploadAddress：目标OSS 路径（Base64 编码）。

• VideoId：媒资唯一标识。

AppServer将这三者透传给客户端。

阶段二：直传文件

客户端拿到凭证后，调用上传 SDK 的初始化方法，传入UploadAuth、UploadAddress、VideoId和本地文件路径。SDK内部自动完成：

1. 解析 UploadAddress，得到 OSS Endpoint 和 Object Key。

2. 将文件按分片上传至 OSS 存储，过程支持断点续传和进度回调。

整个过程中，文件直接从客户端传到 OSS，不经过AppServer。

阶段三：返回上传结果

OSS 完成文件上传后，向客户端 SDK 返回成功状态，SDK 触发 onUploadSucceed 回调，携带 VideoId。与此同时，VOD 服务侧会自动感知上传完成，并根据预设的 TemplateGroupId 或 WorkflowId 触发转码和处理流水线。也可配置事件回调以主动接收FileUploadComplete事件通知。

STS Token方式

方式简介：用户应用服务器向客户端下发STS Token，客户端向点播服务获取上传地址和凭证，再上传媒资到OSS。

阶段一：获取STS临时凭证

客户端向 AppServer 请求临时访问凭证。AppServer 使用 AK/SK 调用阿里云 STS 的AssumeRole接口，获取一组有时效限制的 AccessKeyId、AccessKeySecret、SecurityToken（有效期可设 900~3600 秒），然后返回给客户端。完整 STS 授权流程请参见上传授权。

阶段二：获取上传凭证 + 直传文件

客户端用STS Token 初始化上传 SDK。SDK 内部会自动携带 STS Token 调用 VOD 的 CreateUploadVideo（传入 Title、FileName 等参数），获取 UploadAuth + UploadAddress + VideoId，然后自动执行分片上传。整个过程对开发者透明，无需手动调用 VOD 接口。

阶段三：返回上传结果

与上传地址和凭证方式相同。OSS 完成文件上传后，SDK 触发onUploadSucceed 回调，携带VideoId。VOD 服务侧自动触发转码和处理流水线。也可配置事件回调以接收FileUploadComplete事件通知。