IP-Proxy

Mit der IP-Proxy-Funktion leiten OpenTok-Clients den gesamten Internetverkehr (mit Ausnahme von Medien-Streams) über Ihren Proxy-Server weiter.

Zum Nicht-Medien-Datenverkehr gehören die Kommunikation mit den Video API-Servern und die Protokollierungsinfrastruktur.

Die IP-Proxy-Funktion ist verfügbar als ein zusätzliches Merkmal.

Außerdem gibt es eine konfigurierbarer TURN-Server Zusatzfunktion, mit der Sie Medienströme über Ihre eigenen, benutzerdefinierten TURN-Server weiterleiten können.

Konfigurieren des IP-Proxy-Servers

Sie legen die URL oder Ihren Proxy-Server fest, wenn Sie eine OpenTok-Sitzung in den OpenTok-Client-SDKs starten.

OpenTok fügt die Ziel-URL für den gesamten Internetverkehr (mit Ausnahme von Medien- Streams) an die von Ihnen angegebene Proxy-URL an. Dieser Datenverkehr umfasst Video API-Aufrufe, WebSocket-Verbindungen sowie den von OpenTok.js erzeugten Protokollverkehr.

Beispielsweise protokolliert das OpenTok-Client SDK regelmäßig Daten in https://video-log-host.example.com/prod/logging/ClientEvent. Wenn Sie die Proxy-URL auf "https://123.123.123.123:8080", wird der Client diese Daten an https://123.123.123.123:8080/video-log-host.example.com/prod/logging/ClientEvent.

Sie sollten den Proxy-Server so absichern, dass er ausschließlich von OpenTok-Clients und nicht von unbefugten Clients genutzt wird. Sie können den Proxy-Server beispielsweise hinter einer Firewall betreiben oder Anfragen auf andere Weise authentifizieren.

Hier ist ein Beispielcode, mit dem ein einfacher Proxy-Server für diese Funktion eingerichtet wird: einfacher_Reverse-Proxy.

Anmerkung: Falls sich Clients in einer anderen geografischen Region als der Ihres Proxy-Servers mit OpenTok-Sitzungen verbinden und Sie nicht die Konfigurierbare TURN-Server-Funktion, achten Sie darauf, den Standort-Hinweis festzulegen, wenn Sie OpenTok-Sitzungen erstellen.

In OpenTok.js

Rufen Sie die OT.setProxyUrl() Methode, um die URL des Proxy-Servers festzulegen:

OT.setProxyUrl('https://123.123.123.123:8080');

Sie müssen diese Methode aufrufen, bevor Sie andere OpenTok-Methoden aufrufen. Dadurch wird sichergestellt, dass der Proxy-Server für den OpenTok-Datenverkehr verwendet wird.

Anmerkung: Diese Methode wurde in OpenTok 2.17.4 als undokumentierte Methode hinzugefügt. In früheren Versionen haben Sie die URL des Proxy-Servers mithilfe einer undokumentierten Option festgelegt, wenn Sie die OT.initSession() Methode. Diese Option ist jedoch mittlerweile veraltet und wurde durch die OT.setProxyUrl() Methode.

Im OpenTok Android SDK

Legen Sie die URL des Proxyservers fest, indem Sie die Funktion setProxyUrl() Methode der Session.Builder Objekt, das Sie zur Instanziierung eines Session-Objekts verwenden:

mSession = new Session.Builder(context, API_KEY, SESSION_ID)
  .setProxyUrl("https://123.123.123.123:8080")
  .build();

Im OpenTok iOS SDK

Legen Sie die URL des Proxyservers fest, indem Sie die Option proxyURL Eigenschaft der OTSessionSettings Objekt, das Sie an die [OTSession initWithApiKey:sessionId:delegate:settings:] Methode:

OTSessionSettings *settings = [[OTSessionSettings alloc] init];
settings.proxyURL = @"https://123.123.123.123:8080";

session = [[OTSession alloc] initWithApiKey:kApiKey
                                       sessionId:kSessionId
                                       delegate:self
                                       settings:settings];

Im OpenTok Windows SDK

Legen Sie die URL des Proxyservers fest, indem Sie die Option proxyUrl Parameter des Session() Konstrukteur:

Session = new Session.Builder(Context.Instance, API_KEY, SESSION_ID)
{
  ProxyUrl = "https://123.123.123.123:8080"
}.Build();

Im OpenTok Linux SDK

Legen Sie die URL des Proxyservers fest, indem Sie die Funktion otc_session_settings_set_proxy_url() Funktion:

otc_session_settings_set_proxy_url(session_settings, "https://123.123.123.123:8080");
otc_session *session = otc_session_new_with_settings(API_KEY,
                                                     SESSION_ID,
                                                     &session_callbacks,
                                                     session_settings);

Der erste Parameter ist die otc_session_settings Instanz, die Sie in die otc_session_new_with_settings() Funktion zur Initialisierung einer otc_session Instanz. Der zweite Parameter ist die URL des Proxy-Servers.

Weitere Informationen zum otc_session_settings Struktur, die otc_session_new_with_settings() und die Verbindung zur Sitzung, siehe Instanziierung einer otc_session-Instanz und sitzungsbezogene Rückrufe.

Im OpenTok macOS SDK

Legen Sie die URL des Proxyservers fest, indem Sie die Funktion otc_session_settings_set_proxy_url() Funktion:

otc_session_settings_set_proxy_url(session_settings, "https://123.123.123.123:8080");
otc_session *session = otc_session_new_with_settings(API_KEY,
                                                     SESSION_ID,
                                                     &session_callbacks,
                                                     session_settings);

Der erste Parameter ist die otc_session_settings Instanz, die Sie in die otc_session_new_with_settings() Funktion zur Initialisierung einer otc_session Instanz. Der zweite Parameter ist die URL des Proxy-Servers.

Weitere Informationen zum otc_session_settings Struktur, die otc_session_new_with_settings() und die Verbindung zur Sitzung, siehe Instanziierung einer otc_session-Instanz und sitzungsbezogene Rückrufe.

Im OpenTok-API-React-Native-SDK

Setzen Sie die proxyUrl Eigenschaft der options Stütze, die Sie in die OTSession Komponente:

<OTSession
  apiKey="your-api-key"
  sessionId="your-session-id"
  token="your-session-token"
  options={{
    proxyUrl: 'https://123.123.123.123:8080',
    // ... other options
  }}
>
  <OTPublisher/>
  <OTSubscriber/>
</OTSession>