Créer et utiliser des modèles standards - Intelligent Media Services

Un modèle standard s'appuie sur la timeline d'un projet de montage vidéo et contient plusieurs ressources multimédias assemblées sur différentes couches. Utilisez les modèles standards pour convertir du texte et des images en vidéos, créer des albums photo, générer des introductions et des conclusions, ou appliquer des filigranes par défaut.

Créer un modèle standard

Créer via la console

Connectez-vous à la console Intelligent Media Services (IMS).
Dans le volet de navigation de gauche, choisissez Intelligent Production > Online Editing pour ouvrir la page Online Editing.
Une fois le projet de montage vidéo modifié et enregistré, cliquez sur Generate Template dans la page d'édition, ou sur Export Template dans la colonne Actions de la liste des projets pour créer un modèle standard.

Pour savoir comment modifier un modèle, consultez le Guide du concepteur pour les modèles standards.

Créer via une API

Personnalisez la configuration du modèle standard.
La configuration d'un modèle standard s'appuie sur la timeline d'un projet Online Editing et offre une grande flexibilité. Pour personnaliser votre modèle, familiarisez-vous avec sa structure. Pour plus d'informations, consultez les Détails de la configuration d'un modèle standard.

L'exemple suivant présente la configuration d'un modèle d'assemblage vidéo. Pour plus d'exemples, consultez les Exemples de configuration pour les modèles standards courants.
```
{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "Sys_Type" : "ArrayItems",
                    "Sys_ArrayObject" : "$VideoArray",
                    "Sys_Template" : {
                        "MediaId" : "$MediaId"
                    }
                }
            ]
        }
    ]
}
```

Créez un modèle standard.

Appelez l'opération AddTemplate et transmettez la configuration du modèle.

AddTemplateRequest request = new AddTemplateRequest();
request.setType("Timeline"); // Set Type to "Timeline" for a regular template.
request.setName("Regular Template Test");
request.setConfig("{\"VideoTracks\":[{\"VideoTrackClips\":[{\"Sys_Type\":\"ArrayItems\",\"Sys_ArrayObject\":\"$VideoArray\",\"Sys_Template\":{\"MediaId\":\"$MediaId\"}}]}]}");
AddTemplateResponse response = iceClient.addTemplate(request);
System.out.println("templateId : " + response.getBody().getTemplate().getTemplateId());

Un appel réussi renvoie un ID de modèle. Utilisez cet ID pour soumettre une tâche de production.

Utiliser un modèle standard

Utiliser via la console

Connectez-vous à la console Intelligent Media Services (IMS).
Dans le volet de navigation de gauche, choisissez Intelligent Production > Template Factory pour ouvrir la page Template Factory.
Utilisez un modèle standard pour le montage en ligne.
1. Cliquez sur l'onglet Regular Templates.
2. Recherchez le modèle souhaité et cliquez sur Use Template dans la colonne Actions.
3. Saisissez un nom de projet et cliquez sur OK. Suivez les instructions pour commencer à modifier le projet. Pour plus d'informations sur la modification d'un projet (montage standard), consultez les Fonctionnalités de montage.

Utiliser via une API

Récupérez les informations du modèle.
- Depuis la console
  
  Si le modèle a été créé dans la console, recherchez-le dans la Template Factory. Dans la colonne Actions, cliquez sur Edit Template. Ensuite, utilisez la fonctionnalité Dynamic material management pour construire le paramètre ClipsParam.
  
  Construisez le paramètre comme suit : utilisez la valeur ID Naming comme clé, et le texte de remplacement ou l'ID de la ressource multimédia comme valeur. L'exemple suivant montre le paramètre ClipsParam généré :
```
{
 "1": "Replaced subtitle text",
 "2": "****20b48fb04483915d4f2cd8ac****",
 "3": "****20b48fb04483915d4f2cd8ac****",
 "4": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-video1.mp4",
 "5": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-video2.mp4"
}
```
- En appelant une API
  
  Appelez l'opération GetTemplate pour récupérer les informations du modèle. Transmettez l'ID de modèle renvoyé lors de la création du modèle à l'étape 2.
  
  Le champ ClipsParam de la réponse se présente comme suit :
```
{"1":"text","2":"mediaId","3":"mediaId","4":"mediaId","5":"mediaId"}
```
  Remarque
  Vous pouvez également utiliser un modèle prédéfini. Le processus est similaire et n'est pas détaillé ici. Pour consulter les modèles prédéfinis disponibles, voir les Modèles standards dans la bibliothèque de modèles publics.
Remplacez les valeurs text et mediaId dans le paramètre ClipsParam de l'exemple ci-dessus.
```
{
 "1": "Replaced subtitle text",
 "2": "****20b48fb04483915d4f2cd8ac****",
 "3": "****20b48fb04483915d4f2cd8ac****",
 "4": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-video1.mp4",
 "5": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-video2.mp4"
}
```
Remarque
ClipsParam est un paramètre destiné au service de production. Remplacez text par le texte de sous-titre souhaité et mediaId par un ID de ressource multimédia ou une URL OSS pour une vidéo ou une image. Vous pouvez combiner les deux types de valeurs.

Soumettez une tâche de production.

Appelez l'opération SubmitMediaProducingJob pour soumettre une tâche de montage et de production. Transmettez l'ID de modèle et ClipsParam.

SubmitMediaProducingJobRequest request = new SubmitMediaProducingJobRequest();
request.setTemplateId("Your TemplateId");
request.setClipsParam("{\"1\":\"Replaced subtitle\",\"2\":\"****20b48fb04483915d4f2cd8ac****\",\"3\":\"****20b48fb04483915d4f2cd8ac****\",\"4\":\"****20b48fb04483915d4f2cd8ac****\",\"5\":\"****20b48fb04483915d4f2cd8ac****\"}");
request.setOutputMediaConfig("{\"MediaURL\":\"http://your-bucket.oss-cn-shanghai.aliyuncs.com/object.mp4\"}");
SubmitMediaProducingJobResponse response = iceClient.submitMediaProducingJob(request);
System.out.println("jobid : " + response.getBody().getJobId());