腾讯云云点播（VOD）从入门到精通：完整对接实战指南

apphuang2026年07月02日 16:27:154

1. 云点播产品概述

腾讯云云点播（Video on Demand，VOD）是腾讯云提供的一套整合了媒资上传、智能管理、媒体处理、AIGC创作及分发播放的全链路音视频解决方案。它通过单一标准接口接入，结合腾讯混元、Vidu等头部厂商AI大模型能力，为客户提供一体化的智能媒资服务。云点播的核心价值在于实现媒资管理从传统的被动存储向AI时代的主动赋能转型。

云点播覆盖了音视频从生产、传输、处理到分发的全链路需求。截至目前，云点播已稳定管理超过10亿个文件，经受日播放量30亿次以上、短视频日编辑量1000万次以上的实战打磨。产品构建了覆盖全球3200个以上的边缘节点，提供极致的传输与播放体验。

需要先登录腾讯云控制台，点击：腾讯云控制台，还没有账号，点击：注册后再关联，已有账号点击：登录后再关联

2. 核心功能全景

2.1 媒体上传

云点播支持本地上传、URL拉取上传、API上传以及客户端上传等多种媒体上传方式。具体包括：客户端上传（移动端、Web端、微信小程序）、服务端上传（提供多语言SDK）、控制台上传、URL拉取上传、直播录制等多种上传方式。云点播通过调度优化、全球多存储园区覆盖、链路补充、传输优化、协议优化等多种上传加速措施，有效增强上传的稳定性与成功率。同时启用QUIC传输后，可大大减少网络拥塞，降低延时，改善弱网环境下的上传质量。

2.2 媒体存储与管理

云点播支持媒体文件跨多架构、多设备备份存储，提供异地容灾和用户资源隔离。支持对媒体设置多种属性信息，用于媒体检索、播放展示、智能管理等。可根据播放热度、上传时间、上传类型等多维条件设置降冷策略，自动将冷数据转为低频或归档存储以节约成本。同时支持媒体过期删除和部分删除功能。

2.3 媒体处理

云点播提供丰富的媒体处理能力：视频转码（支持加水印）、视频转动图、按指定时间点截图、采样截图、雪碧图截取、封面截图、转自适应码流（支持加密）。云点播还提供极速高清转码，基于智能场景识别、动态编码等技术，以更低的码率获得更高的主观画质。此外还支持视频剪辑、拼接、画中画、多轨制作等高级编辑功能。

2.4 媒体AI与智能审核

基于腾讯云领先的AI技术，云点播提供内容审核、内容分析、内容识别等能力。内容审核可对图片、音频、视频进行涉黄等违法违规内容检测。内容分析包括智能分类、智能标签、智能封面。内容识别支持人脸识别、语音识别（生成智能字幕）、文字识别、片头片尾识别等。

2.5 分发播放与版权保护

云点播内置默认域名，支持自定义域名进行媒体分发。提供完整的CDN用量统计分析服务和日志下载。版权保护方面提供Referer防盗链、Key防盗链、溯源水印和商业级DRM加密等高级别安全保障。

3. 服务开通与前置准备

3.1 开通云点播服务

使用云点播服务前需要完成以下步骤：

注册腾讯云账号并完成实名认证
进入云点播控制台，单击开通服务
创建应用（专业版或企业版），输入应用名称并选择应用类型

3.2 获取API密钥

上传视频需要使用API密钥（SecretId和SecretKey）。在访问管理控制台的云API密钥页面获取appid、secretid、secretkey。如果还未创建密钥，请生成新的API密钥。

3.3 了解子应用概念

从2023年12月25日起开通点播的客户，访问点播应用中的资源时必须填写SubAppId（应用ID）。子应用可实现资源隔离和独立管理。

4. 视频上传完整指南

4.1 控制台上传

控制台上传是最直观的上传方式：登录云点播控制台，进入应用管理，单击应用名称进入媒资管理页面，单击上传音视频，选择本地上传并选择文件即可完成上传。上传完成后系统会返回FileId（文件在云点播上的全局唯一标识符）。

4.2 服务端上传（多语言SDK）

云点播强烈建议使用服务端上传SDK来上传文件，直接调用API进行上传的难度和工作量都显著大于使用SDK。服务端上传支持Java、C#、PHP、Python、Node.js、Go等多语言SDK。

4.2.1 Python SDK上传示例

以下是一个使用Python SDK进行服务端上传的完整示例：

import requests
import json

# 设置API密钥和请求参数
secret_id = "YOUR_SECRET_ID"
secret_key = "YOUR_SECRET_KEY"
sub_app_id = 1500000001  # 你的子应用ID

