Détails du modèle standard Config - Intelligent Media Services

Lorsque vous soumettez une tâche de montage vidéo avec un TemplateId, le système fusionne le Config du modèle standard avec le paramètre d'entrée ClipsParam pour former une Timeline qui détermine le traitement de la tâche. Les exemples suivants présentent des configurations courantes de modèles standards et les Timelines résultantes.

Exemple : Paramètres standards dans un Config

Ajouter un filigrane à une vidéo

Config

{
    "VideoTracks": [
        {  
            "VideoTrackClips": [
                {    
                    "MediaId": "$Video"
                }
            ]
        }
    ],
    "ImageTracks": [
        {
            "ImageTrackClips": [
                {
                    "ImageId": "******e01cb05d417c3dbcd1b9******",
                    "Width" : 200,
                    "Height" : 60,
                    "X" : 40,
                    "Y" : 40
                }
            ]
        }
    ]
}

Timeline

{
    "VideoTracks": [
        {  
            "VideoTrackClips": [
                {    
                    "MediaId": "****20b48fb04483915d4f2cd8ac****"
                }
            ]
        }
    ],
    "ImageTracks": [
        {
            "ImageTrackClips": [
                {
                    "ImageId": "******e01cb05d417c3dbcd1b9******",
                    "Width" : 200,
                    "Height" : 60,
                    "X" : 40,
                    "Y" : 40
                }
            ]
        }
    ]
}

Analyse :

Dans un Config de modèle standard, les champs de paramètres commencent par un signe dollar ($), comme "$Video" dans l'exemple de Config précédent.
Pour soumettre une tâche de montage vidéo, définissez TemplateId sur IceSys_SingleVideo_Watermark et spécifiez le champ Video dans ClipsParam. La timeline finale fusionnée est illustrée dans l'exemple de Timeline précédent.
```
http://ice.cn-shanghai.aliyuncs.com/?Action=SubmitMediaProducingJob
&TemplateID=IceSys_SingleVideo_Watermark
&ClipsParam={\"Video\":\"****20b48fb04483915d4f2cd8ac****\"}
&<common parameters>
```

Ajouter un filigrane à une vidéo (Config avec valeurs par défaut)

Config

{
    "VideoTracks": [
        {  
            "VideoTrackClips": [
                {    
                    "MediaId": "$Video"
                }
            ]
        }
    ],
    "ImageTracks": [
        {
            "ImageTrackClips": [
                {
                    "ImageId": "******e01cb05d417c3dbcd1b9******",
                    "Width" : 200,
                    "Height" : 60,
                    "X" : "$X:40",
                    "Y" : "$Y:40",
                    "TimelineIn" : "$TimelineIn:0",
                    "TimelineOut" : "$TimelineOut:NULL"
                }
            ]
        }
    ]
}

Timeline

{
    "VideoTracks": [
        {  
            "VideoTrackClips": [
                {    
                    "MediaId": "****20b48fb04483915d4f2cd8ac****"
                }
            ]
        }
    ],
    "ImageTracks": [
        {
            "ImageTrackClips": [
                {
                    "ImageId": "******e01cb05d417c3dbcd1b9******",
                    "Width" : 200,
                    "Height" : 60,
                    "X" : 40,
                    "Y" : 40,
                    "TimelineIn" : 5
                }
            ]
        }
    ]
}

Analyse :

Un Config de modèle standard prend en charge les valeurs par défaut. Si un champ de paramètre n'est pas spécifié dans la requête, le système utilise sa valeur par défaut. Dans le Config précédent, "$TimelineIn:0" et "$TimelineOut:NULL" définissent des valeurs par défaut, où la valeur après les deux-points (:) correspond à la valeur par défaut.
Si la valeur par défaut est NULL et que vous n'incluez pas le paramètre dans la requête, le système supprime le champ de la Timeline finale.
Pour soumettre une tâche de montage vidéo, définissez TemplateId sur IceSys_SingleVideo_Watermark et spécifiez les champs requis dans ClipsParam. La timeline finale fusionnée est illustrée dans l'exemple de Timeline précédent.
```
http://ice.cn-shanghai.aliyuncs.com/?Action=SubmitMediaProducingJob
&TemplateId=IceSys_SingleVideo_Watermark
&ClipsParam={\"Video\":\"****20b48fb04483915d4f2cd8ac****\",\"TimelineIn\":\"5\"}
&<common parameters>
```

Exemple : Paramètres de tableau dans un Config

Couper le son d'une piste vidéo entière

Config

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "Sys_Type" : "ArrayItems",
                    "Sys_ArrayObject" : "$VideoArray",
                    "Sys_Template" : {
                        "MediaId" : "$MediaId",
                        "Effects": [
                            {
                                "Type": "Volume",
                                "Gain": "0"
                            }
                        ]
                    }
                }
            ]
        }
    ]
}

