Todos os produtos
Search
Central de documentação

Intelligent Media Services:Criar e usar modelos comuns

Última atualização: Jun 28, 2026

Um modelo comum baseia-se na linha do tempo de um projeto de edição de vídeo e contém vários ativos de mídia unidos em camadas. Use esses modelos para transformar textos e imagens em vídeos, criar álbuns de fotos, gerar introduções e encerramentos, além de aplicar marcas d'água padrão.

Criar um modelo comum

Criação pelo console

  1. Faça login no console do Intelligent Media Services (IMS).

  2. No painel de navegação à esquerda, escolha Intelligent Production > Online Editing para abrir a página Online Editing.

  3. Após editar e salvar um projeto de edição de vídeo, clique em Generate Template na página de edição ou em Export Template na coluna Actions da lista de projetos para gerar o modelo comum.

    Para saber como editar um modelo, consulte Guia do designer para modelos comuns.

Criação por API

  1. Personalize a configuração do modelo comum.

    A configuração de um modelo comum segue a linha do tempo de um projeto de Online Editing e oferece grande flexibilidade. Para personalizar seu modelo, familiarize-se com a estrutura de configuração. Para mais informações, consulte Detalhes da configuração de modelos comuns.

    O exemplo abaixo mostra a configuração para um modelo de união de vídeos. Para mais exemplos, consulte Exemplos de configuração para modelos comuns frequentes.

    {
        "VideoTracks": [
            {
                "VideoTrackClips": [
                    {
                        "Sys_Type" : "ArrayItems",
                        "Sys_ArrayObject" : "$VideoArray",
                        "Sys_Template" : {
                            "MediaId" : "$MediaId"
                        }
                    }
                ]
            }
        ]
    }
  2. Crie o modelo comum.

    Chame a operação AddTemplate e passe a configuração do modelo.

    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());

    Uma chamada bem-sucedida retorna um ID de modelo. Use esse ID para enviar uma tarefa de produção.

Usar um modelo comum

Uso pelo console

  1. Faça login no console do Intelligent Media Services (IMS).

  2. No painel de navegação à esquerda, escolha Intelligent Production > Template Factory para acessar a página Template Factory.

  3. Use um modelo comum para edição online.

    1. Clique em Regular Templates.

    2. Localize o modelo desejado e clique em Use Template na coluna Actions.

    3. Insira um nome para o projeto e clique em OK. Siga as instruções para iniciar a edição. Para mais detalhes sobre como editar um projeto (edição comum), consulte Recursos de edição.

Uso por API

  1. Obtenha as informações do modelo.

    • Pelo console

      Se você criou o modelo no console, localize-o na Template Factory. Na coluna Actions, clique em Edit Template. Em seguida, use o recurso Dynamic material management para montar o parâmetro ClipsParam.

      Monte o parâmetro da seguinte forma: use o valor de ID Naming como chave e o texto de substituição ou o ID do ativo de mídia como valor. O exemplo abaixo ilustra o parâmetro ClipsParam gerado:

      {
       "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"
      }
    • Por chamada de API

      Chame a operação GetTemplate para recuperar as informações do modelo. Passe o template ID retornado quando você criou o modelo na Etapa 2.

      O campo ClipsParam na resposta é o seguinte:

      {"1":"text","2":"mediaId","3":"mediaId","4":"mediaId","5":"mediaId"}
      Nota

      Também é possível usar um modelo predefinido. O processo é semelhante e não será detalhado aqui. Para ver os modelos predefinidos disponíveis, consulte Modelos comuns na biblioteca pública de modelos.

  2. Substitua os valores de espaço reservado text e mediaId no parâmetro ClipsParam do exemplo acima.

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

    ClipsParam é um parâmetro do serviço de produção. Substitua text pelo texto da legenda desejada e mediaId pelo ID de um ativo de mídia ou por uma URL do OSS para um vídeo ou imagem. É possível combinar ambos os tipos.

  3. Envie uma tarefa de produção.

    Chame a operação SubmitMediaProducingJob para enviar uma tarefa de edição e produção. Passe o template ID e o 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());