tencent cloud

云点播

动态与公告
产品动态
公告
产品简介
产品概述
产品特性
产品功能
产品优势
应用场景
解决方案
专业版
云点播专业版简介
快速入门
控制台指南
开发指南
购买指南
计费概述
计费方式
购买指引
账单查询
续费说明
欠费说明
退费说明
快速入门
控制台指南
控制台介绍
服务概览
应用管理
媒体管理
资源包管理
License 管理
实时日志分析
实践教程
媒体上传
如何将点播的媒体文件进行智能降冷
媒体处理
分发播放
如何接收事件通知
如何进行源站迁移
直播录制
如何进行自定义源站回源
直播精彩剪辑固化至云点播 VOD 指引
如何使用 EdgeOne 分发云点播内容
开发指南
媒体上传
媒体加工处理
媒体 AI
事件通知
媒体分发播放
媒体加密与版权保护
播放频道
访问管理
下载媒体文件
应用体系
错误码
播放器 SDK 文档
概述
基本概念
产品功能
Demo 体验
免费测试
购买指南
SDK 下载
License 指引
播放器教程
含 UI 集成方案
无 UI 集成方案
高级功能
API 文档
第三方播放器插件
Player SDK Policy
服务端 API 文档
History
Introduction
API Category
Other APIs
Media Processing APIs
Parameter Template APIs
Task Management APIs
Media Upload APIs
Media Management APIs
Event Notification Relevant API
Media Categorization APIs
Domain Name Management APIs
Distribution APIs
AI-based Sample Management APIs
Region Management APIs
Data Statistics APIs
Carousel-Related APIs
Just In Time Transcode APIs
No longer recommended APIs
Making API Requests
AI-based image processing APIs
Task Flow APIs
Data Types
Error Codes
Video on Demand API 2024-07-18
常见问题
移动端播放问题
费用相关问题
视频上传问题
视频发布问题
视频播放问题
Web 端播放问题
全屏播放问题
数据统计问题
访问管理相关问题
媒资降冷问题
相关协议
Service Level Agreement
VOD 政策
隐私政策
数据处理和安全协议
联系我们
词汇表

应用体系

PDF
聚焦模式
字号
最后更新时间: 2023-09-07 17:45:55

概述

为了使开发者能够在云点播中实现资源隔离,云点播提供了应用特性。应用是云点播的一个内部概念,是一种资源划分的方式,一个应用的外在表现类似于一个独立的云点播账号。在创建应用后,点播资源的归属形式如下图所示:



说明:
本文所说的资源包括云点播中的媒体文件及其属性、由媒体文件衍生的其它文件、各类配置、CDN 域名、使用点播服务产生的统计信息等。

应用场景

云点播应用的典型应用场景如下:
多部门/多业务隔离:某企业基于腾讯云开发自有产品,其中 A 部门需要使用云点播来开发一款短视频 App,B 部门则使用云点播来开发一个影视网站。这两个点播业务需要相互隔离,但出于财务管理的考虑,该企业无法为 A 和 B 部门分别开通一个独立的腾讯云账号。这时就可以使用云点播的应用特性,为 A 和 B 部门各分配一个应用。
权限控制:在上面的多部门/多业务隔离场景中,开发者可能会有更进一步的权限控制要求,例如要求每个部门仅能访问和自己业务关联的应用,而无权限访问其它应用。这时,账号管理者可以分别为 A 和 B 部门各分配一个子用户,并授予相应的云点播应用访问权限。操作详情请参见 访问管理
区分正式环境和测试环境:开发者想对某些点播特性进行测试,又担心会影响线上运营(例如修改 事件通知 方式,或者开启 防盗链 等)。开发者可以为正式环境和测试环境各开通一个应用,新特性先在测试环境进行验证,确认无误后再变更线上环境。

身份定义和标识

应用体系中有两类身份:管理员和应用,我们结合下图来说明它们的定义。



1. 开发者开通云点播服务后,直接生成1个默认应用,此时所有的点播资源都归属于默认应用。默认应用的标识符为开发者的腾讯云 APPID,可在控制台的 账号信息中查看。
2. 开发者开通云点播应用功能后,会另外生成一个管理员身份。管理员并不拥有任何点播资源,所有资源仍然属于默认应用。
3. 开发者使用管理员身份创建一个应用,新建的应用拥有独立的点播资源,它和默认应用的地位平等且相互隔离,可以将默认应用理解为一个特殊的应用。创建应用时,云点播会为应用分配一个全平台唯一的标识符,称为应用 ID,查看方式请参见 控制台使用说明 - 应用管理
4. 开发者使用管理员身份再次创建一个应用,这个新建的应用也拥有独立的点播资源,它与默认应用、其它应用的地位平等且相互隔离,依此类推。
说明:
如无特殊说明,下文不再区分默认应用和应用,统一用应用来表述。

能力

云点播应用体系提供以下能力:
创建及设置应用:开发者开通云点播应用功能后,能够以管理员身份在控制台上创建应用,并为每个应用设置名称和描述。
停用应用:除默认应用外,其它应用可以停用。停用操作不会清理应用下的点播资源,只会禁用其域名,其余功能(上传、转码等)不受影响。
资源隔离:应用之间的点播资源相互隔离。
通过控制台或者服务端 API 操作任一个应用的点播资源。
为每一个应用生成单独的数据统计信息,包括存储、带宽/流量、转码时长、视频智能识别时长、播放数据等。
为所有应用生成汇总的数据统计信息。

