Editing and production parameters - Intelligent Media Services: Central de Documentação do Alibaba Cloud

OutputMediaConfig

Configuração do arquivo de mídia. O valor deve estar no formato JSON. Especifique a URL do arquivo de mídia em um bucket do Object Storage Service (OSS) ou o local de armazenamento no ApsaraVideo VOD. Para armazenar o arquivo de mídia no bucket do OSS, especifique o campo MediaURL. Para armazená-lo no ApsaraVideo VOD, defina os campos StorageLocation e FileName.

Campos

Field	Type	Required	Description
MediaURL	String	Obrigatório ao armazenar o arquivo de mídia no bucket do OSS.	URL do arquivo de mídia no bucket do OSS. Exemplo: http://-bucket.oss-cn-shanghai.aliyuncs.com/outputOss.mp4. Nota: Certifique-se de que o bucket do OSS esteja na mesma região do serviço a ser invocado. Não é permitido usar endpoint de aceleração do OSS ou nome de domínio da Content Delivery Network (CDN). Para mais informações sobre os formatos de arquivo compatíveis, consulte Formatos de arquivo compatíveis com edição.
StorageLocation	String	Obrigatório ao armazenar o arquivo de mídia no ApsaraVideo VOD.	Local de armazenamento do arquivo de mídia no ApsaraVideo VOD. O valor não inclui o prefixo http://. Exemplo: outin-xxxxxx.oss-cn-shanghai.aliyuncs.com.
FileName	String	Obrigatório ao armazenar o arquivo de mídia no ApsaraVideo VOD.	Nome do arquivo de mídia no ApsaraVideo VOD. Inclui a extensão do arquivo, mas não o caminho completo. Exemplo: outputVod.mp4.
Video	String	Não	Configurações do vídeo e do fluxo de vídeo de saída. Para mais detalhes, consulte Video.
Width	Integer	Não	Largura do vídeo de saída. Campo opcional. O valor padrão é a maior largura entre os vídeos fornecidos.
Height	Integer	Não	Altura do vídeo de saída. Campo opcional. O valor padrão é a maior altura entre os vídeos fornecidos.
Bitrate	Integer	Não	Taxa de bits do vídeo de saída. Unidade: Kbit/s. Campo opcional. O valor padrão é a maior taxa de bits entre os vídeos fornecidos.
MaxDuration	Float	Não	Duração máxima do vídeo de saída. Unidade: segundos. Para mais informações, consulte Configure o campo MaxDuration.
ProduceTemplateId	String	Não	ID do modelo usado na produção de vídeo, equivalente ao ID do modelo de transcodificação do ApsaraVideo Media Processing (MPS). Este é um campo personalizado para transcodificar o vídeo produzido e processar vídeos customizados em cenários específicos. Crie o modelo de transcodificação no MPS.
VodTemplateGroupId	String	Não	ID do grupo de modelos de transcodificação VOD. Obtenha o ID no console do ApsaraVideo VOD. Se não for necessária transcodificação após a produção, defina este campo como VOD_NO_TRANSCODE. Para mais informações, consulte Modelos de transcodificação.
Endpoint	String	Não	Endpoint do provedor de serviços em nuvem. Obrigatório ao usar o Amazon Simple Storage Service (S3).
Bucket	String	Não	Nome do bucket S3. Obrigatório ao usar o S3.
ObjectKey	String	Não	Nome do objeto. Obrigatório ao usar o S3.
AccessKeyId	String	Não	AccessKey ID temporário obtido do provedor de nuvem. Obrigatório ao usar o S3.
AccessKeySecret	String	Não	AccessKey Secret temporário obtido do provedor de nuvem. Obrigatório ao usar o S3.

Video

Campos do parâmetro OutputMediaConfig que definem as configurações do vídeo e do fluxo de vídeo de saída. A tabela a seguir apresenta exemplos de configuração.

Field	Type	Required	Definition	Description
Fps	Integer	Não	Taxa de quadros do fluxo de vídeo de saída.	Valores válidos: 1 a 60. Valor padrão: 25.
Orientation	String	Não	Modo de orientação de exibição do vídeo.	Valores válidos: Horizontal e Vertical. Horizontal: modo paisagem. Vertical: modo retrato. Se definido como Horizontal, o sistema determina a largura e a altura máximas do vídeo de saída com base no vídeo em paisagem de maior largura. Se definido como Vertical, o sistema determina a largura e a altura máximas do vídeo de saída com base no vídeo em retrato de maior altura. Se os campos Width e Height forem especificados, este campo não terá efeito.
Codec	String	Não	Formato de codificação.	Valores válidos: H.264 e H.265. Valor padrão: H.264.
Profile	String	Não	Perfil de codificação de vídeo.	Valores válidos: baseline, main e high. Valor padrão: high. Nota: Este campo é válido apenas se o campo Codec estiver definido como H.264.
Crf	Integer	Não	Fator de taxa constante.	Valores válidos: 0 a 51. Valor padrão: Se Codec for H.264, o valor padrão é 23. Se Codec for H.265, o valor padrão é 26. Nota: Se os campos Crf e Bitrate forem especificados, o campo Bitrate não terá efeito.
Preset	String	Não	Algoritmo de predefinição de vídeo.	Valores válidos: veryfast, fast, medium, slow e slower. Valor padrão: medium. Nota: Este campo é válido apenas se o campo Codec estiver definido como H.264.

