CreateVodPackagingConfiguration - 创建点播打包配置

更新时间:
复制 MD 格式

创建点播打包配置。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ice:CreateVodPackagingConfiguration

create

*全部资源

*

请求语法

POST  HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

GroupName

string

点播打包组名称,长度 128 个字符,格式:[A-Za-z0-9_-]+。

vod_hls

ConfigurationName

string

点播打包配置名称,长度 128 个字符,格式:[A-Za-z0-9_-]+,用户维度唯一。

hls_3s

Protocol

string

点播打包类型,支持:

  • HLS: HLC 协议播放格式;

  • HLS_CMAF: HLS 协议的 CMAF 播放格式;

  • DASH: DASH 协议播放格式。

HLS

Description

string

打包配置描述信息。

HLS 3s vod packaging

PackageConfig

object

打包配置。

ManifestName

string

manifest 名称,[A-Za-z0-9_]+,长度不超过 128。

index

SegmentDuration

integer

每个片段的时长(以秒为单位)。实际片段将会被四舍五入到最接近的源片段时长的倍数。取值范围【1,30】。

6

StreamSelection

object

打包输出流选择配置。

MinVideoBitsPerSecond

integer

最小视频流码率,单位 bps。

100000

MaxVideoBitsPerSecond

integer

最大视频流码率,单位 bps。

1000000000

StreamOrder

string

流排序规则,支持值:

  • ORIGINAL:保持输入序号;

  • VIDEO_BITRATE_ASCENDING:按视频流码率递增;

  • VIDEO_BITRATE_DESCENDING:按视频流码率递减。

ORIGINAL

DrmProvider

object

DRM 加密提供商配置。

EncryptionMethod

string

加密算法,支持值:

  • AES_128:128 位高级加密标准;

  • SAMPLE_AES:媒体内容保护领域的一个特定实现方式,抽样加密。

AES_128

IV

string

一个可选的 128 位(16 字节)十六进制值,由 32 个字符的字符串表示,与密钥一起用于加密数据块。如果您不指定该值,则 MediaPackage 将创建一个常量初始化向量(IV)。默认值:空,如果填写,则透传到供应商 Constant initialization vector。

00001111222233334444555566667777

SystemIds

array

DRM 系统 id,system id 数量由使用的协议类型决定,具体限制:

  • DASH -- 最多两个;

  • HLS -- 提供一个;

  • HLS_CMAF-- 最多提供两个。

目前支持 Apple FairPlay、Google Widevine、Microsoft PlayReady 三个 DRM System,对应 SystemId 分别为 :

  • Apple FairPlay:94ce86fb-07ff-4f43-adb8-93d2fa968ca2;

  • Google Widevine:edef8ba9-79d6-4ace-a3c8-27dcd51d21e;

  • Microsoft PlayReady:9a04f079-9840-4286-ab92-e65be0885f95。

string

DRM 系统 ID。

94ce86fb-07ff-4f43-adb8-93d2fa968ca2

Url

string

DRM key 提供商 url。

https://***drm***/getcontent

返回参数

名称

类型

描述

示例值

object

Schema of Response

RequestId

string

请求 ID。

******11-DB8D-4A9A-875B-275798******

PackagingConfiguration

VodPackagingConfiguration

打包配置。

示例

正常返回示例

JSON格式

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "PackagingConfiguration": {
    "GroupName": "",
    "Description": "",
    "CreateTime": "",
    "ConfigurationName": "",
    "Protocol": "",
    "PackageConfig": {
      "ManifestName": "",
      "StreamSelection": {
        "MinVideoBitsPerSecond": 0,
        "StreamOrder": "",
        "MaxVideoBitsPerSecond": 0
      },
      "DrmProvider": {
        "SystemIds": [
          ""
        ],
        "EncryptionMethod": "",
        "IV": "",
        "Url": ""
      },
      "SegmentDuration": 0
    }
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情