限制

云点播应用体系具有以下限制:
不支持修改默认应用的名称和描述。
不支持删除应用。
每个云点播账号最多可以创建50个应用。
不支持为应用设置单独的计费逻辑(如设置计费方式、单独生成账单、购买专用资源包等)。一个云点播账号下的所有应用都归属于同一个云点播账号,所有应用的点播用量(包括但不限于存储、流量、转码时长、视频智能识别时长等云点播计费项)都会进行合并计算,统一收费。

控制台使用说明

开通应用

1. 登录 云点播控制台
2. 单击左侧导航栏的开通应用,进入开通页面。
3. 单击该页面的立即使用,即可开通云点播应用功能。
说明:
如果已开通应用功能,则左侧导航栏的开通应用将不可见。

选择身份

开通应用功能后,进入 云点播控制台 应用管理列表,开发者可以在这里选择身份。如果开发者刚开通应用功能,则列表内只有一个选项:“默认应用”;如果开发者新创建应用后,列表会新增对应的身份选项。




管理员

在管理员身份下,左侧导航栏包括服务概览应用管理用量统计、资源包管理 Licnese 管理
服务概览:该页面展示开发者的云点播计费方式、所有应用汇总后的关键业务数据以及各应用的关键业务数据。
应用管理:该页面可以查看、创建、编辑和停用应用。各个应用的标识符(应用 ID)也在此页面展示。
用量统计:该页面可以查看账号下使用各个产品功能所消耗的用量。
资源包管理:该页面可以查看各类型资源包的使用情况。
License 管理:该页面可以查看已绑定视立方视频 License 。

应用

在应用身份下,云点播控制台的使用方法和未开通应用功能时几乎完全一致,用户可以查看和操作归属于该应用的点播资源。两者的主要区别在于应用没有自己的计费配置。

服务端 API 使用说明

在开通云点播应用功能后,开发者在使用 云点播服务端 API 时需要指定访问的是哪个应用的资源。

在服务端 API 中指定应用

云点播服务端 API 已经升级为 云 API 3.0 版本,用户可以在各个 API 的SubAppId参数中指定所要访问的应用。如果要访问的是默认应用,既可以填写默认应用的标识符,也可以不填。

在服务端 API 2017 中指定应用

服务端 API 2017 也支持应用,使用时需要在请求中增加一个SubAppId参数(注意大小写),该参数与服务端 API 2017 的 公共请求参数 平级,其值为应用 ID。如果要访问的是默认应用,既可以填写默认应用的标识符,也可以不填。
说明:
服务端 API 2017 的文档并未暴露SubAppId参数,但不影响使用该参数。
SubAppId参数也要参与服务端 API 的签名计算,计算规则不变。

文件上传说明

在开通云点播应用功能后,开发者在上传媒体文件到云点播时需要指定上传到哪个应用下。

直播录制

直播录制 支持录制到指定的应用,指定方法为在直播推流参数中增加vod_sub_app_id=xxxxxx指应用 ID)。如果要录制到主应用,不带该参数即可。

服务端上传

服务端上传 支持上传到指定的应用,具体的参数填写方法见下方链接。如果要上传到默认应用,既可以填写默认应用的标识符,也可以不填。

SDK 方式

Java SDK
PHP SDK

服务端 API 方式

使用 API 方式进行上传时涉及到 ApplyUploadCommitUpload 两个接口,具体用法请参见 在服务端 API 中指定应用。 我们强烈建议使用 SDK 来进行上传。

客户端上传

客户端上传 支持上传到指定的应用,指定方法为在 客户端上传签名 中增加一个参数:vodSubAppId=xxxxxx指应用 ID)。如果要上传到默认应用,既可以填写默认应用的标识符,也可以不填。
说明:
vodSubAppId参数也要参与客户端上传签名计算,计算规则不变。

URL 拉取上传

URL 拉取视频上传支持上传到指定的应用。
控制台方式:具体用法请参见 控制台使用说明
服务端 API 方式:使用 PullUpload 接口,具体用法请参见 在服务端 API 中指定应用

权限管理

云点播已接入访问管理 CAM,支持应用维度的授权,详情请参见 访问管理

FAQ

开通应用功能后,是否影响线上原有的业务逻辑?

不影响。应用体系在设计时考虑了兼容性,所有的服务端 API 接口在不指定应用 ID 时,默认为操作默认应用。

开通应用功能是否收费?

每个用户可以免费创建20个应用(包含默认应用),超过20个部分应用个数需另外收费,同时每个应用所产生的消耗都将计入该云点播账号,并按云点播 计费逻辑 进行计费。

我们使用应用功能来实现业务隔离,那么各业务该如何进行内部结算/成本分摊?

如上文 限制 的说明,云点播只为整个账号出一份汇总的账单。如果开发者内部多个业务需要进行成本分摊,那么可以基于云点播提供的应用维度的统计数据,自行定义并计算内部成本分摊。

开发者被停服会对应用有什么影响?

开发者的云点播服务发生 欠费停服 时,该账号下所有的应用都会被停服。

我可以把归属于某个应用的视频迁移到另一个应用吗?

应用之间的资源是隔离的,无法迁移。

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