Exemplos

OSS

Para armazenar o arquivo de mídia no bucket do OSS, especifique o campo MediaURL. Os demais campos são opcionais. O campo Bitrate define a taxa de bits do vídeo de saída. Uma taxa de bits maior resulta em um vídeo mais nítido. O valor máximo do campo Bitrate é 5000. Os campos Width e Height definem a resolução do vídeo.

{
 "MediaURL":"https://your-bucket.oss-cn-shanghai.aliyuncs.com/outputOss.mp4",
 "Bitrate": 2000,  
 "Width": 800,  
 "Height": 680
}

A URL do bucket OSS segue o formato https://${bucket}.${oss-region-name}.aliyuncs.com/${fileKey}.

bucket é o nome do bucket OSS e fileKey é o nome do objeto OSS. O nome do objeto OSS inclui o caminho e a extensão do objeto.

oss-region-name.aliyuncs.com é o endpoint público do bucket OSS. O código a seguir mostra os endpoints públicos das regiões China (Shanghai), China (Hangzhou) e China (Beijing):

oss-cn-shanghai.aliyuncs.com
oss-cn-hangzhou.aliyuncs.com 
oss-cn-beijing.aliyuncs.com

VOD

Para armazenar o arquivo de mídia no ApsaraVideo VOD, especifique os campos StorageLocation e FileName. Consulte os locais de armazenamento disponíveis no console do ApsaraVideo VOD.

{ 
  "StorageLocation": "outin-*xxxxxx7d2a3811eb83da00163exxxxxx.oss-cn-shanghai.aliyuncs.com",  
  "FileName": "outputVod.mp4",  
  "Bitrate": 2000,  
  "Width": 800,  
  "Height": 680,
  "VodTemplateGroupId": "VOD_NO_TRANSCODE"
}

Exemplo de configuração do campo Video

Exemplo de configuração do campo Video do parâmetro OutputMediaConfig

{
  "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/outputOss.mp4",
  "Width": 800,
  "Height": 680,
  "Video": {
    "Codec": "H.264",
    "Fps": 50,
    "Profile": "main",
    "Crf": 15
  }
}

ProjectMetadata

Metadados do projeto de edição. O valor deve estar no formato JSON.

Campos

Field	Type	Required	Description
Description	String	No	Descrição do projeto de edição.
Title	String	No	Título do projeto de edição.

Exemplos

{
   "Description": "Description",
   "Title": "Title"
}

EditingProduceConfig

Parâmetro para edição e produção comuns no formato JSON.

Campos

