

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Fehlerbehebung bei Kinesis Video Streams
<a name="troubleshooting"></a>

Verwenden Sie die folgenden Informationen, um häufig auftretende Probleme mit Amazon Kinesis Video Streams zu beheben.

**Topics**
+ [Allgemeine Probleme](#troubleshooting-general)
+ [Probleme mit der API](#troubleshooting-api)
+ [HLS-Probleme](#troubleshooting-hls)
+ [Probleme mit Java](#troubleshooting-java)
+ [Probleme mit der Producer-Bibliothek](#troubleshooting-producer)
+ [Probleme mit der Stream-Parser-Bibliothek](#troubleshooting-parser)
+ [Probleme mit dem Netzwerk](#troubleshooting-network)

## Allgemeine Probleme
<a name="troubleshooting-general"></a>

In diesem Abschnitt werden allgemeine Probleme beschrieben, die bei der Arbeit mit Kinesis Video Streams auftreten können.

**Topics**
+ [Latenz zu hoch](#troubleshooting-general-latency)

### Latenz zu hoch
<a name="troubleshooting-general-latency"></a>

Die Latenz kann durch die Dauer der Fragmente verursacht werden, die an den Kinesis Video Streams Streams-Dienst gesendet werden. Eine Möglichkeit, die Latenzzeit zwischen Producer und Service zu reduzieren, besteht darin, die Medien-Pipeline so zu konfigurieren, dass kürzere Fragmentlaufzeiten entstehen.

Um die Anzahl der in jedem Fragment gesendeten Frames zu reduzieren, reduzieren Sie den folgenden Wert in`kinesis_video_gstreamer_sample_app.cpp`:

```
g_object_set(G_OBJECT (data.encoder), "bframes", 0, "key-int-max", {{45}}, "bitrate", 512, NULL);
```

**Anmerkung**  
Die Latenzen sind im Mozilla Firefox-Browser aufgrund der internen Implementierung des Video-Renderings höher.

## Probleme mit der API
<a name="troubleshooting-api"></a>

In diesem Abschnitt werden API-Probleme beschrieben, die bei der Arbeit mit Kinesis Video Streams auftreten können.

**Topics**
+ [Fehler: „Unbekannte Optionen“](#troubleshooting-api-unknown-options)
+ [Fehler: „Der service/operation Name konnte nicht bestimmt werden, der autorisiert werden soll“](#troubleshooting-api-name-auth)
+ [Fehler: „Failed to put a frame in the stream“ (Es konnte kein Frame in den Stream eingefügt werden)](#troubleshooting-api-putframe)
+ [Fehler: „Der Dienst hat die Verbindung geschlossen, bevor die endgültige AckEvent Version empfangen wurde“](#troubleshooting-api-closeconnection)
+ [Fehler: "STATUS\_STORE\_OUT\_OF\_MEMORY"](#troubleshooting-api-storeoutofmemory)
+ [Fehler: „Die Anmeldeinformationen sollten auf eine gültige Region beschränkt sein.“](#troubleshoot-api-credential)

### Fehler: „Unbekannte Optionen“
<a name="troubleshooting-api-unknown-options"></a>

`GetMedia` und `GetMediaForFragmentList` können mit dem folgenden Fehler fehlschlagen:

```
Unknown options: <filename>.mkv
```

Dieser Fehler tritt auf, wenn Sie den AWS CLI mit einem `output` Typ von `json` konfiguriert haben. Konfigurieren Sie den AWS CLI mit dem Standardausgabetyp (`none`) neu. Informationen zur Konfiguration von finden [Sie AWS CLI unter configure](https://docs.aws.amazon.com/cli/latest/reference/configure) in der *AWS CLI Befehlsreferenz.*

### Fehler: „Der service/operation Name konnte nicht bestimmt werden, der autorisiert werden soll“
<a name="troubleshooting-api-name-auth"></a>

`GetMedia` kann mit dem folgenden Fehler fehlschlagen:

```
Unable to determine service/operation name to be authorized
```

Dieser Fehler kann auftreten, wenn der Endpunkt nicht korrekt angegeben ist. Wenn Sie den Endpunkt erhalten, stellen Sie sicher, dass Sie den folgenden Parameter in den `GetDataEndpoint` Aufruf aufnehmen, je nachdem, welche API aufgerufen werden soll:

```
--api-name GET_MEDIA
--api-name PUT_MEDIA
--api-name GET_MEDIA_FOR_FRAGMENT_LIST
--api-name LIST_FRAGMENTS
```

### Fehler: „Failed to put a frame in the stream“ (Es konnte kein Frame in den Stream eingefügt werden)
<a name="troubleshooting-api-putframe"></a>

`PutMedia` kann mit dem folgenden Fehler fehlschlagen:

```
Failed to put a frame in the stream
```

Dieser Fehler kann auftreten, wenn für den Dienst keine Konnektivität oder Berechtigungen verfügbar sind. Führen Sie Folgendes in der AWS CLI aus und stellen Sie sicher, dass die Stream-Informationen abgerufen werden können:

```
aws kinesisvideo describe-stream --stream-name {{StreamName}} --endpoint {{https://ServiceEndpoint.kinesisvideo.region.amazonaws.com}}
```

Schlägt der Anruf fehl, finden Sie [AWS CLI weitere Informationen unter Problembehandlung](https://docs.aws.amazon.com/cli/latest/userguide/troubleshooting.html).

### Fehler: „Der Dienst hat die Verbindung geschlossen, bevor die endgültige AckEvent Version empfangen wurde“
<a name="troubleshooting-api-closeconnection"></a>

`PutMedia` kann mit dem folgenden Fehler fehlschlagen:

```
com.amazonaws.SdkClientException: Service closed connection before final AckEvent was received
```

Dieser Fehler kann auftreten, wenn `PushbackInputStream` nicht korrekt implementiert ist. Stellen Sie sicher, dass die `unread()` Methoden korrekt implementiert sind.

### Fehler: "STATUS\_STORE\_OUT\_OF\_MEMORY"
<a name="troubleshooting-api-storeoutofmemory"></a>

`PutMedia` kann mit dem folgenden Fehler fehlschlagen:

```
The content store is out of memory.
```

Dieser Fehler tritt auf, wenn der Inhaltesspeicher nicht ausreichend groß dimensioniert wurde. Um den Inhaltsspeicher zu vergrößern, erhöhen Sie den Wert von `StorageInfo.storageSize`. Weitere Informationen finden Sie unter [StorageInfo](producer-reference-structures-producer.md#producer-reference-structures-producer-storageinfo).

### Fehler: „Die Anmeldeinformationen sollten auf eine gültige Region beschränkt sein.“
<a name="troubleshoot-api-credential"></a>

Dieser Fehler tritt auf, wenn die Signaturregion nicht mit der Endpunktregion übereinstimmt. 

Wenn Sie `us-west-2` beispielsweise Ihre Signierregion angeben, aber versuchen, eine Verbindung zum Endpunkt `kinesisvideo.us-east-1.amazonaws.com` (`us-east-1`) herzustellen, wird dieser Fehler angezeigt.

In einigen Anwendungen, wie [kvssink](examples-gstreamer-plugin.md), ist die Regions-Fallback-Kette standardmäßig auf eingestellt. `us-west-2` Stellen Sie sicher, dass Sie Ihre Region entsprechend der von Ihnen verwendeten Anwendung richtig eingestellt haben.

## HLS-Probleme
<a name="troubleshooting-hls"></a>

Falls Ihr Videostream nicht korrekt wiedergegeben wird, finden Sie weitere Informationen unter[Behebung von HLS-Problemen](hls-playback.md#how-hls-ex1-ts).

## Probleme mit Java
<a name="troubleshooting-java"></a>

In diesem Abschnitt wird beschrieben, wie Sie häufig auftretende Java-Probleme beheben können, die bei der Arbeit mit Kinesis Video Streams auftreten.

**Topics**
+ [Aktivieren von Java-Protokollen](#troubleshooting-java-log)

### Aktivieren von Java-Protokollen
<a name="troubleshooting-java-log"></a>

Um Probleme mit Java-Beispielen und -Bibliotheken zu beheben, ist es hilfreich, die Debug-Logs zu aktivieren und zu untersuchen. Gehen Sie zum Aktivieren der Debug-Protokolle folgendermaßen vor:

1. Fügen Sie `log4j` in die Datei `pom.xml``` im Knoten `dependencies` ein: 

   ```
   <dependency>
       <groupId>log4j</groupId>
       <artifactId>log4j</artifactId>
       <version>1.2.17</version>
   </dependency>
   ```

1. Erstellen Sie im Verzeichnis `target/classes` eine Datei namens `log4j.properties` mit folgendem Inhalt:

   ```
   # Root logger option
   log4j.rootLogger=DEBUG, stdout
   
   # Redirect log messages to console
   log4j.appender.stdout=org.apache.log4j.ConsoleAppender
   log4j.appender.stdout.Target=System.out
   log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
   log4j.appender.stdout.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n
   
   log4j.logger.org.apache.http.wire=DEBUG
   ```

Die Debug-Protokolle werden anschließend zur IDE-Konsole ausgegeben.

## Probleme mit der Producer-Bibliothek
<a name="troubleshooting-producer"></a>

In diesem Abschnitt werden Probleme beschrieben, die bei der Verwendung von [Zu Kinesis Video Streams hochladen](producer-sdk.md) auftreten können.

**Topics**
+ [Das Producer-SDK kann nicht kompiliert werden](#troubleshooting-producer-compile)
+ [Der Videostream wird nicht in der Konsole angezeigt](#troubleshooting-producer-console)
+ [Fehler: „Das in der Anfrage enthaltene Sicherheitstoken ist ungültig“ beim Streamen von Daten mit der Demo-Anwendung GStreamer](#troubleshooting-producer-general-securitytoken)
+ [Fehler: „Fehler beim Senden des Frames an den Kinesis-Video-Client“](#troubleshooting-producer-failed-frame-client)
+ [GStreamer Die Anwendung wird unter OS X mit der Meldung „Streaming gestoppt, Grund nicht ausgehandelt“ beendet](#troubleshooting-producer-failed-stream-osx)
+ [Fehler: „Heap konnte nicht zugewiesen werden“ beim Erstellen des Kinesis Video Client in der GStreamer Demo auf dem Raspberry Pi](#troubleshooting-producer-raspberrypi-heap)
+ [Fehler: „Ungültiger Befehl“ beim Ausführen der GStreamer Demo auf dem Raspberry Pi](#troubleshooting-producer-raspberrypi-illegalinstruction)
+ [Die Kamera kann nicht auf Raspberry Pi geladen werden.](#troubleshooting-producer-raspberrypi-camera)
+ [Kamera kann auf macOS High Sierra nicht gefunden werden.](#troubleshooting-producer-sierra-camera)
+ [Datei jni.h beim Kompilieren auf macOS High Sierra nicht gefunden](#troubleshooting-producer-sierra-compile)
+ [Curl-Fehler beim Ausführen der Demo-Anwendung GStreamer](#troubleshooting-producer-curl)
+ [Zeitstempel-/Zeitraum-Assertion während der Laufzeit auf Raspberry Pi](#troubleshooting-producer-raspberrypi-timestamp-assert)
+ [Assertion auf gst\_value\_set\_fraction\_range\_full auf Raspberry Pi](#troubleshooting-producer-raspberrypi-gst-assert)
+ [STATUS\_MKV\_INVALID\_ANNEXB\_NALU\_IN\_FRAME\_DATA (0x3200000d)-Fehler unter Android](#troubleshooting-producer-android-invalid-annexb)
+ [Fehler: Die maximale Fragmentdauer wurde erreicht](#troubleshooting-producer-maxfragmentduration)
+ ["Ungültiger Objektname abgelaufen", Fehler bei der Verwendung der IoT-Autorisierung](#troubleshooting-producer-thingname)

### Das Producer-SDK kann nicht kompiliert werden
<a name="troubleshooting-producer-compile"></a>

Überprüfen Sie, ob die erforderlichen Bibliotheken in Ihrem Pfad vorhanden sind. Zur Bestätigung führen Sie den folgenden Befehl aus:

```
env | grep LD_LIBRARY_PATH
LD_LIBRARY_PATH=/home/local/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build/downloads/local/lib
```

### Der Videostream wird nicht in der Konsole angezeigt
<a name="troubleshooting-producer-console"></a>

Damit der Videostream in der Konsole angezeigt werden kann, muss er mit H.264 im AvCC-Format codiert worden sein. Prüfen Sie Folgendes, wenn der Stream nicht angezeigt wird:
+ Für [NAL-Anpassungskennzeichen](producer-reference-nal.md) ist `NAL_ADAPTATION_ANNEXB_NALS | NAL_ADAPTATION_ANNEXB_CPD_NALS` eingestellt, wenn der Originalstream im Format Annex-B vorliegt. Dies ist der Standardwert im `StreamDefinition`-Konstruktor.
+ Sie stellen die Code Private Data ordnungsgemäß bereit. Für H.264 sind dies der Sequenzparametersatz (SPS) und der Bildparametersatz (PPS). Abhängig von der Medienquelle können diese Daten separat aus der Medienquelle abgerufen oder im Frame codiert werden.

  Viele einfache Streams liegen im folgenden Format vor (`Ab` ist der Annex-B-Startcode – 001 oder 0001):

  ```
  Ab(Sps)Ab(Pps)Ab(I-frame)Ab(P/B-frame) Ab(P/B-frame)…. Ab(Sps)Ab(Pps)Ab(I-frame)Ab(P/B-frame) Ab(P/B-frame)
  ```

  Der CPD (Codec Private Data) kann, wenn H.264 als SPS und PPS im Stream enthalten ist, an das AvCC-Format angepasst werden. Sofern die Medienpipeline die CPD nicht separat angibt, kann die Anwendung die CPD aus dem Frame extrahieren, indem sie nach dem ersten Idr-Frame sucht (der die SPS und PPS enthalten sollte), die beiden extrahiert NALUs (die dann Ab (Sps) Ab (Pps) sein werden) und sie im CPD in einfügt`StreamDefinition`.

### Fehler: „Das in der Anfrage enthaltene Sicherheitstoken ist ungültig“ beim Streamen von Daten mit der Demo-Anwendung GStreamer
<a name="troubleshooting-producer-general-securitytoken"></a>

Wenn dieser Fehler auftritt, liegt ein Problem mit Ihren Anmeldeinformationen vor. Überprüfen Sie Folgendes:
+ Wenn Sie temporäre Anmeldeinformationen verwenden, müssen Sie den Sitzungs-Token angeben.
+ Überprüfen Sie, ob Ihre temporären Anmeldeinformationen abgelaufen sind.
+ Vergewissern Sie sich, dass Sie über die richtigen Rechte verfügen.
+ Vergewissern Sie sich unter MacOS, dass Sie keine Anmeldeinformationen im Schlüsselbund zwischengespeichert haben.

### Fehler: „Fehler beim Senden des Frames an den Kinesis-Video-Client“
<a name="troubleshooting-producer-failed-frame-client"></a>

Wenn dieser Fehler auftritt, sind die Zeitstempel im Quell-Stream nicht richtig gesetzt. Gehen Sie wie folgt vor:
+ Verwenden Sie die neueste SDK-Version, in der es möglicherweise schon ein Update gibt, das Ihr Problem behebt.
+ Stellen Sie für den qualitativ hochwertigen Stream eine höhere Bitrate ein und korrigieren Sie jeglichen Jitter im Quellstream, sofern die Kamera dies unterstützt.

### GStreamer Die Anwendung wird unter OS X mit der Meldung „Streaming gestoppt, Grund nicht ausgehandelt“ beendet
<a name="troubleshooting-producer-failed-stream-osx"></a>

Das Streamen kann unter OS X mit der folgenden Meldung abgebrochen werden:

```
Debugging information: gstbasesrc.c(2939): void gst_base_src_loop(GstPad *) (): /GstPipeline:test-pipeline/GstAutoVideoSrc:source/GstAVFVideoSrc:source-actual-src-avfvide:
streaming stopped, reason not-negotiated (-4)
```

Eine mögliche Problemumgehung besteht darin, die Parameter für die Bildrate aus dem `gst_caps_new_simple` Aufruf zu entfernen in: `kinesis_video_gstreamer_sample_app.cpp`

```
GstCaps *h264_caps = gst_caps_new_simple("video/x-h264",
                                             "profile", G_TYPE_STRING, "baseline",
                                             "stream-format", G_TYPE_STRING, "avc",
                                             "alignment", G_TYPE_STRING, "au",
                                             "width", GST_TYPE_INT_RANGE, 320, 1920,
                                             "height", GST_TYPE_INT_RANGE, 240, 1080,
                                             {{"framerate", GST_TYPE_FRACTION_RANGE, 0, 1, 30, 1,}}
                                             NULL);
```

### Fehler: „Heap konnte nicht zugewiesen werden“ beim Erstellen des Kinesis Video Client in der GStreamer Demo auf dem Raspberry Pi
<a name="troubleshooting-producer-raspberrypi-heap"></a>

Die GStreamer Beispielanwendung versucht, 512 MB RAM zuzuweisen, die auf Ihrem System möglicherweise nicht verfügbar sind. Sie können die Größe des zugewiesenen Speicherplatzes verringern, indem Sie den folgenden Wert in `KinesisVideoProducer.cpp` verkleinern:

```
device_info.storageInfo.storageSize = {{512}} * 1024 * 1024;
```

### Fehler: „Ungültiger Befehl“ beim Ausführen der GStreamer Demo auf dem Raspberry Pi
<a name="troubleshooting-producer-raspberrypi-illegalinstruction"></a>

Wenn beim Ausführen der GStreamer Demo der folgende Fehler auftritt, stellen Sie sicher, dass Sie die Anwendung für die richtige Version Ihres Geräts kompiliert haben. (Stellen Sie beispielsweise sicher, dass Sie nicht für Raspberry Pi 3 kompilieren, wenn Sie auf Raspberry Pi 2 laufen.)

```
INFO - Initializing curl.
Illegal instruction
```

### Die Kamera kann nicht auf Raspberry Pi geladen werden.
<a name="troubleshooting-producer-raspberrypi-camera"></a>

Um zu überprüfen, ob die Kamera geladen wurde, führen Sie die folgenden Schritte aus:

```
ls /dev/video*
```

Ist die Suche ergebnislos, führen Sie die folgenden Schritte aus:

```
vcgencmd get_camera
```

Die Ausgabe sollte folgendermaßen oder ähnlich aussehen:

```
supported=1 detected=1
```

Wenn der Treiber die Kamera nicht erkennt, gehen Sie wie folgt vor:

1. Überprüfen Sie die technische Einrichtung der Kamera und prüfen Sie, ob sie richtig angeschlossen ist.

1. Führen Sie die folgenden Schritte aus, um die Firmware zu aktualisieren:

   ```
   sudo rpi-update
   ```

1. Starten Sie das Gerät neu.

1. Führen Sie die folgenden Schritte aus, um den Treiber zu laden:

   ```
   sudo modprobe bcm2835-v4l2
   ```

1. Überprüfen Sie, ob die Kamera erkannt wurde:

   ```
   ls /dev/video*
   ```

### Kamera kann auf macOS High Sierra nicht gefunden werden.
<a name="troubleshooting-producer-sierra-camera"></a>

Unter macOS High Sierra kann die Demo-Anwendung die Kamera nicht finden, wenn mehr als eine Kamera verfügbar ist.

### Datei jni.h beim Kompilieren auf macOS High Sierra nicht gefunden
<a name="troubleshooting-producer-sierra-compile"></a>

Um diesen Fehler zu beheben, aktualisieren Sie Ihre Installation von Xcode auf die neueste Version.

### Curl-Fehler beim Ausführen der Demo-Anwendung GStreamer
<a name="troubleshooting-producer-curl"></a>

Um Curl-Fehler bei der Ausführung der GStreamer Demo-Anwendung zu beheben, kopieren Sie [diese Zertifikatsdatei](https://www.amazontrust.com/repository/SFSRootCAG2.pem) nach. `/etc/ssl/cert.pem`

### Zeitstempel-/Zeitraum-Assertion während der Laufzeit auf Raspberry Pi
<a name="troubleshooting-producer-raspberrypi-timestamp-assert"></a>

Wenn zur Laufzeit eine Zeitstempel-/Zeitraum-Assertion auftritt, aktualisieren Sie die Firmware und starten Sie das Gerät neu:

```
sudo rpi-update 
$ sudo reboot
```

### Assertion auf gst\_value\_set\_fraction\_range\_full auf Raspberry Pi
<a name="troubleshooting-producer-raspberrypi-gst-assert"></a>

Die folgende Assertion erscheint, wenn der `uv4l`-Service ausgeführt wird: 

```
gst_util_fraction_compare (numerator_start, denominator_start, numerator_end, denominator_end) < 0' failed
```

Wenn dies der Fall ist, stoppen Sie den `uv4l`-Service und starten Sie die Anwendung neu.

### STATUS\_MKV\_INVALID\_ANNEXB\_NALU\_IN\_FRAME\_DATA (0x3200000d)-Fehler unter Android
<a name="troubleshooting-producer-android-invalid-annexb"></a>

Der folgende Fehler tritt auf, wenn [NAL-Anpassungskennzeichen](producer-reference-nal.md) für den Medien-Stream fehlerhaft ist: 

```
putKinesisVideoFrame(): Failed to put a frame with status code 0x3200000d
```

Wenn dieser Fehler auftritt, geben Sie das richtige `.withNalAdaptationFlags`-Flag für Ihr Medium (Beispiel: `NAL_ADAPTATION_ANNEXB_CPD_NALS`) an. Geben Sie dieses Flag in der folgenden Zeile des [Android](producer-sdk-android.md) an: 

[ https://github.com/awslabs/aws-sdk-android-samples/blob/master/AmazonKinesisVideoDemoApp/src/main/java/com/amazonaws/kinesisvideo/demoapp/fragment/StreamConfigurationFragment.java \#L169](https://github.com/awslabs/aws-sdk-android-samples/blob/master/AmazonKinesisVideoDemoApp/src/main/java/com/amazonaws/kinesisvideo/demoapp/fragment/StreamConfigurationFragment.java#L169)

### Fehler: Die maximale Fragmentdauer wurde erreicht
<a name="troubleshooting-producer-maxfragmentduration"></a>

Dieser Fehler tritt auf, wenn ein Medienfragment in einem Stream die maximale Fragmentdauer überschreitet. Informationen zur maximalen Fragmentdauer finden Sie im [API-Dienstkontingente für Medien und archivierte Medien](limits.md#limits-akv-data) Abschnitt.

Versuchen Sie, das Problem wie folgt zu beheben:
+ Wenn Sie eine webcam/USB Kamera verwenden, gehen Sie wie folgt vor:
  + Wenn Sie die Keyframe-basierte Fragmentierung verwenden, stellen Sie den Encoder so ein, dass er Keyframes innerhalb von 10 Sekunden bereitstellt.
  + Wenn Sie keine Keyframe-basierte Fragmentierung verwenden, legen Sie bei der Definition des Stream-Ins die maximale Fragmentdauer auf einen Wert fest[Schreiben und untersuchen Sie den Code](producersdk-cpp-write.md), der weniger als 10 Sekunden beträgt.
  + Wenn Sie Software-Encoder (wie x264) in der GStreamer Pipeline verwenden, können Sie das key-int-max Attribut innerhalb von 10 Sekunden auf einen Wert setzen. Stellen Sie es beispielsweise key-int-max auf 60 und die FPS auf 30 ein, um Keyframes alle 2 Sekunden zu aktivieren.
+ Wenn Sie eine RPI-Kamera verwenden, legen Sie das Keyframe-Intervall-Attribut auf weniger als 10 Sekunden fest.
+ Wenn Sie eine IP-Kamera (RTSP) verwenden, setzen Sie die GOP-Größe auf 60. 

### "Ungültiger Objektname abgelaufen", Fehler bei der Verwendung der IoT-Autorisierung
<a name="troubleshooting-producer-thingname"></a>

Um diesen Fehler (`HTTP Error 403: Response: {"message":"Invalid thing name passed"}`) zu vermeiden, wenn Sie IoT-Anmeldeinformationen für die Autorisierung verwenden, stellen Sie sicher, dass der Wert von `stream-name` (ein erforderlicher Parameter des `kvssink` Elements) mit dem Wert von identisch ist`iot-thingname`. Weitere Informationen finden Sie unter [GStreamer Referenz zu den Elementparametern](examples-gstreamer-plugin-parameters.md).

## Probleme mit der Stream-Parser-Bibliothek
<a name="troubleshooting-parser"></a>

In diesem Abschnitt werden Probleme beschrieben, die bei der Verwendung von [Streamen Sie mithilfe der Parser-Bibliothek](parser-library.md) auftreten können.

**Topics**
+ [Es kann nicht auf einen einzelnen Frame aus dem Stream zugegriffen werden](#troubleshooting-parser-frame)
+ [Fragmentdekodierungsfehler](#troubleshooting-parser-fragment)

### Es kann nicht auf einen einzelnen Frame aus dem Stream zugegriffen werden
<a name="troubleshooting-parser-frame"></a>

Um auf einen einzelnen Frame aus einer Streaming-Quelle in Ihrer Consumer-Anwendung zuzugreifen, stellen Sie sicher, dass Ihr Stream die richtigen privaten Codec-Daten enthält. Informationen über das Format der Daten in einem Stream finden Sie unter [Datenmodell](how-data.md). 

[In der folgenden Testdatei auf der GitHub Website erfahren Sie, wie Sie private Codec-Daten für den Zugriff auf einen Frame verwenden: .java KinesisVideoRendererExampleTest](https://github.com/aws/amazon-kinesis-video-streams-parser-library/blob/master/src/test/java/com/amazonaws/kinesisvideo/parser/examples/KinesisVideoRendererExampleTest.java)

### Fragmentdekodierungsfehler
<a name="troubleshooting-parser-fragment"></a>

Wenn Ihre Fragmente nicht korrekt in einem H.264-Format und auf einem vom Browser unterstützten Level kodiert sind , wird möglicherweise die folgende Fehlermeldung angezeigt, wenn Sie Ihren Stream in der Konsole wiedergeben:

```
Fragment Decoding Error
There was an error decoding the video data. Verify that the stream contains valid H.264 content
```

Wenn dies passiert, überprüfen Sie Folgendes:
+ Die Auflösung der Frames stimmt mit der in den Codec Private Data angegebenen Auflösung überein.
+ Das H.264-Profil und das Level der kodierten Frames stimmt mit dem Profil und dem Level überein, die in den Codec Private Data angegeben sind.
+ Der Browser unterstützt die profile/level Kombination. Die meisten aktuellen Browser unterstützt alle Profil- und Level-Kombinationen.
+ Die Zeitstempel sind präzise und in der richtigen Reihenfolge, und es werden keine doppelten Zeitstempel erstellt.
+ Ihre Anwendung kodiert die Frame-Daten mit dem H.264-Format.

## Probleme mit dem Netzwerk
<a name="troubleshooting-network"></a>

Wenn beim Versuch, eine Verbindung zu Kinesis Video Streams herzustellen, Verbindungsfehler wie „Verbindungstimeout“ oder „Verbindung fehlgeschlagen“ angezeigt werden, kann dies an Einschränkungen des IP-Adressbereichs in Ihrer Netzwerkkonfiguration liegen.

Wenn in Ihrem Setup IP-Adressbereichsbeschränkungen für Kinesis Video Streams gelten, aktualisieren Sie Ihre Netzwerkkonfiguration, sodass die [IP-Adressbereiche](https://ip-ranges.amazonaws.com/ip-ranges.json) von Kinesis Video Streams zugelassen werden.

**Wichtig**  
Die IP-Bereichsliste ist keine vollständige Liste der IP-Adressen von Kinesis Video Streams. Geben Sie die angezeigten IP-Adressbereiche an und beachten Sie, dass sich die IP-Adressen im Laufe der Zeit ändern können.

Weitere Informationen finden Sie unter [AWS IP-Bereiche](https://docs.aws.amazon.com//vpc/latest/userguide/aws-ip-ranges.html). Folgen Sie dem [Abonnementverfahren](https://docs.aws.amazon.com//vpc/latest/userguide/aws-ip-ranges.html#subscribe-notifications), um benachrichtigt zu werden, wenn sich IP-Bereiche ändern.