Configuration Issues for LiveStream Resources

In einer liveStream-Ressource enthält das status.healthStatus.configurationIssues[]-Objekt eine Liste von Konfigurationsproblemen, die sich auf den Stream auswirken. Diese Informationen sollen dir helfen, Probleme zu erkennen, zu diagnostizieren und zu beheben, die sich auf die Qualität deiner Livestreams auswirken.

In diesem Dokument werden die Arten von Konfigurationsproblemen aufgeführt, auf die in einer API-Antwort verwiesen werden kann. Für jedes Problem werden der Problemtyp, eine kurze Beschreibung des Fehlers und eine längere Beschreibung angegeben, die oft Informationen zur Problemlösung enthält.

Konfigurationsprobleme

In der Tabelle unten sind Konfigurationsprobleme aufgeführt, die sich auf Live-Videostreams auswirken können. In der linken Spalte wird die Art des Problems angegeben und in der rechten Spalte finden Sie weitere Informationen zur Behebung.

Einige Beschreibungen enthalten Variablen, die mit Daten zu deinem tatsächlichen Livestream gefüllt werden. In den folgenden Beschreibungen kennzeichnet Text im Stil <code>, z. B. %(actual_gop).1f, einen Teil einer Fehlermeldung, der für jeden Livestream angepasst wird. Ihr Code sollte auf den Problemtypen basieren, die sich in der linken Spalte befinden.