# 构造请求参数
def apply_upload(media_name, media_type="mp4"):
    url = "https://vod.tencentcloudapi.com/"
    params = {
        "Action": "ApplyUpload",
        "Version": "2018-07-17",
        "SubAppId": sub_app_id,
        "MediaName": media_name,
        "MediaType": media_type
    }
    # 此处省略签名计算逻辑，实际使用SDK时SDK会自动处理签名
    # 建议直接使用官方SDK：pip install tencentcloud-sdk-python-vod
    return params

# 使用官方SDK的推荐方式
from tencentcloud.common import credential
from tencentcloud.vod.v20180717 import vod_client, models

cred = credential.Credential(secret_id, secret_key)
client = vod_client.VodClient(cred, "")

req = models.ApplyUploadRequest()
req.SubAppId = sub_app_id
req.MediaName = "my_video.mp4"
req.MediaType = "mp4"

resp = client.ApplyUpload(req)
print(resp.to_json_string())

4.2.2 服务端上传流程

服务端上传的完整流程如下：

准备一台腾讯云CVM（最低配置1核1GB即可，需有公网IP）
开通云点播服务
获取API密钥（SecretId和SecretKey）
下载代码并安装SDK
执行上传脚本

安装和配置命令示例：

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/upload.sh

4.3 客户端上传

客户端上传适用于UGC、PGC等场景，终端用户将客户端本地视频上传到云点播。云点播提供了iOS、Android、Web、小程序等多端的客户端上传SDK。

4.3.1 Web端上传

Web上传基于云函数（SCF）搭建服务：第一个服务用于接收来自浏览器获取客户端上传签名的请求并返回签名；第二个服务使用VOD Web上传SDK实现上传页面。

Web上传的核心流程：

浏览器向SCF请求上传页面
用户选中视频后点击上传，浏览器向SCF请求上传签名
浏览器使用上传签名向VOD发起上传请求

客户端在发起上传前，需要向App服务器请求上传签名，客户端必须携带该签名让云点播验证上传是否被授权。

4.3.2 iOS上传SDK集成

iOS上传SDK的集成方式：

# 在Podfile中添加依赖
pod 'TXVodUpload', :path => '/TXVodUpload.podspec所在位置的路径'

4.4 URL拉取上传

URL拉取上传使用云点播提供的服务端API拉取上传接口，指定待上传媒体的URL，由云点播后台进行离线拉取。适用于大量或自动化的媒体文件迁移场景。

5. 媒体处理与转码配置

5.1 转码模板设置

云点播支持创建多种类型的处理模板：视频转码模板、场景转码模板、音频转码模板、转封装模板、转自适应码流模板、水印模板、截图模板、转动图模板、内容审核模板和智能识别模板。

创建转码模板的步骤：在云点播控制台进入应用管理，选择媒体处理设置 > 模板设置，选择视频转码模板，单击创建转码模板进入自定义设置。模板名称仅支持中文、英文、数字、空格、下划线、短横线和句点，长度不超过64个字符。

5.2 任务流配置

任务流可以将多个处理步骤编排为自动化流程。上传视频时可通过指定Procedure参数自动触发任务流。创建任务流模板有两种方式：在控制台上创建和修改，或通过任务流模板接口创建。

5.3 截图与水印

云点播支持多种截图操作：封面截图、按时间点截图、雪碧图、采样截图、转动图，可用于缩略图预览、视频打点等场景。水印功能支持按需添加水印，设定不同转码格式灵活匹配不同应用场景。

5.4 发起媒体处理任务

通过ProcessMedia接口可以对点播中的音视频媒体发起处理任务，包括视频转码（带水印）、视频转动图、视频截图、转自适应码流、内容审核、内容分析、内容识别等。接口请求域名为vod.tencentcloudapi.com，默认接口请求频率限制为200次/秒。

使用API Explorer可以方便地进行在线调试、签名验证、SDK代码生成和快速检索接口。

6. 视频播放集成

6.1 播放架构概述

云点播建议使用播放器SDK播放转自适应码流后的输出视频。整体播放架构流程如下：

服务端上传视频到云点播
触发视频处理（转自适应码流）
转码输出写入点播存储
更新媒资管理信息
业务后台派发播放签名
播放器指定FileId获取下载地址
播放器从CDN下载内容
开始播放自适应码流

6.2 Web播放器TCPlayer集成

TCPlayer是腾讯云提供的适用于点播和直播播放的Web播放器SDK，可快速与自有Web应用集成。播放器初始化需要传入两个参数：播放器容器ID和功能参数对象。

TCPlayer初始化示例：

var player = TCPlayer('player-container-id', {
    appID: 'YOUR_APP_ID',      // 腾讯云账号的appID
    fileID: 'YOUR_FILE_ID',    // 点播媒体文件的ID
    psign: 'PLAYER_SIGN',      // 播放器签名
    licenseUrl: 'LICENSE_URL', // 播放器License地址
    poster: 'POSTER_URL',      // 封面图片地址
    autoplay: false,           // 是否自动播放
    controls: true,            // 是否显示控制栏
    playbackRates: [0.5, 1, 1.25, 1.5, 2], // 变速播放选项
    language: 'zh-CN'          // 语言设置
});

