Use estes parâmetros e exemplos de SDK para gerar vídeos de melhores momentos de eventos esportivos.
A região na URL do OSS deve corresponder à região do endpoint da API. Apenas a região China (Shanghai) é compatível.
Leia primeiro Produção de vídeo em lote para obter uma visão geral dos parâmetros e do fluxo de trabalho.
Observações de uso
Para gerar um clipe de melhores momentos a partir do vídeo completo de uma partida, chame a API SubmitSportsHighlightsJob. Os principais parâmetros estão descritos em InputConfig e OutputConfig abaixo.
Para obter detalhes de uma tarefa de geração de vídeo, chame a API GetBatchMediaProducingJob.
InputConfig
Especifica os materiais de source e as opções de processamento.
|
Parâmetro |
Tipo |
Descrição |
Exemplo |
Obrigatório |
|
SportsCategory |
String |
Tipo de evento esportivo. Valores válidos:
|
basketball |
Sim |
|
InputMedia |
String |
Vídeo de source. Especifique um ID de ativo de mídia ou uma URL de mídia.
|
**9d46c8b4548681030f6e** |
Sim |
|
FaceRegister |
List<FaceInfo> |
Configurações de registro facial. Máximo de 5 entradas. |
Não |
|
|
SlowMotionLogoRegister |
Logotipos que antecedem cenas em câmera lenta no vídeo de source. Necessário para incluir tomadas em câmera lenta nos melhores momentos. Máximo de 5 entradas. |
Não |
||
|
TransferNameRegister |
List<TransferNameInfo> |
Mapeia nomes abreviados do placar para nomes completos de equipes ou jogadores. Máximo de 10 entradas. |
Sim |
FaceInfo
|
Campo |
Tipo |
Descrição |
Exemplo |
Obrigatório |
|
FaceUrls |
List<String> |
|
["http://[your-bucket].oss-[your-region-id].aliyuncs.com/test1.png","http://[your-bucket].oss-[your-region-id].aliyuncs.com/test1.png"] |
Sim |
|
Name |
String |
Nome da pessoa. Deve corresponder ao nome exibido no placar do vídeo de entrada. |
John Doe |
Sim |
SlowMotionLogoRegister
|
Campo |
Tipo |
Descrição |
Exemplo |
Obrigatório |
|
SlowMotionLogoUrls |
List<String> |
|
["http://[your-bucket].oss-[your-region-id].aliyuncs.com/test1.png","http://[your-bucket].oss-[your-region-id].aliyuncs.com/test1.png"] |
Sim |
TransferNameInfo
|
Campo |
Tipo |
Descrição |
Exemplo |
Obrigatório |
|
OriginalName |
String |
Nome abreviado do placar. |
Rockets |
Sim |
|
TransferName |
String |
Nome completo. |
Houston Rockets |
Sim |
Exemplo de parâmetro
{
"SportsCategory": "basketball",
"InputMedia": "http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-path]/[your-file-name].mp4",
"FaceRegister": [
{
"FaceUrls": ["http://testcdn.com/front.jpg", "http://testcdn.com/side.jpg"],
"Name": "James"
}
],
"SlowMotionLogoRegister": {
"SlowMotionLogoUrls": ["http://testcdn.com/logo1.jpg", "http://testcdn.com/logo2.jpg"]
},
"TransferNameRegister": [
{
"OriginalName": "IND",
"TransferName": "Indiana Pacers"
}
]
}
EditingConfig
Sem suporte no momento.
OutputConfig
Define as configurações do vídeo de saída: destino, nomenclatura de arquivo, dimensões e quantidade de vídeos.
|
Parâmetro |
Tipo |
Descrição |
Exemplo |
Obrigatório |
|
MediaURL |
String |
URL do vídeo de saída. Deve incluir o placeholder |
Formato: http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-path]/[your-file-name]_{index}.mp4 Exemplo: http://example.oss-cn-shanghai.aliyuncs.com/example/example_{index}.mp4 |
Obrigatório quando GeneratePreviewOnly é falso e o destino de saída é o OSS. |
|
StorageLocation |
String |
Local de armazenamento do arquivo de saída no ApsaraVideo VOD. |
Formato: [your-vod-bucket].oss-[your-region-id].aliyuncs.com Exemplo: outin-**6c886b4549d481030f6e**.oss-cn-shanghai.aliyuncs.com |
Obrigatório quando GeneratePreviewOnly é falso e o destino de saída é o ApsaraVideo VOD. |
|
FileName |
String |
Nome do arquivo de saída. Deve conter o placeholder {index}. |
Formato: [your-file-name]_{index}.mp4 Exemplo: example_{index}.mp4 |
Obrigatório quando GeneratePreviewOnly é falso e o destino de saída é o ApsaraVideo VOD. |
|
GeneratePreviewOnly |
Boolean |
|
false |
Não. O valor padrão é false. |
|
Count |
Integer |
Quantidade de vídeos de saída. Atualmente, apenas 1 é compatível. |
1 |
Não. O valor padrão é 1. |
|
Width |
Integer |
Largura do vídeo de saída, em pixels. |
1080 |
Sim |
|
Height |
Integer |
Altura do vídeo de saída, em pixels. |
1920 |
Sim |
|
JSONObject |
Configurações do fluxo de vídeo de saída, como CRF e codec. |
{"Crf": 27} |
Não |
Exemplo de parâmetro
{
"MediaURL": "http://[your-bucket].oss-[your-region-id].aliyuncs.com/xxx_{index}.mp4",
"Count": 1,
"Width": 1080,
"Height": 1920,
"Video": {"Crf": 27},
"GeneratePreviewOnly": false
}
Exemplo de SDK
Pré-requisito
SDK do lado do servidor do IMS instalado. Para mais informações, consulte Introdução.
Exemplo de código
Parâmetros de solicitação da API
Lógica de processamento
SportsCategorydefine o tipo de evento:basketballoupingpong.FaceRegisteridentifica tomadas de atletas específicos para os melhores momentos.SlowMotionLogoRegisterfornece logotipos para detectar replays em câmera lenta no vídeo de source.TransferNameRegistermapeia nomes abreviados do placar para nomes completos das equipes.
Referência da API
Para enviar uma tarefa de melhores momentos esportivos, consulte SubmitSportsHighlightsJob.
Para recuperar detalhes de uma tarefa de produção de vídeo em lote, consulte GetBatchMediaProducingJob.
Para configurar o SDK do lado do servidor, consulte Introdução.
Para enviar uma tarefa de edição e produção de mídia, consulte SubmitMediaProducingJob.