Fehlerbehandlung

Dieser Abschnitt gibt einen Überblick über die Fehlerbedingungen, wie das Web-Broadcast-SDK sie an die Anwendung meldet und was eine Anwendung tun sollte, wenn diese Fehler auftreten. Es gibt vier Kategorien von Fehlern:

try {
  stage = new Stage(token, strategy);
} catch (e) {
  // 1) stage instantiation errors
}

try {
  await stage.join();
} catch (e) {
  // 2) stage join errors
}

stage.on(StageEvents.STAGE_PARTICIPANT_PUBLISH_STATE_CHANGED, (participantInfo, state) => {
  if (state === StageParticipantPublishState.ERRORED) {
    // 3) stage publish errors
  }
});

stage.on(StageEvents.STAGE_PARTICIPANT_SUBSCRIBE_STATE_CHANGED, (participantInfo, state) => {
  if (state === StageParticipantSubscribeState.ERRORED) {
    // 4) stage subscribe errors
  }
});

Fehler bei der Instanziierung der Phase

Bei der Phaseninstanziierung werden Tokens nicht per Fernzugriff validiert, es wird jedoch nach einigen grundlegenden Token-Problemen gesucht, die auf der Client-Seite überprüft werden können. Infolgedessen kann das SDK einen Fehler ausgeben.

Fehlerhaftes Teilnehmer-Token

Dies tritt auf, wenn das Phasen-Token falsch formatiert ist. Beim Instanziieren einer Phase gibt das SDK einen Fehler mit der folgenden Meldung aus: „Fehler beim Parsen des Stage-Token“.

Aktion: Erstellen Sie ein gültiges Token und versuchen Sie erneut, es zu instanziieren.

Fehler beim Beitreten zu einer Phase

Dies sind die Fehler, die auftreten können, wenn Sie zum ersten Mal versuchen, einer Phase beizutreten.

Phase wurde gelöscht

Dies tritt auf, wenn Sie einer Phase beitreten (die mit einem Token verknüpft ist), die gelöscht wurde. Die join SDK-Methode gibt einen Fehler mit der folgenden Meldung aus: „InitialConnectTimedOut nach 10 Sekunden“.

Aktion: Erstellen Sie ein gültiges Token mit einer neuen Phase und versuchen Sie erneut beizutreten.

Abgelaufenes Teilnehmer-Token

Dies tritt auf, wenn das Token abgelaufen ist. Die SDK-Methode join gibt einen Fehler mit der folgenden Meldung aus: „Das Token ist abgelaufen und nicht mehr gültig.“

Aktion: Erstellen Sie ein neues Token und versuchen Sie erneut beizutreten.

Ungültiges oder widerrufenes Teilnehmer-Token

Dies tritt auf, wenn das Token ungültig ist oder widerrufen/die Verbindung unterbrochen wurde. Die join SDK-Methode gibt einen Fehler mit der folgenden Meldung aus: „InitialConnectTimedOut nach 10 Sekunden“.

Aktion: Erstellen Sie ein neues Token und versuchen Sie erneut beizutreten.

Token getrennt

Dies tritt auf, wenn das Phasen-Token nicht fehlerhaft formatiert ist, sondern vom Stages-Server zurückgewiesen wird. Die join SDK-Methode gibt einen Fehler mit der folgenden Meldung aus: „InitialConnectTimedOut nach 10 Sekunden“.

Aktion: Erstellen Sie ein gültiges Token und versuchen Sie erneut beizutreten.

Netzwerkfehler beim ersten Beitritt

Dies tritt auf, wenn das SDK den Stages-Server nicht kontaktieren kann, um eine Verbindung herzustellen. Die join SDK-Methode gibt einen Fehler mit der folgenden Meldung aus: „InitialConnectTimedOut nach 10 Sekunden“.

Handlung: Warten Sie, bis die Konnektivität des Geräts wiederhergestellt ist, und versuchen Sie erneut, eine Verbindung herzustellen.

Netzwerkfehler, wenn bereits eine Verbindung hergestellt wurde

Wenn die Netzwerkverbindung des Geräts ausfällt, verliert das SDK möglicherweise die Verbindung zu den Phasen-Servern. Möglicherweise werden in der Konsole Fehler angezeigt, da das SDK die Back-End-Dienste nicht mehr erreichen kann. POSTs auf https://broadcast.stats.live-video.net schlagen fehl.

Wenn Sie etwas veröffentlichen und/oder abonnieren, werden in der Konsole Fehler angezeigt, die sich auf Versuche beziehen, etwas zu veröffentlichen/zu abonnieren.

Intern versucht das SDK, die Verbindung mithilfe einer exponentiellen Backoff-Strategie wiederherzustellen.

Aktion: Warten Sie, bis die Konnektivität des Geräts wiederhergestellt ist. Wenn Sie etwas veröffentlichen oder abonnieren, aktualisieren Sie die Strategie, um sicherzustellen, dass Ihre Medienstreams erneut veröffentlicht werden.

Fehler beim Veröffentlichen und Abonnieren

Fehler bei der Veröffentlichung: States veröffentlichen

Das SDK meldet ERRORED, wenn eine Veröffentlichung fehlschlägt. Dies kann auf Netzwerkbedingungen zurückzuführen sein oder wenn eine Phase für Publisher ausgelastet ist.

stage.on(StageEvents.STAGE_PARTICIPANT_PUBLISH_STATE_CHANGED, (participantInfo, state) => {
  if (state === StageParticipantPublishState.ERRORED) {
      // Handle
  }
});

Maßnahme: Aktualisieren Sie die Strategie, um zu versuchen, Ihre Medienstreams erneut zu veröffentlichen.

Fehler beim Abonnieren

Das SDK meldet ERRORED, wenn ein Abonnement fehlschlägt. Dies kann auf Netzwerkbedingungen zurückzuführen sein oder wenn eine Phase für Abonnenten ausgelastet ist.

stage.on(StageEvents.STAGE_PARTICIPANT_SUBSCRIBE_STATE_CHANGED, (participantInfo, state) => {
  if (state === StageParticipantSubscribeState.ERRORED) {
    // 4) stage subscribe errors
  }
});

Maßnahme: Aktualisieren Sie die Strategie, um ein neues Abonnement auszuprobieren.