Field	Type	Required	Description
AudioChannelCopy	String	Não	Canal de áudio a ser copiado. Valores válidos: left e right. Se definido como left, o sistema copia os canais de áudio esquerdo e direito do vídeo de saída como o canal de áudio esquerdo do vídeo de entrada. Se definido como right, o sistema copia os canais de áudio esquerdo e direito do vídeo de saída como o canal de áudio direito do vídeo de entrada.
AutoRegisterInputVodMedia	Boolean	Não	Define se os arquivos de mídia do ApsaraVideo VOD na linha do tempo devem ser registrados automaticamente na biblioteca de ativos do Intelligent Media Services (IMS). Valor padrão: true.
AutoRegisterOutputImsMedia	Boolean	Não	Define se o vídeo gerado após a edição e produção deve ser registrado automaticamente na biblioteca de ativos do IMS. Valor padrão: true.
OutputWebmTransparentChannel	Boolean	Não	Define se o vídeo deve ser exportado com canal alfa no formato WebM. Valor padrão: false. Para exportar o vídeo com canal alfa no formato WebM, certifique-se de que o campo MediaURL ou FileName do parâmetro OutputMediaConfig termine com webm e que apenas o Scale Effect esteja disponível na linha do tempo. Caso contrário, o vídeo será exportado por padrão no formato MP4 sem canal alfa.
CoverConfig	JSON	Não	Configuração da miniatura. Use um quadro do vídeo como miniatura. A miniatura é salva como imagem e armazenada no bucket OSS. Não é possível usar a miniatura para modifique o primeiro quadro do vídeo. Chame a operação GetMediaInfo para visualize a URL da miniatura. StartTime: ponto exato da miniatura no vídeo. O valor pode ter até quatro casas decimais. Unidade: segundos.
InputMediaRegisterConfig	JSON	Não	Define se os arquivos de mídia devem ser salvos automaticamente como ativos de mídia caso a linha do tempo contenha URLs. Valores válidos: NeedSnapshot NeedSprite SearchLibName
SearchLibName	String	Não	Especifique uma biblioteca de busca personalizada para o vídeo renderizado final. Após a conclusão da edição e composição, defina este campo se o ativo de vídeo registrado automaticamente precisar ser importado para uma biblioteca de busca personalizada. Para mais informações, consulte Usar bibliotecas de busca autogerenciadas.
NeedSnapshot	Boolean	Não	Define se snapshots devem ser capturados automaticamente para o arquivo de mídia. Valor padrão: true.
NeedSprite	Boolean	Não	Define se snapshots devem ser usados para gerar um sprite para o arquivo de mídia. Valor padrão: true.
PipelineId	String	Não	ID do pipeline personalizado. Especifique este campo conforme seus requisitos de negócio. Quando várias linhas de negócio usam a mesma conta Alibaba Cloud para envie tarefas, use este campo para distinguir as tarefas de diferentes linhas de negócio. Se tiver requisitos específicos, abra um ticket.
MaxBitrate	Integer	Não	Taxa de bits máxima do vídeo de saída. Especifique este campo conforme seus requisitos de negócio. Se este campo for especificado e a taxa de bits do vídeo de entrada for maior que o valor deste campo, o sistema usará o valor deste campo como a taxa de bits do vídeo de saída. Se este campo não for especificado, a taxa de bits máxima do vídeo de saída será 5.000 por padrão.
KeepOriginMaxBitrate	Boolean	Não	Define se a taxa de bits máxima do arquivo de source deve ser usada para o vídeo de saída. Valor padrão: false. Se definido como true, o sistema usa a taxa de bits máxima do arquivo de source para o vídeo de saída. A taxa de bits máxima do vídeo de saída é 50.000.
KeepOriginVideoMaxFps	Boolean	Não	Define se a taxa de quadros máxima do arquivo de source deve ser usada para o vídeo de saída. Valor padrão: false. Se definido como true, o sistema usa a taxa de quadros máxima do arquivo de source para o vídeo de saída.

Exemplos

{
	"AutoRegisterInputVodMedia": true,
	"OutputWebmTransparentChannel": true,
	"CoverConfig": {
		"StartTime": 3.3
	},
	"AudioChannelCopy": "left",
	"PipelineId": "xxxd54a97cff4108b555b01166d4bxxx",
	"MaxBitrate": 5000,
	"KeepOriginMaxBitrate": false,
	"KeepOriginVideoMaxFps": false
}

MediaMetadata

Metadados do arquivo de mídia gerado após a edição. O valor deve estar no formato JSON.

Campos

Field	Type	Required	Description
Title	String	Não	Título do arquivo de mídia. O título pode ter até 128 bytes. O título deve ser codificado em UTF-8.
Description	String	Não	Descrição do arquivo de mídia. A descrição pode ter até 1.024 bytes. O valor deve ser codificado em UTF-8.
Tags	String	Não	Tag do arquivo de mídia. É possível especificar até 16 tags. Separe várias tags com vírgulas (,). Cada tag pode ter até 32 bytes. O valor deve ser codificado em UTF-8.
CateId	Long	Não	ID da categoria do arquivo de mídia.
CustomMetadata	String	Não	Metadados personalizados fornecidos como string JSON. Exemplo: {"key1": "value1", "dict1": {"key2": "value2", "key3": "value3"}} O vídeo de saída contém os metadados.

UserData

Dados do usuário no formato JSON. Ao envie uma tarefa de produção, adicione dados do usuário ao parâmetro UserData. Se a URL de callback da tarefa de produção estiver configurada, o sistema envia uma solicitação de callback para a URL após a conclusão da produção, e a solicitação contém o parâmetro UserData. O valor deste parâmetro pode ter até 1.024 bytes.

Para facilitar, passe a configuração de callback para o parâmetro UserData. Para mais informações, consulte a prática recomendada Configure callbacks para trabalhos de edição concluídos.

A tabela a seguir descreve o campo reservado no parâmetro UserData.

Campo reservado

Field

Type

Required

Description

NotifyAddress

String

Não

URL de callback. São suportados callbacks HTTP e callbacks do Alibaba Cloud Message Service (MNS).

Exemplo de callback HTTP: http://yourdomain.com/callback.

Exemplo de callback MNS: ice-callback-test. O nome da fila MNS deve começar com ice-callback.