options对象的关键参数说明：

appID：通过fileID播放时必选
fileID：通过fileID播放时必选
psign：播放器签名，通过fileID播放时必传
licenseUrl：播放器License地址
sources：播放地址数组，格式[{src: '//path/to/video.mp4', type: 'video/mp4'}]

6.3 小程序播放器插件

云点播提供短视频播放器小程序插件，可快速将短视频发布到原生小程序中。在小程序管理后台的设置 > 第三方服务中选择添加插件，搜索云点播短视频播放器并添加。插件APPID为wx116d0dd5e6a39ac7。

6.4 播放签名机制

播放器签名是播放安全的重要保障。业务后台根据播放器签名计算规则派发播放签名。播放器指定要播放的视频FileId后，会从点播的播放服务获取视频的下载地址。

7. 安全防护与权限管理

7.1 Referer防盗链

Referer防盗链基于HTTP协议支持的Referer机制，通过播放请求Header中携带的Referer字段识别请求来源。开发者可以设置一批域名为黑名单或白名单，CDN节点按照名单中的域名做鉴权，允许或拒绝播放请求。在腾讯云点播控制台，可以根据Referer黑白名单、是否允许Referer为空等配置规则对访问进行权限配置。

7.2 Key防盗链

Key防盗链通过在视频URL中指定过期时间、播放人数控制和试看时长来实现更精细的权限控制。开启Key防盗链后，视频原始URL不再能播放，需要构造防盗链URL。

Key防盗链的配置步骤：

登录腾讯云点播控制台
进入分发播放设置 > 域名管理
选择需要开启Key防盗链的域名，编辑Key防盗链设置
启用Key防盗链功能，生成Key值
配置参数：密钥(KEY)、有效期(t)、试看时长(exper)、允许播放的IP数(rlimit)

Key防盗链的优势：有效时间控制防止视频长期非法使用；播放人数控制防止视频被广泛分发；试看功能适用于付费视频预览；比Referer防盗链更为安全可靠。

7.3 DRM加密与溯源水印

云点播提供集成商业级DRM的一站式解决方案，包括Multi-DRM加密、证书管理、License派发、解密播放等功能。溯源水印提供高安全、低成本的防盗录水印方案，可以有效提取水印中的用户ID，震慑盗录行为，协助维权。

7.4 访问管理（CAM）权限控制

云点播已接入腾讯云访问管理（CAM）。权限控制分为三个粒度：服务级（定义对服务的整体访问权限）、操作级（定义对特定API的访问权限）、资源级（定义对特定资源的访问权限，最细粒度）。如果要求精细的权限控制能力，需要创建自定义策略。建议使用RAM子账号进行最小权限授权，避免主账号密钥泄露。

8. 成本优化策略

8.1 内网免流量

如果业务部署在腾讯云CVM上且与云点播存储位于同一地域，内网访问产生的流量不收取外网流量费用，可显著降低分发成本。

8.2 存储类型降冷

云点播支持根据播放热度、上传时间、上传类型等多维条件设置降冷策略。将低频访问的数据转为低频存储或归档存储，可有效降低存储成本。同时支持媒体过期删除和部分删除功能。老旧视频可以只保留低清版本，删除高清版本以降低存储成本。

8.3 资源包选购

云点播按量计费主要涉及存储量、外网下行流量和请求次数。对于用量较大的业务，建议购买存储资源包和流量资源包以获得更优惠的单价。

8.4 极速高清转码降码率

极速高清转码通过智能场景识别、动态编码技术、码率精准控制模型，以更低的码率获得更高的主观画质。相比普通转码可节约网络流量和存储成本。短剧出海实践中通过智能极速高清转码技术可将视频码率降低50%以上。

9. 常见问题解答

问题1：视频上传失败怎么办？

原因可能包括网络问题、文件大小超出限制或权限设置不正确。解决方法：检查网络连接是否稳定，确认文件大小符合要求，核实上传权限设置。

问题2：视频播放卡顿如何解决？

可能原因：视频编码格式不兼容或CDN节点负载过高。建议使用转自适应码流功能，让播放器根据网络情况自动切换清晰度。

问题3：如何保护视频不被盗链？

云点播提供Referer防盗链和Key防盗链两种方案。建议同时开启两种防盗链，对于高价值内容还可启用DRM加密。

问题4：如何获取视频的播放地址？

上传完成后云点播会返回FileId。在控制台的音视频管理页面，单击目标文件后的复制链接即可获取播放地址。也可通过API获取播放地址。

问题5：云点播支持哪些上传方式？

云点播支持控制台上传、服务端SDK上传（Java/C#/PHP/Python/Node.js/Go等）、客户端上传（iOS/Android/Web/小程序）、URL拉取上传、直播录制转点播等多种方式。