Timeline

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId" : "******05512043f49f697f7425******",
                    "Effects": [
                        {
                            "Type": "Volume",
                            "Gain": "0",
                        }
                    ]
                },
                {
                    "MediaId" : "******2788e810116a45109f2e******",
                    "Effects": [
                        {
                            "Type": "Volume",
                            "Gain": "0",
                        }
                    ]
                },
                {
                    "MediaId" : "******67f44f4964e6c998dee8******",
                    "Effects": [
                        {
                            "Type": "Volume",
                            "Gain": "0",
                        }
                    ]
                }
            ]
        }
    ]
}

Analyse :

Le code suivant, extrait de l'exemple de Config précédent, montre un paramètre de tableau qui permet de transmettre un nombre variable de ressources multimédias.

{
    "Sys_Type" : "ArrayItems",
    "Sys_ArrayObject" : "$VideoArray",
    "Sys_Template" : {
        "MediaId" : "$MediaId",
        "Effects": [
            {
                "Type": "Volume",
                "Gain": "0"
            }
        ]
    }
}

Pour soumettre une tâche de montage vidéo, définissez TemplateId sur IceSys_VideoMute et transmettez le tableau VideoArray dans ClipsParam. Le système parcourt VideoArray, utilise Sys_Template pour générer chaque élément et les encapsule dans un nouveau tableau. La timeline finale fusionnée est illustrée dans l'exemple de Timeline précédent.

http://ice.cn-shanghai.aliyuncs.com/?Action=SubmitMediaProducingJob
&TemplateID=IceSys_VideoMute
&ClipsParam={\"VideoArray\":[{\"MediaId\":\"******05512043f49f697f7425******\"},{\"MediaId\":\"******05512043f49f697f7425******\"},{\"MediaId\":\"******05512043f49f697f7425******\"}]}
&<common parameters>

Si Sys_Template ne contient qu'un seul paramètre, simplifiez la saisie en transmettant directement les valeurs sans spécifier le nom du paramètre pour chaque élément du tableau. La timeline finale fusionnée est identique à celle de l'exemple de Timeline précédent.
```
http://ice.cn-shanghai.aliyuncs.com/?Action=SubmitMediaProducingJob
&TemplateID=IceSys_VideoMute
&ClipsParam={\"VideoArray\":[\"b3f37e05512043f49f697f7425b9188b\",\"9987d22788e810116a45109f2ea88648\",\"a8f5f167f44f4964e6c998dee827110c\"]}
&<common parameters>
```

Ajouter un clip d'ouverture et un clip de fermeture

Config

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "******2788e810116a45109f2e******" // This is the opening video clip.
                },
                {
                    "Sys_Type" : "ArrayItems",
                    "Sys_ArrayObject" : "$VideoArray",
                    "Sys_Template" : {
                        "MediaId" : "$MediaId"
                    }
                },
                {
                    "MediaId": "******67f44f4964e6c998dee8******" // This is the closing video clip.
                }
            ]
        }
    ]
}

Timeline

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "******2788e810116a45109f2e******" // This is the opening video clip.
                },
                {
                    "MediaId": "******05512043f49f697f7425******"
                },
                {
                    "MediaId": "******2788e810116a45109f2e******"
                },
                {
                    "MediaId": "******67f44f4964e6c998dee8******"
                },
                {
                    "MediaId": "******67f44f4964e6c998dee8******" // This is the closing video clip.
                }
            ]
        }
    ]
}

Analyse :

Ce modèle standard insère un clip d'ouverture fixe au début et un clip de fermeture fixe à la fin de la piste vidéo. Le paramètre de tableau situé entre eux accepte un nombre variable de ressources multimédias. Pour soumettre une tâche de montage vidéo, définissez TemplateId sur IceSys_OpeningEnding et transmettez le tableau VideoArray dans ClipsParam.

http://ice.cn-shanghai.aliyuncs.com/?Action=SubmitMediaProducingJob
&TemplateID=IceSys_OpeningEnding
&ClipsParam={\"VideoArray\":[\"******05512043f49f697f7425******\",\"******2788e810116a45109f2e******\",\"******67f44f4964e6c998dee8******\"]}
&<common parameters>

Pour créer la Timeline, le système parcourt VideoArray et utilise Sys_Template pour générer chaque élément, en les encapsulant dans un nouveau tableau. La Timeline initiale résultante présente un format anormal car l'élément central de VideoTrackClips devient un tableau de clips imbriqué, comme indiqué ci-dessous :

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "******2788e810116a45109f2e******" // This is the opening video clip.
                },
                [
                    {
                        "MediaId": "******05512043f49f697f7425******"
                    },
                    {
                        "MediaId": "******2788e810116a45109f2e******"
                    },
                    {
                        "MediaId": "******67f44f4964e6c998dee8******"
                    }
                ],
                {
                    "MediaId": "******67f44f4964e6c998dee8******" // This is the closing video clip.
                }
            ]
        }
    ]
}

Pour gérer cette situation, Intelligent Media Services effectue un traitement de tolérance aux pannes en extrayant les éléments du tableau imbriqué et en les aplatissant dans un tableau unidimensionnel. La timeline finale fusionnée est illustrée dans l'exemple de Timeline précédent.