SubmitLiveEditingJob - Intelligent Media Services: Central de Documentação do Alibaba Cloud

Descrição da operação

Esta é uma API assíncrona. Ao enviar um trabalho, o sistema retorna um JobId antes da conclusão do trabalho. O trabalho é então enfileirado para processamento assíncrono. Você receberá uma notificação de callback quando o trabalho for concluído. Alternativamente, você pode consultar o status do trabalho chamando a operação GetLiveEditingJob.
Você pode editar transmissões ao vivo que são gravadas no OSS ou no VOD. Ao editar várias transmissões ao vivo juntas, todas as transmissões devem ser gravadas no mesmo serviço, todas no OSS ou todas no VOD.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ice:SubmitLiveEditingJob

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Clips	string	Sim	Uma matriz JSON que especifica os clipes a serem editados. O trabalho cria o arquivo de saída concatenando esses clipes na ordem especificada. Cada clipe inclui um horário de início e de fim. Se os parâmetros de transmissão ao vivo não forem especificados para um clipe, o sistema usará as configurações globais de LiveStreamConfig. Os carimbos de data e hora de início e fim devem estar em UTC. Para mais detalhes, consulte a estrutura de dados Clip abaixo.	[{\"StartTime\": \" 2021-06-21T08:01:00Z\", \"EndTime\": \" 2021-06-21T08:03:00Z\" , "AppName": "app", "DomainName": "domain.com", "StreamName": "stream"}, {\"StartTime\": \" 2021-06-21T08:05:00Z\", \"EndTime\": \" 2021-06-21T08:09:00Z\" }]
ProjectId	string	Não	O ID do projeto de edição ao vivo. Se você especificar este parâmetro, o sistema usará as configurações de armazenamento do projeto. Se deixado em branco, o sistema usará as configurações de armazenamento fornecidas na solicitação.	**fddd7748b58bf1d47e95**
LiveStreamConfig	string	Não	A configuração da transmissão ao vivo de origem, especificada como um objeto JSON. Inclui os seguintes parâmetros: AppName: O nome do aplicativo ao qual a transmissão pertence. DomainName: O nome de domínio da transmissão. StreamName: O nome da transmissão ao vivo.	{ "AppName": "app", "DomainName": "domain.com", "StreamName": "stream" }
OutputMediaConfig	string	Não	A configuração de destino para o arquivo de saída, especificada como um objeto JSON. Você pode especificar uma URL no OSS ou um local de armazenamento em um bucket do VOD. Para saída no OSS, o parâmetro MediaURL é obrigatório. Para saída no VOD, os parâmetros StorageLocation e FileName são obrigatórios.	{ "MediaURL": "https://ice-auto-test.oss-cn-shanghai.aliyuncs.com/testfile.mp4" }, or { "StorageLocation": "bucket.oss-cn-shanghai.aliyuncs.com", "FileName": "output.mp4" }
MediaProduceConfig	string	Não	A configuração de produção para o arquivo de saída, especificada como um objeto JSON. O parâmetro Mode especifica o modo de edição. Os valores válidos são: AccurateFast (Padrão): Edição rápida e precisa. Oferece processamento mais rápido em comparação com o modo Accurate. O arquivo de saída tem a mesma resolução da transmissão de origem. Você não pode especificar uma largura e altura personalizadas para o arquivo de saída. Accurate: Edição precisa. Este modo permite especificar uma largura e altura personalizadas para o arquivo de saída. Rough: Edição aproximada com precisão de um único segmento TS. O arquivo de saída inclui todos os segmentos entre os horários de início e fim especificados. Você pode especificar uma largura e altura personalizadas para o arquivo de saída. RoughFast: Edição de corte aproximado rápida, que é mais rápida que o modo Accurate. Tem precisão de um único segmento TS, e o arquivo de saída inclui todos os segmentos entre os horários de início e fim especificados. O arquivo de saída tem a mesma resolução da transmissão de origem. Você não pode especificar uma largura e altura personalizadas para o arquivo de saída.	{ "Mode": "AccurateFast"}
UserData	string	Não	Dados personalizados do usuário, fornecidos como um objeto JSON. O comprimento máximo é de 512 bytes.	{"key": "value"}
OutputMediaTarget	string	Não	O tipo de destino para o arquivo de saída. Valores válidos: oss-object: Um objeto em um bucket do Alibaba Cloud OSS. vod-media: Um ativo de mídia no Alibaba Cloud VOD.	oss-object

Estrutura de dados do clipe

Parâmetro	Tipo	Exemplo	Descrição	Obrigatório
StartTime	String	2021-06-21T08:01:00Z	O horário de início do clipe, no formato UTC.	Sim
EndTime	String	2021-06-21T08:05:00Z	O horário de término do clipe, no formato UTC.	Sim
AppName	String	app	O nome da aplicação à qual a transmissão pertence. Se não for especificado, o sistema usará as configurações globais de `LiveStreamConfig`.	Não
DomainName	String	domain.com	O nome de domínio da transmissão. Se não for especificado, o sistema usará as configurações globais de `LiveStreamConfig`.	Não
StreamName	String	stream	O nome da transmissão ao vivo. Se não for especificado, o sistema usará as configurações globais de `LiveStreamConfig`.	Não
CoverTime	String	2021-06-21T08:03:00Z	Especifica um carimbo de data e hora dentro do clipe a ser usado para gerar uma imagem de capa para o arquivo de saída. O horário deve estar no formato UTC. Se vários clipes tiverem `CoverTime` definido, o sistema usará apenas o primeiro. O `CoverTime` deve ser maior ou igual a `StartTime` e menor ou igual a `EndTime`.	Não
CoverUrl	String	https://test.oss-cn-shanghai.aliyuncs.com/cover.jpg	A URL personalizada para a captura de tela de saída. O bucket do OSS deve estar na mesma região do serviço. Apenas buckets do OSS autogerenciados são suportados; buckets gerenciados pelo VOD não são suportados.	Não

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O objeto de resposta.
RequestId	string	O ID da solicitação.	**36-3C1E-4417-BDB2-1E034F**
ProjectId	string	O ID do projeto de edição ao vivo.	**fddd7748b58bf1d47e95**
JobId	string	O ID do trabalho de edição ao vivo.	**d80e4e4044975745c14b**
MediaId	string	O ID do ativo de mídia de saída.	**c469e944b5a856828dc2**
MediaURL	string	A URL do arquivo de saída.	http://test-bucket.cn-shanghai.aliyuncs.com/test.mp4
VodMediaId	string	O ID do ativo de mídia do VOD. Este parâmetro é retornado apenas se o destino de saída for o VOD.	**d7578s4h75ci945c14b**

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "****36-3C1E-4417-BDB2-1E034F****",
  "ProjectId": "****fddd7748b58bf1d47e95****",
  "JobId": "****d80e4e4044975745c14b****",
  "MediaId": "****c469e944b5a856828dc2****",
  "MediaURL": "http://test-bucket.cn-shanghai.aliyuncs.com/test.mp4",
  "VodMediaId": "****d7578s4h75ci945c14b****"
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.