Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Pemutaran video dengan HLS
HTTPLive Streaming (HLS)
Anda dapat menggunakan HLS untuk pemutaran langsung. Latensi biasanya antara 3-5 detik, tetapi bisa antara 1-10 detik, tergantung pada kasus penggunaan, pemain, dan kondisi jaringan. Anda dapat menggunakan pemutar pihak ketiga (seperti Video.js
Untuk melihat aliran video Kinesis menggunakanHLS, pertama buat sesi streaming menggunakan G etHLSStreaming Session. URL Tindakan ini mengembalikan URL (berisi token sesi) untuk mengakses HLS sesi. Anda kemudian dapat menggunakan URL dalam pemutar media atau aplikasi mandiri untuk menampilkan aliran.
penting
Tidak semua media yang dikirim ke Kinesis Video Streams dapat diputar ulang. HLS Lihat GetHLSStreamingSessionURL untuk persyaratan pengunggahan khusus.
Topik
Gunakan AWS CLI untuk mengambil sesi HLS streaming URL
Ikuti prosedur di bawah ini untuk menggunakan AWS CLI untuk menghasilkan sesi HLS streaming URL untuk aliran video Kinesis.
Untuk petunjuk penginstalan, lihat Panduan AWS Command Line Interface Pengguna. Setelah instalasi, konfigurasikan AWS CLI dengan kredensil dan wilayah.
Atau, buka AWS CloudShell terminal, yang telah AWS CLI diinstal dan dikonfigurasi. Lihat Panduan AWS CloudShell Pengguna untuk informasi selengkapnya.
Ambil HLS URL titik akhir untuk aliran video Kinesis Anda.
Ketik berikut ini ke terminal:
aws kinesisvideo get-data-endpoint \ --api-name GET_HLS_STREAMING_SESSION_URL \ --stream-nameYourStreamNameAnda akan menerima respons yang terlihat seperti ini:
{ "DataEndpoint": "https://b-1234abcd.kinesisvideo.aws-region.amazonaws.com" }Buat URL permintaan sesi HLS streaming ke titik akhir yang dikembalikan.
Anda akan menerima respons yang terlihat seperti ini:
{ "HLSStreamingSessionURL": "https://b-1234abcd.kinesisvideo.aws-region.amazonaws.com/hls/v1/getHLSMasterPlaylist.m3u8?SessionToken=CiAz...DkRE6M~" }penting
Jangan berbagi atau menyimpan token ini di mana entitas yang tidak berwenang dapat mengaksesnya. Token menyediakan akses ke konten aliran. Lindungi token dengan tindakan yang sama yang akan Anda gunakan dengan kredensil Anda. AWS
Anda dapat menggunakan ini URL dan HLS pemain mana pun untuk melihat HLS aliran.
Misalnya, gunakan pemutar VLC media.
Anda juga dapat memutar HLS Stream dengan memasuki sesi HLS streaming URL di bilah Lokasi browser Apple Safari atau Microsoft Edge.
Contoh: Gunakan HLS di HTML dan JavaScript
Contoh berikut menunjukkan cara menggunakan AWS SDK for JavaScript v2 untuk mengambil sesi HLS streaming untuk aliran video Kinesis dan memutarnya kembali di halaman web. Contoh menunjukkan cara memutar video di pemain berikut:
Lihat kode contoh lengkap
Kode berjalan melalui topik:
Impor AWS SDK for JavaScript untuk browser
Di halaman web, sertakan tag skrip berikut untuk mengimpor AWS SDK for JavaScript v2 ke dalam proyek.
<script src="https://cdnjs.cloudflare.com/ajax/libs/aws-sdk/2.490.0/aws-sdk.min.js"></script>
Untuk informasi lebih lanjut, lihat JavaScript dokumentasi AWS SDKuntuk.
Siapkan klien Kinesis Video Streams
Untuk mengakses streaming video denganHLS, pertama-tama buat dan konfigurasikan klien Kinesis Video Streams. Lihat Menyetel Kredensial di Browser Web untuk metode otentikasi lainnya.
const clientConfig = { accessKeyId: 'YourAccessKey', secretAccessKey: 'YourSecretKey', region: 'us-west-2' }; const kinesisVideoClient = new AWS.KinesisVideo(clientConfig);
Aplikasi mengambil nilai yang diperlukan dari kotak input pada HTML halaman.
Ambil titik akhir untuk pemutaran HLS
Gunakan klien Kinesis Video Streams untuk GetDataEndpoint API memanggil untuk mengambil titik akhir.
const getDataEndpointOptions = { StreamName: 'YourStreamName', APIName: 'GET_HLS_STREAMING_SESSION_URL' }; const getDataEndpointResponse = await kinesisVideoClient .getDataEndpoint(getDataEndpointOptions) .promise(); const hlsDataEndpoint = getDataEndpointResponse.DataEndpoint;
Kode ini menyimpan titik akhir dalam hlsDataEndpoint variabel.
Siapkan klien media yang diarsipkan Kinesis Video Streams
Dalam konfigurasi klien untuk klien media yang diarsipkan Kinesis Video Streams, tentukan titik akhir yang Anda peroleh pada langkah sebelumnya.
const archivedMediaClientConfig = { accessKeyId: 'YourAccessKey', secretAccessKey: 'YourSecretKey', region: 'us-west-2', endpoint: hlsDataEndpoint }; const kinesisVideoArchivedMediaClient = new AWS.KinesisVideoArchivedMedia(archivedMediaClientConfig);
Ambil sesi HLS streaming URL
Gunakan klien media yang diarsipkan Kinesis Video Streams untuk GetHLSStreamingSessionURL API memanggil untuk mengambil pemutaran. HLS URL
const getHLSStreamingSessionURLOptions = { StreamName: 'YourStreamName', PlaybackMode: 'LIVE' }; const getHLSStreamingSessionURLResponse = await kinesisVideoArchivedMediaClient .getHLSStreamingSessionURL(getHLSStreamingSessionURLOptions) .promise(); const hlsUrl = getHLSStreamingSessionURLResponse.HLSStreamingSessionURL;
Tampilkan HLS aliran di halaman web
Saat Anda memiliki sesi HLS streamingURL, berikan ke pemutar video. Metode untuk menyediakan URL ke pemutar video khusus untuk pemutar yang digunakan.
Memecahkan masalah HLS
Bagian ini menjelaskan masalah yang mungkin Anda temui saat menggunakan Streaming HTTP Langsung (HLS) dengan Kinesis Video Streams.
Masalah
Mengambil sesi HLS streaming URL berhasil, tetapi pemutaran gagal di pemutar video
Situasi ini terjadi ketika Anda berhasil mengambil sesi HLS streaming URL menggunakanGetHLSStreamingSessionURL, tetapi video gagal diputar kembali ketika URL disediakan untuk pemutar video.
Untuk mengatasi masalah ini, coba yang berikut ini:
-
Tentukan apakah aliran video diputar kembali di konsol Kinesis Video Streams. Pertimbangkan kesalahan apa pun yang ditampilkan konsol.
-
Jika durasi fragmen kurang dari satu detik, tingkatkan menjadi satu detik. Jika durasi fragmen terlalu pendek, layanan mungkin membatasi pemutar karena terlalu sering membuat permintaan untuk fragmen video.
-
Verifikasi bahwa setiap sesi HLS URL streaming hanya digunakan oleh satu pemain. Jika lebih dari satu pemain menggunakan satu sesi HLS streamingURL, layanan mungkin menerima terlalu banyak permintaan dan mencekatnya.
-
Verifikasi bahwa pemain Anda mendukung semua opsi yang Anda tentukan untuk sesi HLS streaming. Coba kombinasi nilai yang berbeda untuk parameter berikut:
-
ContainerFormat -
PlaybackMode -
FragmentSelectorType -
DiscontinuityMode -
MaxMediaPlaylistFragmentResults
Beberapa pemutar media (seperti HTML5 dan pemutar seluler) biasanya hanya mendukung HLS dengan format MP4 wadah f. Pemutar media lain (seperti Flash dan pemutar khusus) mungkin hanya mendukung HLS dengan format wadah MPEG TS. Kami merekomendasikan bereksperimen dengan
ContainerFormatparameter untuk memulai pemecahan masalah. -
-
Verifikasi bahwa setiap fragmen memiliki jumlah trek yang konsisten. Verifikasi bahwa fragmen dalam aliran tidak berubah antara memiliki trek audio dan video dan hanya trek video. Juga verifikasi bahwa pengaturan encoder (resolusi dan frame rate) tidak berubah antara fragmen di setiap trek.
Latensi terlalu tinggi antara produser dan pemain
Situasi ini terjadi ketika latensi terlalu tinggi dari saat video ditangkap hingga saat diputar di pemutar video.
Video diputar kembali HLS berdasarkan per-fragmen. Oleh karena itu, latensi tidak boleh kurang dari durasi fragmen. Latensi juga mencakup waktu yang dibutuhkan untuk buffering dan transfer data. Jika solusi Anda membutuhkan latensi kurang dari satu detik, pertimbangkan untuk menggunakan GetMedia API sebagai gantinya.
Anda dapat menyesuaikan parameter berikut untuk mengurangi latensi keseluruhan, tetapi menyesuaikan parameter ini juga dapat mengurangi kualitas video atau meningkatkan laju rebuffering.
-
Durasi fragmen — Durasi fragmen adalah jumlah video antar divisi dalam aliran yang dikendalikan oleh frekuensi keyframe yang dihasilkan oleh encoder video. Nilai yang disarankan adalah satu detik. Memiliki durasi fragmen yang lebih pendek berarti lebih sedikit waktu yang dihabiskan untuk menunggu fragmen selesai sebelum mengirimkan data video ke layanan. Fragmen yang lebih pendek juga lebih cepat untuk diproses oleh layanan. Namun, jika durasi fragmen terlalu pendek, probabilitas meningkat bahwa pemain akan kehabisan konten dan harus berhenti dan menyangga konten. Jika durasi fragmen kurang dari 500 milidetik, produsen mungkin membuat terlalu banyak permintaan, menyebabkan layanan mencekatnya.
-
Bitrate — Streaming video dengan bitrate lebih rendah membutuhkan waktu lebih sedikit untuk membaca, menulis, dan mengirimkan. Namun, streaming video dengan bitrate lebih rendah biasanya memiliki kualitas video yang lebih rendah.
-
Jumlah fragmen dalam daftar putar media — Pemutar yang sensitif terhadap latensi hanya boleh memuat fragmen terbaru dalam daftar putar media. Sebagian besar pemain mulai dari fragmen paling awal sebagai gantinya. Dengan mengurangi jumlah fragmen dalam daftar putar, Anda mengurangi pemisahan waktu antara fragmen sebelumnya dan baru. Dengan ukuran playlist yang lebih kecil, fragmen dapat dilewati selama pemutaran jika ada penundaan dalam menambahkan fragmen baru ke daftar putar, atau jika ada penundaan pemain mendapatkan daftar putar yang diperbarui. Sebaiknya gunakan 3-5 fragmen, dan gunakan pemutar yang dikonfigurasi untuk memuat hanya fragmen terbaru dari daftar putar.
-
Ukuran buffer pemutar — Sebagian besar pemutar video memiliki durasi buffer minimum yang dapat dikonfigurasi, biasanya dengan default 10 detik. Untuk latensi terendah, Anda dapat mengatur nilai ini menjadi 0 detik. Namun, melakukannya berarti pemain menolak jika ada penundaan menghasilkan fragmen karena pemain tidak akan memiliki buffer untuk menyerap penundaan.
-
Player “catch up” - Pemutar video biasanya tidak secara otomatis menangkap pemutaran ke bagian depan buffer video jika buffer terisi, seperti ketika fragmen yang tertunda menyebabkan backlog fragmen diputar. Pemain khusus dapat menghindari hal ini dengan menjatuhkan bingkai, atau meningkatkan kecepatan pemutaran (misalnya, menjadi 1.1x) untuk mengejar bagian depan buffer. Hal ini menyebabkan pemutaran menjadi berombak atau peningkatan kecepatan saat pemain mengejar, dan rebuffering mungkin lebih sering karena ukuran buffer tetap pendek.
