使用须知
内容介绍
本文档向开发者介绍如何将服务器本地的视频文件上传到云点播（VOD）。
费用
本文提供的代码是免费开源的，但在使用的过程中可能会产生以下费用：
购买腾讯云云服务器（CVM）用于执行上传脚本，详见 CVM 计费。
将 CVM 上的视频上传到 VOD
步骤1：准备腾讯云 CVM
上传脚本需要运行在一台腾讯云 CVM 上，要求如下：
地域：任意。
机型：官网最低配置（1核1GB）即可。
公网：需要拥有公网 IP，带宽1Mbps或以上。
操作系统：官网公共镜像
Ubuntu Server 16.04.1 LTS 64位或Ubuntu Server 18.04.1 LTS 64位。注意：
如果您没有符合上述条件的腾讯云 CVM，也可以在其它带外网的 Linux（如 CentOS、Debian 等）或 Mac 机器上执行脚本，但需根据操作系统的区别修改脚本中的个别命令，具体修改方式请开发者自行搜索。
步骤2：开通云点播
步骤3：获取 API 密钥
步骤4：下载代码并安装 SDK
ubuntu@VM-69-2-ubuntu:~$ export SECRET_ID=AKxxxxxxxxxxxxxxxxxxxxxxx; export SECRET_KEY=xxxxxxxxxxxxxxxxxxxxx;git clone https://github.com/tencentyun/vod-server-demo.git ~/vod-server-demo; bash ~/vod-server-demo/installer/server_upload.sh
说明：
该命令将从 Github 下载 Demo 源码并自动执行安装脚本。安装过程需几分钟（具体取决于 CVM 网络状况），期间远程终端会打印类似如下的信息：
[2020-06-23 19:56:31]开始安装 pip3。[2020-06-23 19:56:34]pip3 安装成功。[2020-06-23 19:56:34]开始安装 VOD Python 上传 SDK。[2020-06-23 19:56:36]VOD Python 上传 SDK 安装完成。[2020-06-23 19:56:36]开始配置 SDK 参数。[2020-06-23 19:56:36]SDK 参数配置完成。
步骤5：上传视频
发起上传之前，开发者需要在 CVM 上准备好视频文件和封面图片（可选）。如果开发者不方便上传视频到 CVM，可以在远程终端执行以下命令，将测试视频和测试封面下载到 CVM 上：
ubuntu@VM-69-2-ubuntu:~$ wget http://1400329073.vod2.myqcloud.com/d62d88a7vodtranscq1400329073/7a9b2b565285890804459281865/v.f100010.mp4 -O ~/vod-server-demo/server_upload/tencent_cloud.mp4; wget http://1400329073.vod2.myqcloud.com/ff439affvodcq1400329073/8aa658d15285890804459940822/5285890804459940825.jpg -O ~/vod-server-demo/server_upload/tencent_cloud.jpg
执行
server_upload.py脚本发起上传：ubuntu@VM-69-2-ubuntu:~$ cd ~/vod-server-demo/server_upload/; python3 server_upload.py ./tencent_cloud.mp4 ./tencent_cloud.jpg
说明：
请将命令中的视频路径和封面图片路径替换为实际文件的路径，其中封面图片路径参数是可选的，如果不填则上传后的视频没有封面。
该命令将 tencent_cloud.mp4 视频上传到 VOD，同时上传 tencent_cloud.jpg 图片作为其封面。上传完成后远程终端会打印出类似如下信息：
{"CoverUrl": "http://1400329073.vod2.myqcloud.com/ff439affvodcq1400329073/8aa658d15285890804459940822/5285890804459940825.jpg", "FileId": "5285890804459940822", "MediaUrl": "http://1400329073.vod2.myqcloud.com/ff439affvodcq1400329073/8aa658d15285890804459940822/f0.mp4", "RequestId": "84a7fb42-9f05-4acd-9cc8-843690b188ce"}
说明：
如果开发者使用自己的视频进行测试，建议使用较小的视频文件（例如几个MB），避免因 CVM 带宽不足而需要耗费很长的上传时间。
步骤6：查看结果
代码解读
1.
main()为脚本入口。2. 调用
parse_conf_file()，从config.json文件中读取配置信息。配置项说明如下：字段 | 数据类型 | 功能 |
secret_id | String | API 密钥 |
secret_key | String | API 密钥 |
procedure | String | 任务流名称，即视频上传完成后自动触发该任务流。默认为空 |
subappid | String |
说明：
3. 从命令行参数中获取待上传视频文件的本地路径，以及封面图片路径（如果有封面），然后调用
upload_media()发起上传：if len(sys.argv) < 2:usage()returnvideo_path = sys.argv[1]cover_path = sys.argv[2] if len(sys.argv) > 2 else ""# 发起上传rsp = upload_media(configuration, video_path, cover_path)
4. 在
upload_media()中，使用 Python SDK 提供的方法构造一个上传实例client，然后在req中设置上传参数，最后发起上传：client = VodUploadClient(conf["secret_id"], conf["secret_key"])req = VodUploadRequest()req.MediaFilePath = videoif cover != "":req.CoverFilePath = coverif conf["procedure"] != "":req.Procedure = conf["procedure"]req.SubAppId = int(conf["subappid"])rsp = client.upload("ap-guangzhou", req)return rsp
注意：
client.upload()中的第一个参数（"ap-guangzhou"）是指上传实例的接入地域，不是指视频上传后的存储地域。该参数固定填为"ap-guangzhou"即可，如果需要指定视频上传后的存储地域，请设置req.StorageRegion参数。其它功能
VOD 服务端上传 SDK 还支持其它特性，如设置视频名称、分类、过期时间等，详情请参考各语言 SDK 开发指南：
