服务端 API 文档

文档中心 > 云点播 > 最佳实践 > 媒体上传 > 如何在服务端上传视频

如何在服务端上传视频

最近更新时间:2020-06-30 16:03:30

使用须知

内容介绍

本文档向开发者介绍如何将服务器本地的视频文件上传到云点播(VOD)。

费用

本文提供的代码是免费开源的,但在使用的过程中可能会产生以下费用:

将 CVM 上的视频上传到 VOD

步骤1:准备腾讯云 CVM

上传脚本需要运行在一台腾讯云 CVM 上,要求如下:

  • 地域:任意。
  • 机型:官网最低配置(1核1GB)即可。
  • 公网:需要拥有公网 IP,带宽1Mbps或以上。
  • 操作系统:官网公共镜像Ubuntu Server 16.04.1 LTS 64位Ubuntu Server 18.04.1 LTS 64位

购买 CVM 的方法请参见 操作指南 - 创建实例。重装系统的方法请参见 操作指南 - 重装系统

注意:

如果您没有符合上述条件的腾讯云 CVM,也可以在其它带外网的 Linux(如 CentOS、Debian 等)或 Mac 机器上执行脚本,但需根据操作系统的区别修改脚本中的个别命令,具体修改方式请开发者自行搜索。

步骤2:开通云点播

请参考 快速入门 - 步骤1 开通云点播服务。

步骤3:获取 API 密钥

上传视频需要使用到开发者的 API 密钥(即 SecretId 和 SecretKey)。如果还未创建过密钥,请参见 创建密钥文档 生成新的 API 密钥;如果已创建过密钥,请参见 查看密钥文档 获取 API 密钥。

步骤4:下载代码并安装 SDK

登录 步骤1 中准备好的 CVM(登录方法详见 操作指南 - 登录 Linux),在远程终端输入以下命令并运行:

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
说明:

请将命令中的 SECRET_ID 和 SECRET_KEY 赋值为 步骤3 中获取到的内容。

该命令将从 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 是否将视频上传到 云点播子应用
    说明:

    本 Demo 仅支持proceduresubappid两个上传参数,完整功能请参考 Python 上传 SDK 接口描述

  3. 从命令行参数中获取待上传视频文件的本地路径,以及封面图片路径(如果有封面),然后调用upload_media()发起上传:

        if len(sys.argv) < 2:
            usage()
            return
        video_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 = video
            if cover != "":
                req.CoverFilePath = cover
            if 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 开发指南:

目录