Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memecahkan Masalah Kinesis Video Streams
Gunakan informasi berikut untuk memecahkan masalah umum yang dihadapi dengan Amazon Kinesis Video Streams.
**Topics**
+ [Masalah umum](#troubleshooting-general)
+ [Masalah API](#troubleshooting-api)
+ [Masalah HLS](#troubleshooting-hls)
+ [Masalah Java](#troubleshooting-java)
+ [Masalah perpustakaan produser](#troubleshooting-producer)
+ [Masalah pustaka parser streaming](#troubleshooting-parser)
+ [Masalah jaringan](#troubleshooting-network)
## Masalah umum
Bagian ini menjelaskan masalah umum yang mungkin Anda temui saat bekerja dengan Kinesis Video Streams.
**Topics**
+ [Latensi terlalu tinggi](#troubleshooting-general-latency)
### Latensi terlalu tinggi
Latensi mungkin disebabkan oleh durasi fragmen yang dikirim ke layanan Kinesis Video Streams. Salah satu cara untuk mengurangi latensi antara produsen dan layanan adalah dengan mengkonfigurasi pipa media untuk menghasilkan durasi fragmen yang lebih pendek.
Untuk mengurangi jumlah frame yang dikirim di setiap fragmen, kurangi nilai berikut di`kinesis_video_gstreamer_sample_app.cpp`:
```
g_object_set(G_OBJECT (data.encoder), "bframes", 0, "key-int-max", {{45}}, "bitrate", 512, NULL);
```
**catatan**
Latensi lebih tinggi di browser Mozilla Firefox karena implementasi internal rendering video.
## Masalah API
Bagian ini menjelaskan masalah API yang mungkin Anda temui saat bekerja dengan Kinesis Video Streams.
**Topics**
+ [Kesalahan: “Opsi tidak dikenal”](#troubleshooting-api-unknown-options)
+ [Kesalahan: “Tidak dapat menentukan service/operation nama yang akan diotorisasi”](#troubleshooting-api-name-auth)
+ [Kesalahan: “Gagal menempatkan bingkai di aliran”](#troubleshooting-api-putframe)
+ [Kesalahan: “Layanan menutup koneksi sebelum final AckEvent diterima”](#troubleshooting-api-closeconnection)
+ [Kesalahan: “STATUS\_STORE\_OUT\_OF\_MEMORY”](#troubleshooting-api-storeoutofmemory)
+ [Kesalahan: “Kredensyal harus dicakup ke wilayah yang valid.”](#troubleshoot-api-credential)
### Kesalahan: “Opsi tidak dikenal”
`GetMedia`dan `GetMediaForFragmentList` bisa gagal dengan kesalahan berikut:
```
Unknown options: .mkv
```
Kesalahan ini terjadi jika Anda mengkonfigurasi AWS CLI dengan `output` jenis`json`. Konfigurasi ulang AWS CLI dengan tipe output default (`none`). Untuk informasi tentang mengonfigurasi AWS CLI, lihat [mengkonfigurasi](https://docs.aws.amazon.com/cli/latest/reference/configure) di *Referensi AWS CLI Perintah*.
### Kesalahan: “Tidak dapat menentukan service/operation nama yang akan diotorisasi”
`GetMedia`bisa gagal dengan kesalahan berikut:
```
Unable to determine service/operation name to be authorized
```
Kesalahan ini dapat terjadi jika titik akhir tidak ditentukan dengan benar. Saat Anda mendapatkan titik akhir, pastikan untuk menyertakan parameter berikut dalam `GetDataEndpoint` panggilan, tergantung pada API yang akan dipanggil:
```
--api-name GET_MEDIA
--api-name PUT_MEDIA
--api-name GET_MEDIA_FOR_FRAGMENT_LIST
--api-name LIST_FRAGMENTS
```
### Kesalahan: “Gagal menempatkan bingkai di aliran”
`PutMedia`bisa gagal dengan kesalahan berikut:
```
Failed to put a frame in the stream
```
Kesalahan ini mungkin terjadi jika konektivitas atau izin tidak tersedia untuk layanan. Jalankan yang berikut ini di AWS CLI, dan verifikasi bahwa informasi aliran dapat diambil:
```
aws kinesisvideo describe-stream --stream-name {{StreamName}} --endpoint {{https://ServiceEndpoint.kinesisvideo.region.amazonaws.com}}
```
Jika panggilan gagal, lihat [Pemecahan Masalah AWS CLI Kesalahan](https://docs.aws.amazon.com/cli/latest/userguide/troubleshooting.html) untuk informasi selengkapnya.
### Kesalahan: “Layanan menutup koneksi sebelum final AckEvent diterima”
`PutMedia`bisa gagal dengan kesalahan berikut:
```
com.amazonaws.SdkClientException: Service closed connection before final AckEvent was received
```
Kesalahan ini dapat terjadi jika `PushbackInputStream` diterapkan secara tidak benar. Verifikasi bahwa `unread()` metode diterapkan dengan benar.
### Kesalahan: “STATUS\_STORE\_OUT\_OF\_MEMORY”
`PutMedia`bisa gagal dengan kesalahan berikut:
```
The content store is out of memory.
```
Kesalahan ini terjadi ketika toko konten tidak dialokasikan dengan ukuran yang cukup. Untuk meningkatkan ukuran toko konten, tingkatkan nilai`StorageInfo.storageSize`. Untuk informasi selengkapnya, lihat [StorageInfo](producer-reference-structures-producer.md#producer-reference-structures-producer-storageinfo).
### Kesalahan: “Kredensyal harus dicakup ke wilayah yang valid.”
Kesalahan ini terjadi jika wilayah penandatanganan tidak cocok dengan wilayah titik akhir.
Misalnya, jika Anda menentukan `us-west-2` sebagai wilayah penandatanganan, tetapi mencoba menyambung ke titik akhir `kinesisvideo.us-east-1.amazonaws.com` (`us-east-1`), Anda akan menerima kesalahan ini.
Dalam beberapa aplikasi, seperti [kvssink, rantai](examples-gstreamer-plugin.md) fallback wilayah default. `us-west-2` Verifikasi bahwa Anda mengatur wilayah Anda dengan benar sesuai dengan aplikasi yang Anda gunakan.
## Masalah HLS
Jika streaming video Anda tidak diputar dengan benar, lihat[Memecahkan masalah HLS](hls-playback.md#how-hls-ex1-ts).
## Masalah Java
Bagian ini menjelaskan cara memecahkan masalah umum Java yang dihadapi saat bekerja dengan Kinesis Video Streams.
**Topics**
+ [Mengaktifkan log Java](#troubleshooting-java-log)
### Mengaktifkan log Java
Untuk memecahkan masalah dengan sampel dan pustaka Java, akan sangat membantu untuk mengaktifkan dan memeriksa log debug. Untuk mengaktifkan log debug, lakukan hal berikut:
1. Tambahkan `log4j` ke `pom.xml` `` file, di `dependencies` simpul:
```
log4j
log4j
1.2.17
```
1. Di `target/classes` direktori, buat file bernama `log4j.properties` dengan konten berikut:
```
# 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
```
Log debug kemudian mencetak ke konsol IDE.
## Masalah perpustakaan produser
Bagian ini menjelaskan masalah yang mungkin Anda temui saat menggunakan[Unggah ke Kinesis Video Streams](producer-sdk.md).
**Topics**
+ [Tidak dapat mengkompilasi SDK produsen](#troubleshooting-producer-compile)
+ [Aliran video tidak muncul di konsol](#troubleshooting-producer-console)
+ [Kesalahan: “Token keamanan yang disertakan dalam permintaan tidak valid” saat streaming data menggunakan aplikasi demo GStreamer](#troubleshooting-producer-general-securitytoken)
+ [Kesalahan: “Gagal mengirimkan bingkai ke klien Video Kinesis”](#troubleshooting-producer-failed-frame-client)
+ [GStreamer aplikasi berhenti dengan pesan “streaming berhenti, alasan tidak dinegosiasikan” di OS X](#troubleshooting-producer-failed-stream-osx)
+ [Kesalahan: “Gagal mengalokasikan heap” saat membuat Klien Video Kinesis dalam demo di GStreamer Raspberry Pi](#troubleshooting-producer-raspberrypi-heap)
+ [Kesalahan: “Instruksi Ilegal” saat menjalankan GStreamer demo di Raspberry Pi](#troubleshooting-producer-raspberrypi-illegalinstruction)
+ [Kamera gagal dimuat di Raspberry Pi](#troubleshooting-producer-raspberrypi-camera)
+ [Kamera tidak dapat ditemukan di macOS High Sierra](#troubleshooting-producer-sierra-camera)
+ [file jni.h tidak ditemukan saat mengkompilasi di macOS High Sierra](#troubleshooting-producer-sierra-compile)
+ [Kesalahan keriting saat menjalankan aplikasi GStreamer demo](#troubleshooting-producer-curl)
+ [Pernyataan stempel waktu/rentang saat runtime di Raspberry Pi](#troubleshooting-producer-raspberrypi-timestamp-assert)
+ [Pernyataan tentang gst\_value\_set\_fraction\_range\_full pada Raspberry Pi](#troubleshooting-producer-raspberrypi-gst-assert)
+ [Kesalahan STATUS\_MKV\_INVALID\_ANNEXB\_NALU\_IN\_FRAME\_DATA (0x3200000d) di Android](#troubleshooting-producer-android-invalid-annexb)
+ [Durasi fragmen maksimum tercapai kesalahan](#troubleshooting-producer-maxfragmentduration)
+ [Kesalahan “Nama benda tidak valid lulus” saat menggunakan otorisasi IoT](#troubleshooting-producer-thingname)
### Tidak dapat mengkompilasi SDK produsen
Verifikasi bahwa pustaka yang diperlukan ada di jalur Anda. Untuk memverifikasi ini, gunakan perintah berikut:
```
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
```
### Aliran video tidak muncul di konsol
Untuk menampilkan aliran video Anda di konsol, itu harus dikodekan menggunakan H.264 dalam format AVCC. Jika streaming Anda tidak ditampilkan, verifikasi hal berikut:
+ Anda [Bendera adaptasi NAL](producer-reference-nal.md) diatur ke `NAL_ADAPTATION_ANNEXB_NALS | NAL_ADAPTATION_ANNEXB_CPD_NALS` jika aliran asli dalam format Lampiran-B. Ini adalah nilai default dalam `StreamDefinition` konstruktor.
+ Anda menyediakan data pribadi codec dengan benar. Untuk H.264, ini adalah set parameter urutan (SPS) dan set parameter gambar (PPS). Bergantung pada sumber media Anda, data ini dapat diambil dari sumber media secara terpisah atau dikodekan ke dalam bingkai.
Banyak aliran dasar dalam format berikut, di mana `Ab` kode awal Lampiran-B (001 atau 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)
```
CPD (Codec Private Data), jika H.264 berada dalam aliran sebagai SPS dan PPS, dapat disesuaikan dengan format AVCC. Kecuali jika pipa media memberikan CPD secara terpisah, aplikasi dapat mengekstrak CPD dari frame dengan mencari frame Id pertama (yang harus berisi SPS dan PPS), mengekstrak keduanya NALUs (yang akan menjadi Ab (Sps) Ab (Pps)) dan mengaturnya di CPD di. `StreamDefinition`
### Kesalahan: “Token keamanan yang disertakan dalam permintaan tidak valid” saat streaming data menggunakan aplikasi demo GStreamer
Jika kesalahan ini terjadi, ada masalah dengan kredensyal Anda. Verifikasi hal berikut:
+ Jika Anda menggunakan kredensil sementara, Anda harus menentukan token sesi.
+ Verifikasi bahwa kredensyal sementara Anda tidak kedaluwarsa.
+ Verifikasi bahwa Anda memiliki hak yang tepat yang diatur.
+ Di macOS, verifikasi bahwa Anda tidak memiliki kredensional yang di-cache di Keychain.
### Kesalahan: “Gagal mengirimkan bingkai ke klien Video Kinesis”
Jika kesalahan ini terjadi, stempel waktu tidak diatur dengan benar di aliran sumber. Coba tindakan berikut ini:
+ Gunakan contoh SDK terbaru, yang mungkin memiliki pembaruan yang memperbaiki masalah Anda.
+ Atur aliran berkualitas tinggi ke bitrate yang lebih tinggi, dan perbaiki jitter apa pun di aliran sumber jika kamera mendukung melakukannya.
### GStreamer aplikasi berhenti dengan pesan “streaming berhenti, alasan tidak dinegosiasikan” di OS X
Streaming dapat berhenti di OS X dengan pesan berikut:
```
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)
```
Solusi yang mungkin untuk ini adalah menghapus parameter frame rate dari panggilan di`gst_caps_new_simple`: `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);
```
### Kesalahan: “Gagal mengalokasikan heap” saat membuat Klien Video Kinesis dalam demo di GStreamer Raspberry Pi
Aplikasi GStreamer sampel mencoba mengalokasikan 512 MB RAM, yang mungkin tidak tersedia di sistem Anda. Anda dapat mengurangi alokasi ini dengan mengurangi nilai berikut di`KinesisVideoProducer.cpp`:
```
device_info.storageInfo.storageSize = {{512}} * 1024 * 1024;
```
### Kesalahan: “Instruksi Ilegal” saat menjalankan GStreamer demo di Raspberry Pi
Jika Anda mengalami kesalahan berikut saat menjalankan GStreamer demo, verifikasi bahwa Anda telah mengkompilasi aplikasi untuk versi perangkat yang benar. (Misalnya, verifikasi bahwa Anda tidak mengkompilasi untuk Raspberry Pi 3 saat Anda menjalankan Raspberry Pi 2.)
```
INFO - Initializing curl.
Illegal instruction
```
### Kamera gagal dimuat di Raspberry Pi
Untuk memeriksa apakah kamera dimuat, jalankan yang berikut ini:
```
ls /dev/video*
```
Jika tidak ada yang ditemukan, jalankan yang berikut ini:
```
vcgencmd get_camera
```
Outputnya akan serupa dengan yang berikut ini:
```
supported=1 detected=1
```
Jika pengemudi tidak mendeteksi kamera, lakukan hal berikut:
1. Periksa pengaturan kamera fisik dan verifikasi apakah itu terhubung dengan benar.
1. Jalankan yang berikut ini untuk memutakhirkan firmware:
```
sudo rpi-update
```
1. Mulai ulang perangkat.
1. Jalankan yang berikut ini untuk memuat driver:
```
sudo modprobe bcm2835-v4l2
```
1. Verifikasi bahwa kamera terdeteksi:
```
ls /dev/video*
```
### Kamera tidak dapat ditemukan di macOS High Sierra
Di macOS High Sierra, aplikasi demo tidak dapat menemukan kamera jika lebih dari satu kamera tersedia.
### file jni.h tidak ditemukan saat mengkompilasi di macOS High Sierra
Untuk mengatasi kesalahan ini, perbarui instalasi Xcode Anda ke versi terbaru.
### Kesalahan keriting saat menjalankan aplikasi GStreamer demo
Untuk mengatasi kesalahan curl saat Anda menjalankan aplikasi GStreamer demo, salin [file sertifikat ini](https://www.amazontrust.com/repository/SFSRootCAG2.pem) ke`/etc/ssl/cert.pem`.
### Pernyataan stempel waktu/rentang saat runtime di Raspberry Pi
Jika pernyataan rentang stempel waktu terjadi saat runtime, perbarui firmware dan mulai ulang perangkat:
```
sudo rpi-update
$ sudo reboot
```
### Pernyataan tentang gst\_value\_set\_fraction\_range\_full pada Raspberry Pi
Pernyataan berikut muncul jika `uv4l` layanan sedang berjalan:
```
gst_util_fraction_compare (numerator_start, denominator_start, numerator_end, denominator_end) < 0' failed
```
Jika ini terjadi, hentikan `uv4l` layanan dan restart aplikasi.
### Kesalahan STATUS\_MKV\_INVALID\_ANNEXB\_NALU\_IN\_FRAME\_DATA (0x3200000d) di Android
Kesalahan berikut muncul [Bendera adaptasi NAL](producer-reference-nal.md) jika salah untuk aliran media:
```
putKinesisVideoFrame(): Failed to put a frame with status code 0x3200000d
```
Jika kesalahan ini terjadi, berikan `.withNalAdaptationFlags` tanda yang benar untuk media Anda (misalnya,`NAL_ADAPTATION_ANNEXB_CPD_NALS`). Berikan bendera ini di baris berikut[Android](producer-sdk-android.md):
[ 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)
### Durasi fragmen maksimum tercapai kesalahan
Kesalahan ini terjadi ketika fragmen media dalam aliran melebihi batas durasi fragmen maksimum. Lihat batas durasi fragmen maksimum di [Kuota layanan API media dan media arsip](limits.md#limits-akv-data) bagian.
Untuk mengatasi masalah ini, coba yang berikut ini:
+ Jika Anda menggunakan webcam/USB kamera, lakukan salah satu hal berikut:
+ Jika Anda menggunakan fragmentasi berbasis bingkai kunci, maka atur encoder untuk menyediakan bingkai kunci dalam waktu 10 detik.
+ Jika Anda tidak menggunakan fragmentasi berbasis bingkai kunci, maka saat menentukan aliran[Tulis dan periksa kodenya](producersdk-cpp-write.md), tetapkan batas durasi fragmen maksimum ke nilai yang kurang dari 10 detik.
+ Jika Anda menggunakan encoder perangkat lunak (seperti x264) dalam GStreamer pipeline, Anda dapat mengatur key-int-max atribut ke nilai dalam waktu 10 detik. Misalnya, atur key-int-max ke 60, dengan fps disetel ke 30, untuk mengaktifkan bingkai kunci setiap 2 detik.
+ Jika Anda menggunakan kamera RPI, atur atribut keyframe-interval menjadi kurang dari 10 detik.
+ Jika Anda menggunakan kamera IP (RTSP), atur ukuran GOP ke 60.
### Kesalahan “Nama benda tidak valid lulus” saat menggunakan otorisasi IoT
Untuk menghindari kesalahan ini (`HTTP Error 403: Response: {"message":"Invalid thing name passed"}`) saat Anda menggunakan kredenal IoT untuk otorisasi, pastikan bahwa nilai `stream-name` (parameter `kvssink` elemen yang diperlukan) identik dengan nilai. `iot-thingname` Untuk informasi selengkapnya, lihat [GStreamer referensi parameter elemen](examples-gstreamer-plugin-parameters.md).
## Masalah pustaka parser streaming
Bagian ini menjelaskan masalah yang mungkin Anda temui saat menggunakan[Streaming menggunakan pustaka parser](parser-library.md).
**Topics**
+ [Tidak dapat mengakses satu frame dari aliran](#troubleshooting-parser-frame)
+ [Kesalahan decoding fragmen](#troubleshooting-parser-fragment)
### Tidak dapat mengakses satu frame dari aliran
Untuk mengakses satu frame dari sumber streaming di aplikasi konsumen Anda, verifikasi bahwa streaming Anda berisi data pribadi codec yang benar. Untuk informasi tentang format data dalam aliran, lihat[Model Data](how-data.md).
[Untuk mempelajari cara menggunakan data pribadi codec untuk mengakses bingkai, lihat file pengujian berikut di GitHub situs web: KinesisVideoRendererExampleTest .java](https://github.com/aws/amazon-kinesis-video-streams-parser-library/blob/master/src/test/java/com/amazonaws/kinesisvideo/parser/examples/KinesisVideoRendererExampleTest.java)
### Kesalahan decoding fragmen
Jika fragmen Anda tidak dikodekan dengan benar dalam format H.264 dan level yang didukung browser, Anda mungkin melihat kesalahan berikut saat memutar streaming di konsol:
```
Fragment Decoding Error
There was an error decoding the video data. Verify that the stream contains valid H.264 content
```
Jika ini terjadi, verifikasi yang berikut:
+ Resolusi frame cocok dengan resolusi yang ditentukan dalam Data Pribadi Codec.
+ Profil H.264 dan level frame yang dikodekan cocok dengan profil dan level yang ditentukan dalam Data Pribadi Codec.
+ Browser mendukung profile/level kombinasi. Sebagian besar browser saat ini mendukung semua kombinasi profil dan level.
+ Stempel waktu akurat dan dalam urutan yang benar, dan tidak ada cap waktu duplikat yang dibuat.
+ Aplikasi Anda menyandikan data bingkai menggunakan format H.264.
## Masalah jaringan
Jika Anda melihat kesalahan koneksi, seperti “Connection Timeout” atau “Connection Failed”, ketika mencoba untuk menyambung ke Kinesis Video Streams, mungkin karena pembatasan rentang alamat IP dalam pengaturan jaringan Anda.
[Jika pengaturan Anda memiliki batasan rentang alamat IP untuk Kinesis Video Streams, perbarui konfigurasi jaringan Anda untuk mengizinkan daftar rentang alamat IP Kinesis Video Streams.](https://ip-ranges.amazonaws.com/ip-ranges.json)
**penting**
Daftar rentang IP bukanlah daftar lengkap alamat IP Kinesis Video Streams. Sertakan rentang alamat IP yang Anda lihat dan perhatikan bahwa alamat IP dapat berubah seiring waktu.
Untuk informasi selengkapnya, lihat [rentang AWS IP](https://docs.aws.amazon.com//vpc/latest/userguide/aws-ip-ranges.html). Untuk diberi tahu saat rentang IP berubah, ikuti [prosedur berlangganan](https://docs.aws.amazon.com//vpc/latest/userguide/aws-ip-ranges.html#subscribe-notifications).