Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/ Meeting/ Referência de API do servidor/ Envio por push de evento de reunião/ Push de evento em nível de reunião/ APIs/ Envio por push de legendas ao vivo
Atualizado em 2023-08-02 GMT+08:00
Ver PDF

Envio por push de legendas ao vivo

Descrição

Qualquer pessoa em uma reunião pode usar esta API para ativar legendas ao vivo da reunião pela primeira vez. Quando as legendas ao vivo estão ativadas, todos na reunião podem se inscrever no quadro de mensagem para enviar legendas ao vivo.

As legendas ao vivo só são interrompidas quando a reunião termina.

Tabela 1 Texto de solicitação

Parâmetro

Tipo

Descrição

action

String

Tipo de mensagem. O valor deve ser ConfControl.

sequence

String

Sequência de mensagens, que identifica exclusivamente um quadro de mensagem.

type

String

Tipo de controle de reunião. O valor deve ser REALTIMESUBTITLE.

data

String

Para obter detalhes sobre a cadeia de caracteres JSON de solicitação, consulte Tabela 2.
Tabela 2 Estrutura de dados data

Parâmetro

Obrigatório

Tipo

Descrição

conferenceID

Sim

String

ID da reunião.

confToken

Sim

String

Token de controle de reunião.

isSubtitle

Não

Integer

0: desativar legendas ao vivo

1: ativar legendas ao vivo

subtitleType

Não

Integer

Modo de exibição de legenda.

0: legendas dos dois falantes mais altos.

sisProperty

Não

String

Modelo utilizado.

chinese_16k_general: chinês mandarim (padrão).

chinese_16k_trial: modo de teste.

id

Não

Array of strings

Esse parâmetro é obrigatório quando legendas de falantes específicos são exibidas. Lista de IDs de falante (pid em Envio por push de informações on-line do participante). Até quatro falantes são suportados.
Tabela 3 Quadro de mensagem para enviar legendas ao vivo

Parâmetro

Tipo

Descrição

action

String

"RealTimeSubtitleNotify"

version

String

Para uma mensagem completa, o valor é o carimbo de data/hora (em milissegundos) quando a mensagem é gerada.

Para uma mensagem incremental, o valor é um número de sequência em ordem crescente.

createTime

String

Carimbo de data/hora quando uma mensagem é gerada, em milissegundos.

msgID

String

ID de mensagem único.

msgMode

Integer

Modo da mensagem.

0: mensagem completa.

1: mensagem incremental.

confID

String

ID da reunião subscrita.

data

SubtitleData object

Informações da legenda ao vivo. O conteúdo é negociado entre o serviço de legenda ao vivo e o terminal. Para obter detalhes, consulte a estrutura de dados SubtitleData.
Tabela 4 Estrutura de dados SubtitleData

Parâmetro

Tipo

Descrição

msgs

Msgs<0..*>

Conteúdo da legenda. Para mais detalhes, consulte Tabela 5.

isFinal

Boolean

Seja para quebrar uma frase.

timestamp

Integer

Carimbo de data/hora.

beginTime

Integer

Hora de início da legenda.

endTime

Integer

Tempo de fim da legenda.

participantID

String

ID do participante.
Tabela 5 Estrutura de dados Msgs

Parâmetro

Tipo

Descrição

subtitleLang

String

Idioma.

Mandarim

Inglês

translateText

String

Texto da legenda.

id

String

ID da mensagem da legenda.

Exemplo de ativação de legendas ao vivo

var openRealTimeSubtitle = JSON.stringify({
    sequence: "000000000000000002611382273463",
    action: "ConfControl",
    type: "REALTIMESUBTITLE",
    data: JSON.stringify({
        conferenceID: "986812232",
        confToken: "Basic Y25yZWEzOWY5N2ZhNjZlZTc2M2JiY2E1ZWE1NjVhNTI0ODJhODgwODQ3ZDFjOWUxMGJk",
        isSubtitle: "1",
        subtitleType: "0"
    }),
 });

Exemplo de envio por push de legendas ao vivo

{
	"action": "RealTimeSubtitleNotify",
	"version": "1614936396556",
	"createTime": "1614936396556",
	"msgID": "e20544e37d9411ebbae3fd5b302953d3",
	"msgMode": 0,
	"confID": "981112355",
	"data": {
		"msgs ": [{
			"subtitleLang": "Mandarin",
			"translateText": "Live captions.",
			"id ": "c0196fb9-c9c3-47ba-a685-05223552de2f"
		}],
		"isFinal ": false,
		"timestamp ": 1614936396553,
		"beginTime": 1528680,
		"endTime": 1530900,
		"participantID": "984r8z9f4p6p6pry97yfan6z76681f09"
	}
}
Tópico principal: APIs