一、1. 开通服务
开通云点播服务,详细请参见 购买指引。
二、2. 获取云 API 密钥
获取调用服务端 API 所需的安全凭证,即 SecretId 和 SecretKey,具体步骤如下:
1. 登录控制台,选择云产品 > 访问管理 > API 密钥管理,进入“API 密钥管理”页面。
2. 获取云 API 密钥。如果你尚未创建密钥,则单击新建密钥即可创建一对 SecretId 和 SecretKey。
三、1. 申请上传签名
客户端需要向 App 的签名派发服务器申请上传签名,签名生成步骤请参见 客户端上传签名。多语言签名生成示例请参见:
·PHP 签名示例
·Java 签名示例
·Node.js 签名示例
·C# 签名示例
·Python 签名示例
注意:说明:
四、2. 使用 SDK 上传视频
为了方便客户端的视频上传,云点播提供多平台 SDK 方便客户接入,详细请参见:
·Android 上传 SDK
·iOS 上传 SDK
·Web 上传 SDK
五、常见问题
如何在视频上传完成后自动发起转码?
通过客户端上传签名中 procedure参数指定视频上传完成后的处理方式,详细请参见 上传时指定任务流。
App 后台收到视频上传完成的通知后,如何识别是哪个客户上传的?
在客户端上传签名中增加sourceContext参数,通过该参数来携带用户身份信息,上传完成通知会将该参数传递给 App 后台,详细请参见 事件通知。
六、3. 事件通知
视频上传完成之后,云点播会给 App 后台发起 事件通知 – 视频上传完成,App 后台可通过该事件感知到视频上传行为。如果要接收事件通知,则 App 需要到 控制台 – 回调设置 开启事件通知。事件通知 – 视频上传完成 主要包含如下信息:
·新视频文件的 FileId 和 URL。
·云点播支持在视频上传时指定透传字段,事件完成将透传字段通知到 App 后台。在事件通知中有如下字段:
·SourceType:该字段被腾讯云固定成ServerUpload,表示上传来源为服务端上传。
·SourceContext:用户自定义透传字段,App 后台在派发签名时指定的透传内容,对应签名中的sourceContext参数。
·云点播支持在视频上传完成时自动发起视频处理,如果上传时指定了 视频处理任务流,则在事件通知内容中也会携带任务 ID,即事件通知中的data.procedureTaskId字段。
更多信息请参见:
·任务管理与事件通知
·事件通知 – 视频上传完成
七、上传时指定任务流
如果开发者需要在视频上传完成后自动发起 视频处理任务流(例如转码、截图等),可以在生成 上传签名 时通过procedure参数来实现,参数值为任务流模板名,云点播支持 创建任务流模板 并为模板命名,发起任务流时,可以用任务流模板名来表示要发起的任务。
八、上传时指定存储地域
云点播默认提供的存储地域设置在重庆,如果需要存储到其他区域,可以在控制台上自助添加其他存储地域,详细请参见 上传存储设置。设置完成后,在生成 上传签名 时通过storageRegion参数来指定,参数值为存储地域的 英文简称。
九、上传时附带封面
云点播允许在视频上传过程中,携带封面上传,即在上传 SDK 接口中填写相关的封面路径,详细请参见:
·Android 上传 SDK
·iOS 上传 SDK
·Web 上传 SDK
十、单次有效签名
在视频上传过程中,App 后台派发的签名默认在有效期内是可以多次使用的。如果 App 对视频上传安全性要求很高,可以指定签名单次有效。
单次有效签名的使用方式:在 App 后台派发签名时,指定参数oneTimeValid为1即可,详细请参见 客户端上传签名。
注意:说明:
注意:单次有效签名有且只能被使用一次,该签名方式虽然更加安全,但是需要 App 做额外的异常处理,例如,上传出错时,不能简单地重复使用 SDK 上传视频,还需要重新申请上传签名。
十一、断点续传
在视频上传过程中,如果上传意外终止,用户再次上传该文件,则可以从中断处继续上传。
注意:说明:
注意:断点续传的有效时间为1天,即同一个视频上传被中断,那么1天内再次上传可以直接从断点处上传,超过1天则默认会重新上传完整视频。
App 开启断点续传功能的方式如下:
·Android 上传 SDK,上传时设置enableResume字段为 True 即可。
·iOS 上传 SDK,上传时设置enableResume字段为 True 即可。
·Web 上传 SDK,内置断点续传,无需用户操作。
十二、暂停/恢复/取消上传
在视频上传过程中,云点播 SDK 允许暂停、恢复或取消上传,详细请参见:
·Android 上传 SDK
·iOS 上传 SDK
·Web 上传 SDK