ApsaraVideo Live:Legendas em tempo real (versão prévia pública)

Instruções do console

1. Faça login no console do ApsaraVideo Live.

2. No painel de navegação à esquerda, escolha Feature Management > Real-time Subtitles, acesse a página Real-time Subtitles e selecione uma guia.

3. Selecione a região para a configuração do seu modelo de legenda. Em seguida, clique em Add Subtitle Template para configurar o modelo. Na página Add Subtitle Template, seção Basic Information, selecione o Creation Method (Create New Subtitle Template ou Copy Existing Subtitle Template). Em seguida, insira um Subtitle Template Name (permitidos apenas dígitos, letras e hifens) e uma Template Description (até 128 caracteres). Na seção Subtitle Settings, configure Language, Translation, Maximum Lines, Max Characters per Line e Font. Use o painel Preview à direita para visualizar suas alterações.

Visualize as legendas na área de visualização. Ajuste o tamanho da tela de visualização, o tamanho da legenda e a posição para ver os efeitos em tempo real. A tabela a seguir lista os parâmetros do modelo de legenda e suas descrições.

5. Clique em Submit para concluir a configuração do modelo de legenda.

6. Após adicionar um modelo de legenda com sucesso, uma mensagem solicitará que você adicione uma regra de legenda. Clique em Add Now para criar uma regra para este modelo. Se não precisar adicionar uma regra agora, clique em Later e configure-a posteriormente.

7. Na guia Subtitle Templates, localize seu modelo na lista. Na coluna Actions, clique em Preview, Modify ou Delete e gerencie o modelo:

   Ação	Descrição
   Preview	Visualize o efeito real das legendas.
   Modify	Ajuste os parâmetros do modelo de legenda.
   Delete	Na página da lista de modelos de legenda, se Bound Caption Rules exibir 0, o modelo não possui regras associadas. Clique em Delete para remover o modelo. Se Bound Caption Rules exibir um número maior que 0, o modelo já está vinculado a regras e o botão Delete ficará indisponível (acinzentado). Exclua todas as regras de legenda associadas antes de excluir o modelo. Clique no número em Bound Caption Rules para visualizar as regras associadas.
   Add Subtitle Rule	Adicione uma regra de legenda para este modelo e configure os parâmetros relacionados. Para obter detalhes, consulte Step 2: Add a Subtitle Rule.

   Nota

   Modificar ou excluir um modelo de legenda não afeta as transmissões ao vivo em andamento. As alterações entram em vigor somente após reiniciar a ingestão do stream.

Instruções da API

Utilize as seguintes APIs para configuração:

Instruções do console

1. Faça login no console do ApsaraVideo Live.

2. No painel de navegação à esquerda, escolha Feature Management > Real-time Subtitles, acesse a página Real-time Subtitles e selecione a guia Subtitle Rules.

3. Selecione a região para a configuração da sua regra de legenda. Após selecionar uma região, só é possível configurar nomes de domínio e modelos de legenda dentro dessa região. Em seguida, clique em Add Subtitle Rule. Na página de configuração, insira uma Rule Description e selecione um Streaming Domain. Insira um AppName (até 256 caracteres; aceita dígitos, letras, hifens e sublinhados) e selecione Subtitle Templates (clique em Preview para visualizar o efeito). Escolha Output Settings (a proporção de tela de saída deve corresponder à proporção do modelo) e ative ou desative a opção Triggered by Stream Pulling conforme necessário. Por fim, clique em Submit.

A tabela a seguir lista os parâmetros da regra de legenda e suas descrições.

Parâmetro	Descrição
Rule Description	Descrição da regra de legenda. Aceita chinês, inglês, dígitos e símbolos. Comprimento máximo: 128 caracteres.
Streaming Domain	Selecione o domínio de transmissão principal a ser configurado.
AppName	Nome do aplicativo ao qual o stream pertence. O AppName deve corresponder exatamente ao AppName na sua URL de ingestão para que o modelo de legenda tenha efeito. Aceita dígitos, letras maiúsculas e minúsculas, hifens (-) e sublinhados (_). Comprimento máximo: 256 caracteres.
Subtitle Templates	Selecione um modelo de legenda configurado. Se não houver modelos, adicione um primeiro. Para obter detalhes, consulte Step 1: Add a Subtitle Template.
Output Settings	Recomendamos que a configuração de saída na regra de legenda corresponda ao tamanho da tela do modelo de legenda para garantir uma reprodução precisa. Especificações de saída compatíveis: Landscape Low Definition 360P 640×360 Portrait Low Definition 360P 360×640 Landscape Standard Definition 480P 854×480 Portrait Standard Definition 480P 480×854 Landscape High Definition 720P 1280×720 Portrait High Definition 720P 720×1280 Landscape Ultra-High Definition 1080P 1920×1080 Portrait Ultra-High Definition 1080P 1080×1920
Triggered by Stream Pulling	Como os streams de legendas são acionados. Quando ativado: as legendas iniciam somente quando alguém reproduz a transmissão ao vivo. Se ninguém reproduzir o stream por 5 minutos, as legendas param e só reiniciam quando a reprodução for retomada. Quando desativado: as legendas iniciam assim que a ingestão do stream começa, independentemente de haver alguém assistindo.

5. Clique em Submit para concluir a configuração da regra de legenda.

   Nota

   Após configurar uma regra de legenda com sucesso, reinicie a ingestão do stream para que as legendas apareçam na reprodução.

6. Na guia Subtitle Rules, localize sua regra na lista. Na coluna Actions, clique em Preview, Edit ou Delete:

   • Preview: visualize o efeito real das legendas.

   • Edit: ajuste os parâmetros da regra de legenda.

   • Delete: exclua a regra de legenda.

Instruções da API

Utilize as seguintes APIs para configuração: