客户端上传
客户端上传是指将移动端媒体文件直接上传到点播存储。相对于服务端代理上传，客户端上传避免了业务服务器中转文件，节省了服务器资源。
功能说明
客户端上传SDK支持本地文件上传和网络文件上传。
功能点 | 说明 | 备注 |
支持客户端 | 目前支持的客户端包括：Web、iOS、Android、微信小程序。 | 暂无。 |
媒体说明 |
|
说明 设置URL上传时需要将URL编码后再传入使用，避免存在特殊字符导致无法上传的情况。 |
存储地址 | 支持使用默认存储地址或指定存储地址。 | 默认存储地址可以修改。详情请参见管理存储Bucket。 URL上传仅支持华东2（上海）地域。 可通过设置获取上传地址和凭证相关接口StorageLocation参数实现 |
媒资管理 | 支持设置元数据，如媒体标题、媒体标签、媒体分类、视频封面等。 | 可通过获取上传地址和凭证相关接口的参数（如Title、Tags、CateId、CoverURL等）设置。 |
音视频转码 | 支持通过指定转码模板或工作流设置转码。 也支持不转码。 | 可通过获取上传地址和凭证相关接口的参数（如TemplateGroupId、WorkflowId等）设置。 |
上传授权 |
| 推荐使用上传地址和凭证方式。阅读上传流程了解两种方式的流程差异。 |
上传控制 | 包括开始、停止、暂停、恢复。 支持断点续传。 | 上传SDK内部会完成断点续传的功能，用户不需要关心任何断点和片段恢复，因为异常情况导致的视频上传失败重新上传都会从断点处开始上传。 |
上传加速 | 需填写宜搭信息申请，开通上传加速功能。 | 申请开通后，可通过SDK |
网络切换 | 支持移动网络3G/4G与WIFI之间切换。 | 为了避免浪费3G/4G网络下的流量，切换到3G/4G网络时，可以调用pause暂停上传。在切换回WIFI网络时，调用resume恢复上传（网络切换部分需要应用自己实现判断）。 |
事件通知 | 支持设置回调获取上传事件通知。支持的事件通知请参见上传设置。 | 配置回调请参见回调配置。 |
上传流程
客户端上传SDK封装了OSS上传逻辑。在客户端上传媒体文件时，会直接将文件上传到点播存储（基于OSS），不会再经服务端进行中转，故客户端上传必须进行鉴权，也就是需要您在应用服务器上部署授权服务以获取上传地址和凭证。目前客户端上传SDK支持两种授权方式：上传地址和凭证方式、STS Token方式。不同授权方式对应的上传流程存在差异。
推荐使用上传地址和凭证方式，与STS Token方式对比，授权较为简单、安全性较高（可以控制单个视频权限）、可灵活配置多种返回参数、冗余度较高等。
上传地址和凭证方式
方式简介：客户端向服务端获取上传地址和凭证后直接上传媒体资源到OSS。
在用户应用服务器上部署授权服务（如集成点播服务端SDK）用于获取上传地址和凭证。
说明用户应用服务器需要提供的服务端接口
提供获取音视频上传地址和凭证的接口：服务端调用CreateUploadVideo - 获取音视频上传地址和凭证。
提供刷新音视频上传地址和凭证的接口：服务端调用RefreshUploadVideo - 刷新视频上传凭证。
提供获取图片上传地址和凭证的接口：服务端调用CreateUploadImage - 获取图片上传地址和凭证。
提供获取辅助媒资上传地址和凭证的接口：服务端调用CreateUploadAttachedMedia - 获取辅助媒资上传地址和凭证。
客户端向用户应用服务器发起请求获取上传地址和凭证。
用户应用服务器向视频点播服务发起请求获取上传地址和凭证。
点播服务返回上传地址和凭证。
说明点播服务在下发上传地址和凭证时还会自动创建媒资信息，即媒体ID（MediaId），用于媒资生命周期管理或媒体处理。请妥善保存媒体ID，作为媒资管理、音视频播放、媒体处理等的输入。
获取音视频上传地址和凭证返回的
VideoId即媒体ID。获取图片上传地址和凭证返回的
ImageId即媒体ID。获取辅助媒资上传地址和凭证返回的
MediaId即媒体ID。
上传结果也可以通过提前配置回调接收上传相关事件以监听。
用户应用服务器向客户端下发上传地址和凭证。
客户端使用上传地址和凭证初始化上传实例。
客户端构造上传参数发起上传请求。
OSS服务返回上传结果。
STS Token方式
方式简介：用户应用服务器向客户端下发STS Token，客户端向点播服务获取上传地址和凭证，再上传媒资到OSS。
在用户应用服务器上部署授权服务（如集成阿里云STS SDK）用于获取STS Token。
说明应用服务器需要提供的接口
提供获取STS Token的接口：服务端调用AssumeRole - 获取扮演角色的临时身份凭证换取STS Token，完整流程请参见获取STS Token。
客户端向用户应用服务器发起请求获取STS Token。
用户应用服务器向阿里云STS服务发起请求获取STS Token。
阿里云STS服务返回上传地址和凭证。
用户应用服务器向客户端下发STS Token。
客户端使用STS Token向点播服务获取上传地址和凭证。
点播服务向客户端返回上传地址和凭证。
客户端构造请求发起上传请求。
OSS服务返回上传结果。
客户端集成
不同客户端上传SDK的集成与使用方法不同。请根据需要单击以下链接跳转至具体的操作指引。