Todos os produtos
Search

Este produto

    Intelligent Media Services:Objeto Config de um modelo comum

    Central de documentação

    Intelligent Media Services:Objeto Config de um modelo comum

    Última atualização: Jun 28, 2026

    Ao enviar uma tarefa de edição e produção com o parâmetro TemplateId, o Intelligent Media Services (IMS) mescla o objeto Config do modelo comum especificado por esse parâmetro às configurações definidas em ClipsParam, resultando em um objeto Timeline. Use esse objeto Timeline para editar e produzir o vídeo. Este tópico apresenta exemplos de objetos Config de modelos comuns e os respectivos objetos Timeline correspondentes.

    Exemplos de objetos Config com parâmetros comuns

    Adicionar marcas d'água a um vídeo

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

    Descrição:

    • Os valores de parâmetros no objeto Config de um modelo comum começam com $. Por exemplo, observe "$Video" no objeto Config de exemplo anterior.

    • Ao enviar uma tarefa de edição e produção, defina o parâmetro TemplateId como IceSys_SingleVideo_Watermark e adicione Video às configurações do parâmetro ClipsParam. Para obter mais informações sobre o objeto Timeline gerado, consulte o exemplo de objeto Timeline acima.

      http://ice.cn-shanghai.aliyuncs.com/?Action=SubmitMediaProducingJob
&TemplateID=IceSys_SingleVideo_Watermark
&ClipsParam={\"Video\":\"****20b48fb04483915d4f2cd8ac****\"}
&<Common parameters>

    Adicionar marcas d'água a um vídeo (valores padrão de parâmetros aceitos no objeto Config)

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

    Descrição:

    • O objeto Config de um modelo comum aceita valores padrão para parâmetros. Se você não especificar determinados parâmetros, o IMS usará os valores padrão correspondentes. Veja os exemplos "$TimelineIn:0" e "$TimelineOut:NULL" no objeto Config de exemplo anterior. Os valores após os dois pontos (:) representam os valores padrão dos parâmetros TimelineIn e TimelineOut.

    • Se o valor padrão de um parâmetro for NULL e você não o especificar, o IMS removerá esse parâmetro do objeto Timeline gerado.

    • Ao enviar uma tarefa de edição e produção, defina o parâmetro TemplateId como IceSys_SingleVideo_Watermark e inclua Video nas configurações do parâmetro ClipsParam. Consulte o exemplo de objeto Timeline acima para obter detalhes sobre o objeto Timeline resultante.

      http://ice.cn-shanghai.aliyuncs.com/?Action=SubmitMediaProducingJob
&TemplateId=IceSys_SingleVideo_Watermark
&ClipsParam={\"Video\":\"****20b48fb04483915d4f2cd8ac****\",\"TimelineIn\":\"5\"}
&<Common parameters>

    Exemplos de objetos Config com parâmetros de array

    Silenciar toda uma faixa de vídeo

    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",
                            }
                        ]
                    }
                ]
            }
        ]
    }

    Descrição:

    • A seção a seguir, extraída do objeto Config de exemplo anterior, usa uma estrutura baseada em array para acomodar uma quantidade variável de materiais definidos em $VideoArray:

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

      Para enviar uma tarefa de edição e produção, defina o parâmetro TemplateId como IceSys_VideoMute e adicione VideoArray às configurações do parâmetro ClipsParam. Durante a geração do objeto Timeline, o IMS percorre o parâmetro VideoArray, cria elementos usando o objeto Sys_Template e os agrupa em um novo array. Consulte o exemplo de objeto Timeline acima para obter mais detalhes sobre o resultado gerado.

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

    • Se o objeto Sys_Template contiver apenas um parâmetro, simplifique a entrada informando somente os valores dos elementos do array, sem precisar indicar os nomes dos parâmetros correspondentes. O objeto Timeline gerado será idêntico ao exemplo anterior.

      http://ice.cn-shanghai.aliyuncs.com/?Action=SubmitMediaProducingJob
&TemplateID=IceSys_VideoMute
&ClipsParam={\"VideoArray\":[\"b3f37e05512043f49f697f7425b9188b\",\"9987d22788e810116a45109f2ea88648\",\"a8f5f167f44f4964e6c998dee827110c\"]}
&<Common parameters>

    Adicionar vídeos de introdução e encerramento

    Config

    {
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "******2788e810116a45109f2e******" // The ID of the intro video to be merged.
                },
                {
                    "Sys_Type" : "ArrayItems",
                    "Sys_ArrayObject" : "$VideoArray",
                    "Sys_Template" : {
                        "MediaId" : "$MediaId"
                    }
                },
                {
                    "MediaId": "******67f44f4964e6c998dee8******" // The ID of the outro video to be merged.
                }
            ]
        }
    ]
}

    Timeline

    {
        "VideoTracks": [
            {
                "VideoTrackClips": [
                    {
                        "MediaId": "******2788e810116a45109f2e******" // The ID of the intro video to be merged.
                    },
                    {
                        "MediaId": "******05512043f49f697f7425******"
                    },
                    {
                        "MediaId": "******2788e810116a45109f2e******"
                    },
                    {
                        "MediaId": "******67f44f4964e6c998dee8******"
                    },
                    {
                        "MediaId": "******67f44f4964e6c998dee8******" // The ID of the outro video to be merged.
                    }
                ]
            }
        ]
    }

    Descrição:

    Um modelo comum insere um vídeo fixo de introdução e um vídeo fixo de encerramento no início e no fim de uma faixa de vídeo. Especifique uma quantidade variável de materiais entre esses dois vídeos por meio de um parâmetro de array. Ao enviar uma tarefa de edição e produção, defina o parâmetro TemplateId como IceSys_OpeningEnding e adicione VideoArray às configurações do parâmetro ClipsParam.

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

    Para gerar o objeto Timeline, o IMS percorre o parâmetro VideoArray, produz elementos com base no objeto Sys_Template e os encapsula em um novo array. No entanto, o formato preliminar do objeto Timeline gerado é inválido, pois os itens intermediários entre o vídeo de introdução e o de encerramento em VideoTrackClips são processados como um array de clipes. Código de exemplo:

    {
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "******2788e810116a45109f2e******" // The ID of the intro video to be merged.
                },
                [
                    {
                        "MediaId": "******05512043f49f697f7425******"
                    },
                    {
                        "MediaId": "******2788e810116a45109f2e******"
                    },
                    {
                        "MediaId": "******67f44f4964e6c998dee8******"
                    }
                ],
                {
                    "MediaId": "******67f44f4964e6c998dee8******" // The ID of the outro video to be merged.
                }
            ]
        }
    ]
}

    Nessa situação, o IMS aplica tolerância a falhas automaticamente. Ou seja, ele extrai os elementos do array conforme o contexto atual e converte a estrutura em um array unidimensional. Para visualizar o objeto Timeline final gerado, consulte o exemplo de objeto Timeline apresentado anteriormente.

    Referências