GetTranscodeTemplateGroup - - Centre de documentation Alibaba Cloud

Récupère les détails d’un groupe de modèles de transcodage à partir de son ID.

Remarque

Cette opération renvoie les informations relatives au groupe de modèles de transcodage spécifié, ainsi que la configuration de tous les modèles de transcodage qu’il contient.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d’appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre

Type

Obligatoire

Exemple

Description

Action

String

Oui

GetTranscodeTemplateGroup

L’opération à effectuer. Définissez la valeur sur GetTranscodeTemplateGroup.

TranscodeTemplateGroupId

String

Oui

a591f697c7167*6ae1502142d0

L’ID du groupe de modèles de transcodage.

Paramètres de réponse

Paramètre	Type	Exemple	Description
RequestId	String	6730AC93-7B12-4B*****7F-49EE1FE8BC49	L’ID de la requête.
TranscodeTemplateGroup	Struct		Les informations relatives au groupe de modèles de transcodage.
AppId	String	app-****	L’ID de l’application.
CreationTime	String	2018-12-12T10:20:51Z	La date de création du groupe de modèles. L’heure respecte la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L’heure est affichée en UTC.
IsDefault	String	NotDefault	Indique si le groupe de modèles est celui par défaut. Valeurs possibles : Default : le groupe de modèles est celui par défaut. NotDefault : le groupe de modèles n’est pas celui par défaut.
Locked	String	Enabled	Indique si le groupe de modèles est verrouillé. Valeurs possibles : Disabled : le groupe de modèles n’est pas verrouillé. Enabled : le groupe de modèles est verrouillé.
ModifyTime	String	2018-12-12T11:20:51Z	La date de modification du groupe de modèles. L’heure respecte la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L’heure est affichée en UTC.
Name	String	test	Le nom du groupe de modèles.
TranscodeTemplateGroupId	String	a59b11f697c716*****6ae1502142d0	L’ID du groupe de modèles de transcodage.
TranscodeTemplateList	Array of TranscodeTemplate		La configuration des modèles de transcodage.
Audio	String	{\"Codec\":\"AAC\",\"Remove\":\"false\",\"Bitrate\":\"44\",\"Samplerate\":\"32000\",\"Channels\":\"2\",\"Profile\":\"aac_low\"}	La configuration de transcodage du flux audio. La valeur est une chaîne au format JSON.
Clip	String	{\"TimeSpan\":{\"Seek\":\"1\",\"Duration\":\"5\"}	La configuration de découpage de la vidéo. La valeur est une chaîne au format JSON. Par exemple, définissez ce paramètre pour extraire 5 secondes de contenu d’une vidéo afin d’en générer une nouvelle.
Container	String	"Format":"m3u8"	Le format du conteneur utilisé pour encapsuler les flux audio et vidéo. La valeur est une chaîne au format JSON.
Definition	String	SD	Valeurs possibles pour la définition d’un modèle de transcodage standard : LD : basse définition. SD : définition standard. HD : haute définition. FHD : ultra haute définition. OD : qualité d’origine. 2K 4K SQ : qualité sonore standard. HQ : haute qualité sonore. Valeurs possibles pour la définition d’un modèle de transcodage Narrowband HD™ 1,0 : LD-NBV1 : basse définition. SD-NBV1 : définition standard. HD-NBV1 : haute définition. FHD-NBV1 : ultra haute définition. 2K-NBV1 4K-NBV1 Remarque Vous ne pouvez pas modifier la définition des modèles de transcodage. Vous ne pouvez pas modifier les paramètres système (tels que la résolution vidéo, la résolution audio et le débit binaire) des modèles de transcodage Narrowband HD™ 1,0. Vous pouvez uniquement créer des modèles de transcodage Narrowband HD™ 1,0 qui prennent en charge les formats de sortie FLV, M3U8 (HLS) et MP4.
EncryptSetting	String	"EncryptType":"Private"	La configuration de chiffrement utilisée pour le transcodage.
MuxConfig	String	"Segment": { "Duration":"6" }	La configuration des segments de transcodage. Ce paramètre doit être renvoyé si le chiffrement HTTP-Live-Streaming (HLS) est utilisé. La valeur est une chaîne au format JSON.
PackageSetting	String	"PackageType":"HLSPackage","PackageConfig":{ "BandWidth":"900000" }	La configuration d’empaquetage. Seuls l’empaquetage HLS et l’empaquetage DASH sont pris en charge. La valeur est une chaîne au format JSON.
Rotate	String	90	L’identifiant de rotation de la vidéo. Il sert à contrôler l’angle de rotation de l’image. Par exemple, si vous définissez ce paramètre sur 180, l’image vidéo est inversée. Valeurs possibles : `0 à 360`.
SubtitleList	String	[{"SubtitleUrl":"http://outin-test.oss-cn-shanghai.aliyuncs.com/subtitles/c737fece-14f1-4364-b107-d5f7f8edde0e.ass","CharEncode":"utf-8"}]	La configuration des sous-titres. La valeur est une chaîne au format JSON.
TemplateName	String	test	Le nom du modèle de transcodage.
TransConfig	String	{"IsCheckReso":"true","IsCheckResoFail":"false","IsCheckVideoBitrate":"false","IsCheckVideoBitrateFail":"false","IsCheckAudioBitrate":"false","IsCheckAudioBitrateFail":"false"}	La configuration de transcodage conditionnel. Utilisez ce paramètre pour déterminer la logique de base selon le débit binaire et la résolution du fichier mezzanine avant le transcodage de la vidéo. La valeur est une chaîne au format JSON.
TranscodeFileRegular	String	{MediaId}/transcoce_1	Le chemin de sortie personnalisé des fichiers transcodés.
TranscodeTemplateId	String	696d29a11erc057*****a3acc398d02f4	L’ID du modèle de transcodage.
Type	String	Normal	Le type de modèle. Valeurs possibles : Normal : un modèle de transcodage standard. Il s’agit de la valeur par défaut. Le paramètre PackageSetting ne peut pas être défini pour ce type de modèle. VideoPackage : un modèle d’empaquetage de flux vidéo. Si ce type de modèle est utilisé, ApsaraVideo VOD transcode une vidéo en flux vidéo avec différents débits binaires et empaquette ces flux dans un fichier. Le paramètre PackageSetting doit être défini pour ce type de modèle. SubtitlePackage : un modèle d’empaquetage de sous-titres. Si ce type de modèle est utilisé, ApsaraVideo VOD ajoute les informations de sous-titrage au fichier de sortie généré par l’empaquetage des flux vidéo multi-débits de la vidéo correspondante. Vous devez définir le paramètre PackageSetting pour un modèle d’empaquetage de sous-titres et l’associer à un modèle d’empaquetage de flux vidéo. Un groupe de modèles ne peut contenir qu’un seul modèle d’empaquetage de sous-titres.
Video	String	{"Codec":"H.264","Bitrate":"900","Width":"960","Remove":"false","Fps":"30"}	La configuration de transcodage du flux vidéo. La valeur est une chaîne au format JSON.
WatermarkIds	List	"USER_DEFAULT_WATERMARK","ddddddddd"	L’ID du filigrane associé.

Exemples

Exemple de requête

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

Exemple de réponse réussie

XML format

<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>

JSON format

{
    "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"
    }
}

Codes d’erreur

Pour obtenir la liste des codes d’erreur, consultez le Centre d’erreurs de l’API.

Erreurs courantes

Le tableau suivant décrit les erreurs courantes que cette opération peut renvoyer.

Code d’erreur

Message d’erreur

Code d’état HTTP

Description

InvalidTranscodeTemplateGroup.NotFound

The transcode template group does not exist.

404

Le message d’erreur indique que le groupe de modèles de transcodage spécifié n’existe pas.

Exemples de SDK

Nous vous recommandons d’utiliser les SDK serveur pour appeler cette opération. Consultez les exemples de code dans différents langages en cliquant sur les liens suivants :