全部产品
Search
文档中心

视频点播:GetTranscodeTemplateGroup - 查询转码配置详情

更新时间:Jul 19, 2024

根据转码模板组ID查询转码配置的详细信息。

接口说明

获取单个模板组信息,同时会返回该模板组下所有转码模板的配置信息。

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
vod:GetTranscodeTemplateGroup
  • 全部资源
    *

请求参数

名称类型必填描述示例值
TranscodeTemplateGroupIdstring

转码模板组 ID。

a591f697c7167*****6ae1502142d0

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

6730AC93-7B12-4B*****7F-49EE1FE8BC49
TranscodeTemplateGroupobject

转码模板组数据。

CreationTimestring

模板组的创建时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。

2018-12-12T10:20:51Z
IsDefaultstring

是否是默认模板组。取值:

  • Default:默认模板组。
  • NotDefault:非默认模板组。
NotDefault
AppIdstring

应用 ID。

app-****
TranscodeTemplateGroupIdstring

转码模板组 ID。

a59b11f697c716*****6ae1502142d0
Namestring

模板组的名称。

test
ModifyTimestring

模板组的修改时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。

2018-12-12T11:20:51Z
Lockedstring

模板组是否处于锁定状态。取值:

  • Disabled:未锁定
  • Enabled:锁定
Enabled
TranscodeTemplateListarray<object>

转码模板配置信息列表。

object
Typestring

模板类型,取值:

  • Normal(默认):正常转码模板。该类型模板不能设置 PackageSetting 参数。
  • VideoPackage:视频流打包模板。该类型模板会先转码,后构建自适应码流,且必须要配置 PackageSetting 参数。
  • SubtitlePackage:字幕打包模板。该类型模板不会转码,仅将对应字幕信息构建到自适应码率输出文件中,且必须要设置 PackageSetting 参数。但该类型模板不能在模板组中单独存在,需要与 VideoPackage 类型模板一同配置(一个模板组仅能配置一个该类型模板)。
Normal
Videostring

视频流转码配置参数(JSON 字符串)。

{"Codec":"H.264","Bitrate":"900","Width":"960","Remove":"false","Fps":"30"}
TransConfigstring

条件转码参数。如需要根据源片码率、分辨率进行基本逻辑判断再输出转码视频,则可设置该参数 (JSON 字符串)。

{"IsCheckReso":"true","IsCheckResoFail":"false","IsCheckVideoBitrate":"false","IsCheckVideoBitrateFail":"false","IsCheckAudioBitrate":"false","IsCheckAudioBitrateFail":"false"}
Rotatestring

视频旋转标参数。控制画面的旋转角度,例如:设置 180,则视频画面将上下颠倒。取值范围:[0,360]

90
TranscodeTemplateIdstring

转码模板 ID。

696d29a11erc057*****a3acc398d02f4
TemplateNamestring

转码模板名称。

test
EncryptSettingstring

转码加密配置信息。

"EncryptType":"Private"
Audiostring

音频流转码配置参数(JSON 字符串)。

{"Codec":"AAC","Remove":"false","Bitrate":"44","Samplerate":"32000","Channels":"2","Profile":"aac_low"}
TranscodeFileRegularstring

自定义转码输出路径。

{MediaId}/transcoce_1
Containerstring

封装音视频码流的容器格式(JSON 字符串)。

"Format":"m3u8"
Clipstring

视频裁剪配置(JSON 字符串)。例如:需要截取视频中的 5s 内容,用于生成一个新的视频,则可设置该参数。

