ProduceEditingProjectVideo - : Central de Documentação do Alibaba Cloud

Produz um vídeo a partir de um ou mais arquivos mezzanine. Envie os arquivos mezzanine diretamente ao especificar o parâmetro Timeline ou envie-os após criar um projeto de edição online.

Nota

Esta operação retorna apenas o status de envio da tarefa de produção de vídeo. A produção pode continuar em andamento mesmo após o retorno do resultado. Após o envio, a tarefa entra em fila para processamento assíncrono em segundo plano.
- Os arquivos mezzanine referenciados na timeline de um projeto de edição online podem ser materiais de ativos de mídia ou vídeos da biblioteca de mídia.
A produção dos vídeos utiliza os parâmetros ProjectId e Timeline. Observe os seguintes pontos ao especificá-los:
- Especifique pelo menos um dos parâmetros: ProjectId ou Timeline. Caso contrário, a produção do vídeo falhará.
- Se você especificar apenas o parâmetro Timeline, o sistema criará automaticamente um projeto de edição online com a timeline informada. Em seguida, obterá os arquivos mezzanine referenciados nessa timeline e produzirá o vídeo correspondente.
- Ao especificar somente o parâmetro ProjectId, o sistema recuperará a timeline mais recente do projeto indicado e gerará o vídeo com base nela.
- Quando ambos os parâmetros ProjectId e Timeline forem fornecidos, o sistema produzirá o vídeo conforme a timeline especificada e atualizará tanto a timeline quanto os arquivos mezzanine do projeto de edição online. Se outros parâmetros forem definidos, as configurações relacionadas do projeto também serão atualizadas.
- Aplique efeitos ao vídeo que será produzido. Para mais informações, consulte Efeitos especiais.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer, que gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	ProduceEditingProjectVideo	A operação a ser executada. Defina o valor como ProduceEditingProjectVideo.
ProjectId	String	Não	fb2101bf24b*****4cb318787dc	O ID do projeto de edição online.
Timeline	String	Não	{"VideoTracks":[{"VideoTrackClips":[{"MediaId":"cc3308ac5***9615a54328bc3443"},{"MediaId":"da87a9cff64***5cd88bc6d8326e4"}]}]}	A timeline do projeto de edição online, no formato JSON. Para mais informações sobre a estrutura, consulte Timeline.
Title	String	Não	Teste de produção de vídeo	O título do projeto de edição online.
Description	String	Não	Descrição	A descrição do projeto de edição online.
CoverURL	String	Não	https://**.com/6AB4D0E1E1C7446888351**.png	A URL da miniatura do projeto de edição online.
MediaMetadata	String	Não	{"Description": "Descrição do vídeo produzido", "Title": "Teste de produção baseado em dados do usuário"}	Os metadados do vídeo produzido, no formato JSON. Para mais informações sobre a estrutura, consulte MediaMetadata.
ProduceConfig	String	Não	{"TemplateGroupId":"6d11e25ea30a*****4c465435c74"}	A configuração da produção de vídeo, no formato JSON. Para mais informações sobre a estrutura, consulte ProduceConfig.
UserData	String	Não	{"Extend":{"width":1280,"id":"028a8e56b*****1ebf6bb7afc74","height":720},"MessageCallback":{"CallbackURL":"https://xxxxx.com/2016-08-15/proxy/httpcallback/testcallback/","CallbackType":"http"}}	A configuração personalizada, como a configuração de callback. O valor é uma string formatada em JSON. Para mais informações sobre a estrutura, consulte UserData. Nota Para usar o parâmetro MessageCallback, defina uma url de callback HTTP e selecione um tipo de evento de callback no console do ApsaraVideo VOD. Caso contrário, a configuração de callback não entrará em vigor.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
MediaId	String	006204a11bb3*****86bb25491f95f	O ID do vídeo produzido. Nota Esta operação retorna o ID do vídeo produzido de forma síncrona. Se a operação retornar o parâmetro MediaId, a tarefa de produção de vídeo estará sendo processada de forma assíncrona.
ProjectId	String	fb2101bf24b*****4cb318787dc	O ID do projeto de edição online.
RequestId	String	25818875-5F78-4A*****F6-D7393642CA58	O ID da solicitação.

Nota

O ApsaraVideo VOD envia uma notificação de evento FileUploadComplete após a conclusão da produção do vídeo, semelhante à ação realizada após o upload de um vídeo. Depois que o vídeo produzido for transcodificado, o ApsaraVideo VOD enviará as notificações de evento StreamTranscodeComplete e TranscodeComplete.

Exemplos

Exemplos de solicitações

https://vod.{ApiRegion}.aliyuncs.com/?Action=ProduceEditingProjectVideo
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<ProduceEditingProjectVideoResponse>
      <RequestId>25818875-5F78-4A*****F6-D7393642CA58</RequestId>
      <MediaId>006204a11bb3*****86bb25491f95f</MediaId>
      <ProjectId>fb2101bf24b*****4cb318787dc</ProjectId>
</ProduceEditingProjectVideoResponse>

Formato JSON

{
    "RequestId": "25818875-5F78-4A*****F6-D7393642CA58",
    "MediaId": "006204a11bb3*****86bb25491f95f",
    "ProjectId":"fb2101bf24b*****4cb318787dc"
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o Centro de Erros de API.

Exemplos de sdk

Recomendamos usar um sdk de servidor para chamar esta operação. Para mais informações sobre os códigos de exemplo usados para invocar esta operação em várias linguagens, consulte os seguintes tópicos: