Subtítulos en directo — React Native

Utiliza la API de subtítulos en directo de OpenTok para habilitar los subtítulos de audio en tiempo real de los emisores y los suscriptores conectados a una sesión de OpenTok.

Los subtítulos en directo deben activarse a nivel de sesión a través de la opción API REST.

Los subtítulos en directo sólo se admiten en sesión enrutada.

Este tema incluye las siguientes secciones:

Publicación de subtítulos en directo

Para activar los subtítulos en directo, inicializa el OTPublisher componente con el valor booleano opcional publishCaptions propiedad del properties prop establecido en true:

<OTPublisher
  style={{width: 400, height: 300}}
  properties={{
    publishCaptions: true,
    // ... other properties
  }}
/>

Este ajuste es false por defecto.

Puedes modificar dinámicamente esta propiedad (en función de un cambio en el estado de React) para activar o desactivar los subtítulos de la retransmisión publicada.

Suscribirse a los subtítulos en directo

Para empezar a recibir subtítulos, configura el subscribeToCaptions propiedad del properties puntal del OTSubscriber componente:

<OTSubscriber
  style={{width: 200, height: 200}}
  properties={{
    subscribeToCaptions: true,
    // ... other properties
  }}
  eventHandlers={{
    captionReceived: event => {
      console.log('Caption received:', event.text);
      console.log('Caption final:', event.isFinal);
    },
  }}
/>

Puede ajustar el subscribeToCaptions propiedad a true independientemente de si el cliente que publica el flujo está publicando actualmente subtítulos en directo. El suscriptor comenzará a recibir datos de subtítulos una vez que el editor comience a publicar subtítulos.

Los suscriptores reciben los subtítulos a través de la captionReceived (mostrado arriba).

El captionReceived El objeto «event» tiene dos propiedades:

  • text — El texto del pie de foto (una cadena de caracteres)
  • isFinal — Si el texto de la leyenda es definitivo para una frase (true) o parcial (false).

El SDK de OpenTok para React Native no muestra el texto de los eventos de subtítulos. Puedes crear tu propio elemento de interfaz de usuario para mostrar el texto de los subtítulos basándote en los eventos de subtítulos.

Cómo recibir tus propios subtítulos en directo

El Client SDK del cliente web de Vonage no permite que un emisor reciba eventos relacionados con sus propios subtítulos. Para mostrar los subtítulos de una transmisión publicada por el cliente local, crea un suscriptor oculto (de la transmisión del emisor local) para que escuche los eventos de subtítulos. Configura el subscribeToSelf propiedad del OTSubscriber a true. No debe renderizar el vídeo de este abonado (configurando su width y height a 0) y no debe suscribirse al audio (para evitar el eco, configurando subscribeToAudio a false). Puedes añadir los subtítulos a la interfaz de usuario, igual que harías con los subtítulos de otras transmisiones. Consulta Representación personalizada de los abonados.