{"TimeSpan":{"Seek":"1","Duration":"5"}
Definitionstring

普通转码模板清晰度标记:

  • LD(流畅)
  • SD(标清)
  • HD(高清)
  • FHD(超清)
  • OD(原画,即转封装)
  • 2K
  • 4K
  • SQ(普通音质)
  • HQ(高音质)

窄带高清 1.0 内置转码模板清晰度标记:

  • LD-NBV1(流畅)
  • SD-NBV1(标清)
  • HD-NBV1(高清)
  • FHD-NBV1(超清)
  • 2K-NBV1
  • 4K-NBV1
说明
  • 所有转码模板不支持清晰度标记修改。
  • 窄带高清 1.0 转码模板音视频分辨率、码率等参数为系统内置,不支持修改。
  • 窄带高清 1.0 转码模板创建只支持 FLV、M3U8(HLS)、MP4 格式。
  • SD
    PackageSettingstring

    打包配置。仅支持 HLS 自适应码流打包、DASH 打包(JSON 字符串)。

    "PackageType":"HLSPackage","PackageConfig":{ "BandWidth":"900000" }
    SubtitleListstring

    字幕配置 (JSON 字符串)。

    [{"SubtitleUrl":"http://outin-test.oss-cn-shanghai.aliyuncs.com/subtitles/c737fece-14f1-4364-b107-d5f7f8edde0e.ass","CharEncode":"utf-8"}]
    MuxConfigstring

    转码的分片设置参数。HLS 必传(JSON 字符串)。

    "Segment": { "Duration":"6" }
    WatermarkIdsarray

    关联的图文水印模板 ID。

    string

    关联的图文水印模板 ID。

    "USER_DEFAULT_WATERMARK","ddddddddd"
    TraceMarkstring

    溯源水印信息。

    { "Enable": true }
    CopyrightMarkstring

    版权水印信息。

    { "Content": "测试版权水印文案" }

    示例

    正常返回示例

    JSON格式

    {
      "RequestId": "6730AC93-7B12-4B*****7F-49EE1FE8BC49",
      "TranscodeTemplateGroup": {
        "CreationTime": "2018-12-12T10:20:51Z",
        "IsDefault": "NotDefault",
        "AppId": "app-****",
        "TranscodeTemplateGroupId": "a59b11f697c716*****6ae1502142d0",
        "Name": "test",
        "ModifyTime": "2018-12-12T11:20:51Z",
        "Locked": "Enabled",
        "TranscodeTemplateList": [
          {
            "Type": "Normal",
            "Video": "{\"Codec\":\"H.264\",\"Bitrate\":\"900\",\"Width\":\"960\",\"Remove\":\"false\",\"Fps\":\"30\"}",
            "TransConfig": "{\"IsCheckReso\":\"true\",\"IsCheckResoFail\":\"false\",\"IsCheckVideoBitrate\":\"false\",\"IsCheckVideoBitrateFail\":\"false\",\"IsCheckAudioBitrate\":\"false\",\"IsCheckAudioBitrateFail\":\"false\"}",
            "Rotate": "90",
            "TranscodeTemplateId": "696d29a11erc057*****a3acc398d02f4",
            "TemplateName": "test",
            "EncryptSetting": "\"EncryptType\":\"Private\"",
            "Audio": "{\"Codec\":\"AAC\",\"Remove\":\"false\",\"Bitrate\":\"44\",\"Samplerate\":\"32000\",\"Channels\":\"2\",\"Profile\":\"aac_low\"}",
            "TranscodeFileRegular": "{MediaId}/transcoce_1",
            "Container": "\"Format\":\"m3u8\"",
            "Clip": "{\"TimeSpan\":{\"Seek\":\"1\",\"Duration\":\"5\"}",
            "Definition": "SD",
            "PackageSetting": "\"PackageType\":\"HLSPackage\",\"PackageConfig\":{   \"BandWidth\":\"900000\"  }",
            "SubtitleList": "[{\"SubtitleUrl\":\"http://outin-test.oss-cn-shanghai.aliyuncs.com/subtitles/c737fece-14f1-4364-b107-d5f7f8edde0e.ass\",\"CharEncode\":\"utf-8\"}]",
            "MuxConfig": "\"Segment\": { \"Duration\":\"6\" }",
            "WatermarkIds": [
              "\"USER_DEFAULT_WATERMARK\",\"ddddddddd\""
            ],
            "TraceMark": "{\n\t\"Enable\": true\n}",
            "CopyrightMark": "{\n\t\"Content\": \"测试版权水印文案\"\n}"
          }
        ]
      }
    }

    错误码

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

    变更历史

    变更时间变更内容概要操作
    2023-09-14OpenAPI 返回结构发生变更查看变更详情

    接口错误码

    下表列举了本接口特有的错误码。

    错误代码错误信息HTTP 状态码说明
    InvalidTranscodeTemplateGroup.NotFoundThe transcode template group does not exist.404指定的转码模板组不存在。