Probleme bei der Konfiguration
audioBitrateHigh
Grund:Audioeinstellungen überprüfen
Beschreibung:Die aktuelle Bitrate des Audiostreams von %(actual) ist höher als die empfohlene Bitrate. Wir empfehlen eine Audiostream-Bitrate von %(expected)s.
audioBitrateLow
Grund:Audioeinstellungen überprüfen
Beschreibung:Die aktuelle Bitrate des Audiostreams (%(actual)s) ist niedriger als die empfohlene Bitrate. Wir empfehlen eine Audiostream-Bitrate von %(expected)s.
audioBitrateMismatch
Grund:Sekundären Stream überprüfen
Beschreibung:Bei der aktuellen Konfiguration weisen der primäre Stream und der Sicherungsstream des Videos unterschiedliche Audio-Bitraten auf. Konfiguriere die Streams so, dass sie über identische Audio-Bitraten verfügen.
audioCodec
Grund:Audioeinstellungen überprüfen
Beschreibung:Der Audiostream ist mit einem nicht unterstützten Codec codiert. Lege als Audio-Codec für den Stream einen unterstützten Codec (AAC, MP3) fest.
audioCodecMismatch
Grund:Probleme mit dem sekundären Stream
Beschreibung:Bei der aktuellen Konfiguration verwenden der primäre Stream und der Sicherungsstream des Videos unterschiedliche Audio-Codecs. Konfiguriere die Streams so, dass sie identische Audio-Codecs verwenden.
audioSampleRate
Grund:Audioeinstellungen überprüfen
Beschreibung:Die aktuelle Abtastrate ist %(actual). Die empfohlenen Abtastraten sind 44,1 kHz und 48 kHz.
audioSampleRateMismatch
Grund:Probleme mit dem sekundären Stream
Beschreibung:In der aktuellen Konfiguration haben der primäre und der Back-up-Stream des Videos unterschiedliche Audio-Abtastraten. Sie müssen die Streams so konfigurieren, dass sie dieselbe Audio-Abtastrate haben.
audioStereoMismatch
Grund:Probleme mit dem sekundären Stream
Beschreibung:In der aktuellen Konfiguration werden beim primären Stream und Backup-Stream des Videos verschiedene Audiokanäle verwendet. Du musst die Streams so konfigurieren, dass dieselben Audiokanäle verwendet werden.
audioTooManyChannels
Grund:Audioeinstellungen überprüfen
Beschreibung:Die Audiodaten umfassen mehr als zwei Kanäle. Es werden aber nur ein Kanal (Mono) oder zwei Kanäle (Stereo) unterstützt. Korrigiere die Anzahl der Audiokanäle.
badContainer
Grund:Probleme mit den Videoeinstellungen
Beschreibung:Ändere das Containerformat für das Video. Das aktuelle Containerformat ist für diese Konfiguration nicht geeignet.
bitrateHigh
Grund:Videoeinstellungen überprüfen
Beschreibung:Die aktuelle Bitrate des Streams ((%(actual)s)) ist höher als die empfohlene Bitrate. Wir empfehlen eine Stream-Bitrate von %(expected)s.
bitrateLow
Grund:Schwache Videoausgabe
Beschreibung:Die aktuelle Bitrate des Streams ((%(actual)s)) ist niedriger als die empfohlene Bitrate. Wir empfehlen eine Stream-Bitrate von %(expected)s.
framerateMismatch
Grund:Sekundären Stream überprüfen
Beschreibung:Bei der aktuellen Konfiguration weisen der primäre Stream und der Sicherungsstream des Videos unterschiedliche Frame-Raten auf. Konfiguriere die Streams so, dass sie über identische Frame-Raten verfügen.
frameRateHigh
Grund:Framerate zu hoch
Beschreibung:Die aktuelle Framerate ist zu hoch. Bitte lege die Framerate auf maximal %(framerate)s fps fest.
gopMismatch
Grund:Probleme mit dem sekundären Stream
Beschreibung:Bei der aktuellen Konfiguration weisen der primäre Stream und der Sicherungsstream des Videos unterschiedliche Keyframe-Frequenzen auf. Konfiguriere die Streams so, dass sie über identische Keyframe-Frequenzen verfügen.
gopSizeLong
Grund:Probleme mit den Videoeinstellungen
Beschreibung:Verwende eine Keyframe-Frequenz von maximal vier Sekunden. Im Moment werden Keyframes nicht häufig genug gesendet, was zu Zwischenspeicherungen führt. Die aktuelle Keyframe-Frequenz beträgt %(actual_gop).1f Sekunden. Beachte, dass Fehler bei der Datenaufnahme zu falschen Bildergruppengrößen (GoP) führen können.
gopSizeOver
Grund:Videoeinstellungen überprüfen
Beschreibung:Verwende eine Keyframe-Frequenz von maximal vier Sekunden. Im Moment werden Keyframes nicht häufig genug gesendet, was zu Zwischenspeicherungen führen kann. Die aktuelle Keyframe-Frequenz beträgt %(actual_gop).1f Sekunden. Beachte, dass Fehler bei der Datenaufnahme zu falschen Bildergruppengrößen (GoP) führen können.
gopSizeShort
Grund:Videoeinstellungen überprüfen
Beschreibung:Die Bildergruppengröße (GoP) ist sehr gering. Dies kann die Bildqualität beeinträchtigen. Die empfohlene Keyframe-Frequenz beträgt vier Sekunden. Die aktuelle Keyframe-Frequenz beträgt %(actual_gop).1f Sekunden. Beachte, dass Fehler bei der Datenaufnahme zu falschen Bildergruppengrößen (GoP) führen können.
multipleAudioStreams
Grund:Audioeinstellungen überprüfen
Beschreibung:Der Datenaufnahme-Stream enthält mehrere Audiostreams. Er darf aber nur einen Audiostream enthalten.
multipleVideoStreams
Grund:Probleme mit den Videoeinstellungen
Beschreibung:Der Datenaufnahme-Stream enthält mehrere Videostreams. Er darf aber nur einen Videostream enthalten.
noAudioStream
Grund:Kein Ton
Beschreibung:Der Datenaufnahme-Stream enthält keine Audiostreams. Er muss aber genau einen Audiostream enthalten.
noVideoStream
Grund:Kein Video
Beschreibung:Der Datenaufnahme-Stream enthält keine Videostreams. Er muss aber genau einen Videostream enthalten.
openGop
Grund:Probleme mit den Videoeinstellungen
Beschreibung:Ändere die Konfiguration deines Video-Encoders in eine geschlossene Bildergruppe. Sie scheint derzeit auf eine offene Bildergruppe eingestellt zu sein, was von YouTube nicht unterstützt wird.
resolutionMismatch
Grund:Probleme mit dem sekundären Stream
Beschreibung:Bei der aktuellen Konfiguration stimmen die Auflösungen für den primären Stream und der Sicherungsstream des Videos nicht überein. Konfiguriere die Streams so, dass die Auflösungen identisch sind.
videoBitrateMismatch
Grund:Sekundären Stream überprüfen
Beschreibung:Bei der aktuellen Konfiguration weisen der primäre Stream und der Sicherungsstream des Videos unterschiedliche Bitraten auf. Konfiguriere die Streams so, dass sie über identische Video-Bitraten verfügen.
videoCodec
Grund:Probleme mit den Videoeinstellungen
Beschreibung:Das Video ist mit einem nicht unterstützten Codec codiert. Lege als Video-Codec für den Stream einen unterstützten Codec (H.264) fest.
videoCodecMismatch
Grund:Probleme mit dem sekundären Stream
Beschreibung:Bei der aktuellen Konfiguration verwenden der primäre Stream und der Sicherungsstream des Videos unterschiedliche Video-Codecs. Konfiguriere die Streams so, dass sie über identische Video-Codecs verfügen.
videoIngestionStarved
Grund:Schwache Videoausgabe
Beschreibung:YouTube empfängt nicht genügend Videodaten, um ein flüssiges Streaming ohne Zwischenspeicherung gewährleisten zu können.
videoInterlaceMismatch
Grund:Probleme mit dem sekundären Stream
Beschreibung:Bei der aktuellen Konfiguration weisen der primäre Stream und der Sicherungsstream des Videos unterschiedliches Interlacing auf. Konfiguriere die Streams so, dass sie über identisches Interlacing verfügen.
videoProfileMismatch
Grund:Probleme mit dem sekundären Stream
Beschreibung:Bei der aktuellen Konfiguration weisen der primäre Stream und der Sicherungsstream des Videos unterschiedliche Profile auf. Konfiguriere die Streams so, dass sie über identische Profile verfügen.
videoResolutionSuboptimal
Grund:Auflösung prüfen
Beschreibung:Überprüfe die Videoauflösung. Die aktuelle Auflösung von (%(actual_w)dx%(actual_h)d) ist nicht optimal.
videoResolutionUnsupported
Grund:Nicht unterstützte Auflösung
Beschreibung:Es ist erforderlich, dass du die Videoauflösung änderst. Die aktuelle Auflösung ist (%(actual_w)dx%(actual_h)d). Diese wird für diese Konfiguration nicht unterstützt. Die erwartete Videoauflösung beträgt (%(expected_w)dx%(expected_h)d).