Live-Untertitel — React Native

Verwenden Sie die OpenTok-API für Live-Untertitel, um die Audio-Untertitelung in Echtzeit für die an einer OpenTok-Sitzung teilnehmenden Sender und Empfänger zu aktivieren.

Die Live-Untertitelung muss auf Sitzungsebene über die Option REST-API.

Live-Untertitelung wird nur unterstützt in weitergeleitete Sitzung.

Dieses Thema umfasst die folgenden Abschnitte:

Veröffentlichung von Live-Beschriftungen

Um Live-Untertitel zu aktivieren, initialisieren Sie die OTPublisher Komponente mit dem optionalen booleschen Wert publishCaptions Eigenschaft der properties prop auf true:

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

Diese Einstellung ist false standardmäßig.

Sie können diese Eigenschaft dynamisch ändern (basierend auf einer Änderung des React-Zustands), um die Untertitel für den veröffentlichten Stream ein- und auszublenden.

Abonnieren von Live-Untertiteln

Um Untertitel zu erhalten, stellen Sie die subscribeToCaptions Eigenschaft der properties Stütze des OTSubscriber Komponente:

<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);
    },
  }}
/>

Sie können die subscribeToCaptions Eigenschaft zu true unabhängig davon, ob der Client, der den Stream veröffentlicht, gerade Live-Untertitel veröffentlicht. Der Abonnent erhält die Untertiteldaten, sobald der Herausgeber mit der Veröffentlichung der Untertitel beginnt.

Die Abonnenten erhalten die Untertitel über die captionReceived Ereignishandler (siehe oben).

Die captionReceived Das Ereignisobjekt verfügt über zwei Eigenschaften:

  • text - Der Text der Beschriftung (eine Zeichenkette)
  • isFinal - ob der Überschriftentext für eine Phrase endgültig ist (true) oder teilweise (false).

Das OpenTok React Native SDK zeigt den Text der Untertitel-Ereignisse nicht an. Sie können ein eigenes UI-Element erstellen, um den Untertiteltext auf der Grundlage der Untertitel-Ereignisse darzustellen.

Eigene Live-Titel empfangen

Das Vonage Client SDK unterstützt es nicht, dass ein Publisher Ereignisse für seine eigenen Untertitel empfängt. Um Untertitel für einen vom lokalen Client veröffentlichten Stream darzustellen, erstellen Sie einen versteckten Subscriber (für den Stream des lokalen Publishers), der auf die Untertitel-Ereignisse wartet. Setzen Sie die subscribeToSelf Eigenschaft der OTSubscriber zu true. Sie sollten das Video dieses Abonnenten nicht wiedergeben (indem Sie seine width und height auf 0 setzen) und Sie sollten kein Audio abonnieren (um ein Echo zu vermeiden, setzen Sie subscribeToAudio zu false). Sie können die Untertitel zur Benutzeroberfläche hinzufügen, genau wie bei den Untertiteln anderer Streams. Siehe Benutzerdefiniertes Rendering von Abonnenten.