Fehler beheben

Auf dieser Seite erfährst du, wie du Probleme mit der Live Stream API beheben kannst. Die auf dieser Seite angezeigten Fehler gelten speziell für die Live Stream API. Informationen zu generischen Fehlern in Google APIs finden Sie auf der Seite Cloud APIs – Fehler.

Eingabestream abgelehnt

Wenn dein Encoder einen Eingabestream an einen Eingabeendpunkt sendet, die Verbindung aber immer wieder abgelehnt wird, überprüfe Folgendes:

Ungültiger Eingabeendpunkt-URI

Ein Fehler tritt auf, wenn dein Encoder einen Eingabestream an einen ungültigen Eingabeendpunkt-URI sendet.

Prüfe, ob dein Encoder so konfiguriert ist, dass der Eingabestream an einen Eingabeendpunkt-URI mit der richtigen IP-Adresse und STREAM-ID gesendet wird.

Die Eingabe ist keinem Kanal zugeordnet.

Ein Fehler tritt auf, wenn dein Encoder einen Eingabestream an einen Eingabeendpunkt-URI sendet, der nicht mit einem Kanal verknüpft ist.

Um dieses Problem zu beheben, erstellen Sie einen neuen Kanal mit dem Eingabeendpunkt. Wenn Sie prüfen möchten, ob ein Eingabeendpunkt erfolgreich mit dem Kanal verknüpft wurde, rufen Sie die Kanaldetails ab und suchen Sie im Feld inputAttachments nach dem Namen des Eingabeendpunkts.

Inaktiver Kanal

Ein Fehler tritt auf, wenn dein Encoder einen Eingabestream an einen Kanal sendet, der nicht aktiv ist.

Prüfe den Status des Kanals, um sicherzustellen, dass seine streamingState AWAITING_INPUT ist. Wenn die streamingState des Kanals STOPPED ist, starte den Kanal.

Ein anderer Encoder ist bereits mit demselben Eingabeendpunkt verbunden.

Ein Fehler tritt auf, wenn mehrere Encoder versuchen, Eingabestreams an denselben Eingabeendpunkt zu senden. Pro Eingabeendpunkt-URI wird jeweils nur eine Verbindung akzeptiert.

Prüfe, ob der Kanal bereits den Status STREAMING hat, um das Problem zu beheben. In diesem Fall haben Sie folgende Möglichkeiten:

  • Erstellen Sie einen separaten Eingabeendpunkt und einen separaten Kanal für den zweiten Eingabestream.

  • Beenden Sie den ersten Eingabestream, bevor Sie einen weiteren an denselben Eingabeendpunkt senden.

Die IP-Adresse des Encoders befindet sich nicht in den zulässigen IP-Bereichen

Ein Fehler tritt auf, wenn der Encoder einen Eingabestream von einer IP-Adresse außerhalb der für einen Eingabeendpunkt konfigurierten IP-Bereiche sendet.

Um dieses Problem zu beheben, rufen Sie die Details für einen Eingabeendpunkt ab und prüfen Sie das Feld securityRules. Wenn ipRanges angegeben sind, muss dein Encoder eine gültige IP-Adresse in diesen IP-Bereichen haben.

Fehlende Ausgabedateien im Cloud Storage-Bucket

Wenn dein Encoder einen Eingabestream erfolgreich an den Eingabeendpunkt sendet, aber keine Ausgabedateien im Cloud Storage-Bucket angezeigt werden, solltest du die folgenden möglichen Probleme prüfen:

Falscher Cloud Storage-Bucket

Ausgabedateien fehlen möglicherweise, wenn Sie den falschen Cloud Storage-Bucket prüfen.

Um dieses Problem zu beheben, rufe die Kanaldetails für deinen Livestream auf. Prüfen Sie im Feld output.uri, ob der Cloud Storage-Bucket-URI korrekt ist.

Ungültige Video-/Audio-Codecs

Ausgabedateien fehlen möglicherweise, wenn dein Encoder ungültige Video- oder Audiocodecs sendet.

Um dieses Problem zu beheben, achte darauf, dass dein Encoder nur H264-Video- und AAC-Audio-Codecs sendet.

Cloud Storage-Berechtigung verweigert

Standardmäßig wird von der Live Stream API ein Dienstkonto erstellt, das auf Cloud Storage-Buckets im selben Google Cloud-Projekt zugreifen kann, in dem die Live Stream API-Ressourcen gehostet werden. Ausgabedateien fehlen möglicherweise, wenn dieses Dienstkonto die Berechtigung zum Zugriff auf den Cloud Storage-Bucket verliert.

Achten Sie zur Behebung dieses Problems darauf, dass das Dienstkonto ausreichend Berechtigungen hat. Das Erstellen von Ausgabedateien kann aus folgenden Gründen fehlschlagen:

  • Der Cloud Storage-Ausgabe-Bucket befindet sich in einem anderen Google Cloud-Projekt als die Live Stream API-Ressourcen wie der Kanal und der Eingabeendpunkt.

  • Die Standardberechtigungen werden dem Dienstkonto entzogen.

Weitere Informationen finden Sie unter Zugriff auf Cloud Storage.

Fehlende Audiotracks

Ausgabedateien fehlen möglicherweise, wenn dein Encoder einen Eingabestream mit fehlenden Audiotracks sendet. Die Videopipeline wartet, bis alle Audiotracks eingegangen sind, bevor die Verarbeitung beginnt.

Um dieses Problem zu beheben, rufe die Kanaldetails für deinen Livestream auf. Achte darauf, dass dein Encoder alle Audiotracks sendet, die im Feld ElementaryStream.audioStream.mapping (AudioMapping) konfiguriert sind.