GetTranscodeTemplateGroup - : Central de Documentação do Alibaba Cloud

Nota

Esta operação retorna as informações do grupo de modelos de transcodificação especificado e as configurações de todos os modelos de transcodificação pertencentes a esse grupo.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	GetTranscodeTemplateGroup	A operação que você deseja executar. Defina o valor como GetTranscodeTemplateGroup.
TranscodeTemplateGroupId	String	Sim	a591f697c7167*6ae1502142d0	O ID do grupo de modelos de transcodificação.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	6730AC93-7B12-4B*****7F-49EE1FE8BC49	O ID da solicitação.
TranscodeTemplateGroup	Struct		As informações sobre o grupo de modelos de transcodificação.
AppId	String	app-****	O ID do aplicativo.
CreationTime	String	2018-12-12T10:20:51Z	A hora em que o grupo de modelos foi criado. O horário segue o padrão ISO 8601 no formato aaaa-MM-ddTHH:mm:ssZ. O horário é exibido em UTC.
IsDefault	String	NotDefault	Indica se o grupo de modelos é o padrão. Valores válidos: Default: O grupo de modelos é o padrão. NotDefault: O grupo de modelos não é o padrão.
Locked	String	Enabled	Indica se o grupo de modelos está bloqueado. Valores válidos: Disabled: O grupo de modelos não está bloqueado. Enabled: O grupo de modelos está bloqueado.
ModifyTime	String	2018-12-12T11:20:51Z	A hora em que o grupo de modelos foi modificado. O horário segue o padrão ISO 8601 no formato aaaa-MM-ddTHH:mm:ssZ. O horário é exibido em UTC.
Name	String	test	O nome do grupo de modelos.
TranscodeTemplateGroupId	String	a59b11f697c716*****6ae1502142d0	O ID do grupo de modelos de transcodificação.
TranscodeTemplateList	Array of TranscodeTemplate		As configurações dos modelos de transcodificação.
Audio	String	{\"Codec\":\"AAC\",\"Remove\":\"false\",\"Bitrate\":\"44\",\"Samplerate\":\"32000\",\"Channels\":\"2\",\"Profile\":\"aac_low\"}	As configurações de transcodificação do fluxo de áudio. O valor é uma string formatada em JSON.
Clip	String	{\"TimeSpan\":{\"Seek\":\"1\",\"Duration\":\"5\"}	As configurações de recorte do vídeo. O valor é uma string formatada em JSON. Por exemplo, defina este parâmetro caso queira extrair 5 segundos de conteúdo de um vídeo para gerar um novo vídeo.
Container	String	"Format":"m3u8"	O formato do contêiner usado para encapsular fluxos de áudio e vídeo. O valor é uma string formatada em JSON.
Definition	String	SD	Valores válidos para a definição de um modelo de transcodificação comum: LD: baixa definição. SD: definição padrão. HD: alta definição. FHD: ultra-alta definição. OD: qualidade original. 2K 4K SQ: qualidade de som padrão. HQ: alta qualidade de som. Valores válidos para a definição de um modelo de transcodificação Narrowband HD™ 1.0: LD-NBV1: baixa definição. SD-NBV1: definição padrão. HD-NBV1: alta definição. FHD-NBV1: ultra-alta definição. 2K-NBV1 4K-NBV1 Nota Não é possível modificar a definição dos modelos de transcodificação. Não é possível modificar os parâmetros do sistema, como resolução de vídeo, resolução de áudio e taxa de bits, dos modelos de transcodificação Narrowband HD™ 1.0. É possível criar apenas modelos de transcodificação Narrowband HD™ 1.0 que suportem os formatos de saída FLV, M3U8 (HLS) e MP4.
EncryptSetting	String	"EncryptType":"Private"	A configuração de criptografia usada para transcodificação.
MuxConfig	String	"Segment": { "Duration":"6" }	As configurações de segmento de transcodificação. Este parâmetro deve ser retornado se a criptografia HTTP-Live-Streaming (HLS) for utilizada. O valor é uma string formatada em JSON.
PackageSetting	String	"PackageType":"HLSPackage","PackageConfig":{ "BandWidth":"900000" }	As configurações de empacotamento. Apenas empacotamento HLS e empacotamento DASH são suportados. O valor é uma string formatada em JSON.
Rotate	String	90	O identificador de rotação de vídeo. Controla o ângulo de rotação da imagem. Por exemplo, ao definir este parâmetro como 180, a imagem do vídeo fica de cabeça para baixo. Valores válidos: `0 a 360`.
SubtitleList	String	[{"SubtitleUrl":"http://outin-test.oss-cn-shanghai.aliyuncs.com/subtitles/c737fece-14f1-4364-b107-d5f7f8edde0e.ass","CharEncode":"utf-8"}]	As configurações de legenda. O valor é uma string formatada em JSON.
TemplateName	String	test	O nome do modelo de transcodificação.
TransConfig	String	{"IsCheckReso":"true","IsCheckResoFail":"false","IsCheckVideoBitrate":"false","IsCheckVideoBitrateFail":"false","IsCheckAudioBitrate":"false","IsCheckAudioBitrateFail":"false"}	As configurações de transcodificação condicional. Utilize este parâmetro para determinar a lógica básica com base na taxa de bits e na resolução do arquivo mezzanine antes da transcodificação do vídeo. O valor é uma string formatada em JSON.
TranscodeFileRegular	String	{MediaId}/transcoce_1	O caminho de saída personalizado dos arquivos transcodificados.
TranscodeTemplateId	String	696d29a11erc057*****a3acc398d02f4	O ID do modelo de transcodificação.
Type	String	Normal	O tipo do modelo. Valores válidos: Normal: um modelo de transcodificação comum. Este é o valor padrão. O parâmetro PackageSetting não pode ser definido para este tipo de modelo. VideoPackage: um modelo de pacote de fluxo de vídeo. Ao usar este tipo de modelo, o ApsaraVideo VOD transcodifica um vídeo em fluxos de vídeo com diferentes taxas de bits e empacota esses fluxos em um arquivo. O parâmetro PackageSetting deve ser definido para este tipo de modelo. SubtitlePackage: um modelo de pacote de legendas. Com este tipo de modelo, o ApsaraVideo VOD adiciona as informações de legenda ao arquivo de saída gerado pelo empacotamento dos fluxos de vídeo de múltiplas taxas de bits do vídeo correspondente. É necessário definir o parâmetro PackageSetting para um modelo de pacote de legendas e associá-lo a um modelo de pacote de fluxo de vídeo. Um grupo de modelos pode conter apenas um modelo de pacote de legendas.
Video	String	{"Codec":"H.264","Bitrate":"900","Width":"960","Remove":"false","Fps":"30"}	As configurações de transcodificação do fluxo de vídeo. O valor é uma string formatada em JSON.
WatermarkIds	List	"USER_DEFAULT_WATERMARK","ddddddddd"	O ID da marca d'água associada.

Exemplos

Exemplos de solicitações

https://vod.{ApiRegion}.aliyuncs.com/?Action=GetTranscodeTemplateGroup
&TranscodeTemplateGroupId=a591f697c7167*****6ae1502142d0
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<GetTranscodeTemplateGroupResponse>
  <RequestId>6730AC93-7B12-4B*****7F-49EE1FE8BC49</RequestId>
  <TranscodeTemplateGroup>
        <IsDefault>NotDefault</IsDefault>
        <Locked>Enabled</Locked>
        <ModifyTime>2018-12-12T11:20:51Z</ModifyTime>
        <AppId>app-****</AppId>
        <TranscodeTemplateGroupId>a59b11f697c716*****6ae1502142d0</TranscodeTemplateGroupId>
        <TranscodeMode>FastTranscode</TranscodeMode>
        <TranscodeTemplateList>
              <TailSlateList>[{"TailUrl":"http://outin-test.oss-cn-shanghai.aliyuncs.com/tailslates/b6e9ceed-b665-426f-9d9a-277f0f****.mov"}]</TailSlateList>
              <PackageSetting>"PackageType":"HLSPackage","PackageConfig":{   "BandWidth":"900000"  }</PackageSetting>
              <Rotate>90</Rotate>
              <UserData>{}</UserData>
              <Definition>SD</Definition>
              <TranscodeFileRegular>{MediaId}/transcoce_1</TranscodeFileRegular>
              <EncryptSetting>"EncryptType":"Private"</EncryptSetting>
              <Clip>{\"TimeSpan\":{\"Seek\":\"1\",\"Duration\":\"5\"}</Clip>
              <Type>Normal</Type>
              <Container>"Format":"m3u8"</Container>
              <TranscodeTemplateId>696d29a11erc057*****a3acc398d02f4</TranscodeTemplateId>
              <TransConfig>{"IsCheckReso":"true","IsCheckResoFail":"false","IsCheckVideoBitrate":"false","IsCheckVideoBitrateFail":"false","IsCheckAudioBitrate":"false","IsCheckAudioBitrateFail":"false"}</TransConfig>
              <Video>{"Codec":"H.264","Bitrate":"900","Width":"960","Remove":"false","Fps":"30"}</Video>
              <TemplateName>test</TemplateName>
              <SubtitleList>[{"SubtitleUrl":"http://outin-test.oss-cn-shanghai.aliyuncs.com/subtitles/c737fece-14f1-4364-b107-d5f7f8edde0e.ass","CharEncode":"utf-8"}]</SubtitleList>
              <Audio>{\"Codec\":\"AAC\",\"Remove\":\"false\",\"Bitrate\":\"44\",\"Samplerate\":\"32000\",\"Channels\":\"2\",\"Profile\":\"aac_low\"}</Audio>
              <MuxConfig>"Segment": { "Duration":"6" }</MuxConfig>
              <OpeningList>[{"OpenUrl":"http://outin-test.oss-cn-shanghai.aliyuncs.com/tailslates/b6e9ceed-b665-426f-9d9a-277f0f****.mov"}]</OpeningList>
        </TranscodeTemplateList>
        <TranscodeTemplateList>
              <WatermarkIds>"USER_DEFAULT_WATERMARK","ddddddddd"</WatermarkIds>
        </TranscodeTemplateList>
        <CreationTime>2018-12-12T10:20:51Z</CreationTime>
        <Name>test</Name>
  </TranscodeTemplateGroup>
</GetTranscodeTemplateGroupResponse>

Formato JSON

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

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.

Erros comuns

A tabela a seguir descreve os erros comuns que esta operação pode retornar.

Código de erro	Mensagem de erro	Código de status HTTP	Descrição
InvalidTranscodeTemplateGroup.NotFound	The transcode template group does not exist.	404	Mensagem de erro retornada porque o grupo de modelos de transcodificação especificado não existe.

Exemplos de sdk

Recomendamos o uso dos SDKs de servidor para chamar esta operação. Visualize o código de exemplo em diferentes linguagens para chamar esta operação clicando nos links a seguir: