View a markdown version of this page

Amazon Kinesis Video Streaming dengan WebRTC SDK masuk untuk aplikasi web JavaScript - Kinesis Video Streams
Instal SDKDokumentasi WebRTC SDK JavaScript Gunakan aplikasi sampel WebRTCEdit aplikasi sampel

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Amazon Kinesis Video Streaming dengan WebRTC SDK masuk untuk aplikasi web JavaScript

Anda dapat menemukan Streaming Video Kinesis dengan WebRTC SDK di JavaScript untuk aplikasi web dan sampel yang sesuai di. GitHub

Instal SDK

Apakah dan bagaimana Anda menginstal Kinesis Video Streams dengan WebRTC SDK JavaScript tergantung pada apakah kode dieksekusi dalam Node.js modul atau skrip browser.

NodeJS module

Cara yang lebih disukai untuk menginstal Kinesis Video Streams dengan WebRTC SDK JavaScript untuk Node.js adalah dengan menggunakan npm, manajer paket. Node.js

Paket dihosting di https://www.npmjs.com/package/amazon-kinesis-video-streams-webrtc.

Untuk menginstal SDK ini di Node.js proyek Anda, gunakan terminal untuk menavigasi ke direktori yang sama dengan proyek Andapackage.json:

Ketik berikut ini:

npm install amazon-kinesis-video-streams-webrtc

Anda dapat mengimpor kelas SDK seperti Node.js modul tipikal:

// JavaScript
const SignalingClient = require('amazon-kinesis-video-streams-webrtc').SignalingClient;
// TypeScript
import { SignalingClient } from 'amazon-kinesis-video-streams-webrtc';
Browser

Anda tidak perlu menginstal SDK untuk menggunakannya dalam skrip browser. Anda dapat memuat paket SDK yang dihosting langsung dari AWS skrip di halaman HTML Anda.

Untuk menggunakan SDK di browser, tambahkan elemen skrip berikut ke halaman HTML Anda:

<script src="https://unpkg.com/amazon-kinesis-video-streams-webrtc/dist/kvs-webrtc.min.js"></script>

Setelah SDK dimuat di halaman Anda, SDK tersedia dari variabel global KVSWebRTC (atauwindow.KVSWebRTC).

Misalnya, window.KVSWebRTC.SignalingClient.

Dokumentasi WebRTC SDK JavaScript

Dokumentasi untuk metode SDK ada di GitHub readme, di bawah Dokumentasi.

Di bagian Penggunaan, ada informasi tambahan untuk mengintegrasikan SDK ini bersama dengan AWS SDK JavaScript untuk membangun aplikasi penampil berbasis web.

Lihat examples direktori untuk contoh aplikasi lengkap, termasuk peran master dan penampil.

Gunakan aplikasi sampel

Kinesis Video Streams dengan WebRTC juga menghosting aplikasi sampel yang dapat Anda gunakan untuk membuat saluran pensinyalan baru atau terhubung ke saluran yang ada dan menggunakannya sebagai master atau penampil.

Aplikasi sampel Streaming Video Kinesis dengan WebRTC terletak di. GitHub

Kode untuk aplikasi sampel ada di examples direktori.

Streaming peer-to-peer dari aplikasi sampel ke Konsol Manajemen AWS

  1. Buka aplikasi sampel Kinesis Video Streams dengan WebRTC dan lengkapi yang berikut ini:

    • Wilayah AWS. Misalnya,us-west-2.

    • K AWS unci akses dan kunci rahasia untuk pengguna atau peran IAM Anda. Biarkan token sesi kosong jika Anda menggunakan AWS kredenSIAL jangka panjang.

    • Nama saluran pensinyalan yang ingin Anda sambungkan.

      Jika Anda ingin terhubung ke saluran pensinyalan baru, pilih Buat Saluran untuk membuat saluran pensinyalan dengan nilai yang disediakan dalam kotak.

      catatan

      Nama saluran pensinyalan Anda harus unik untuk akun dan wilayah saat ini. Anda dapat menggunakan huruf, angka, garis bawah (_), dan tanda hubung (-), tetapi bukan spasi.

    • Apakah Anda ingin mengirim audio, video, atau keduanya.

    • Penyerapan dan Penyimpanan WebRTC. Perluas simpul dan pilih salah satu dari berikut ini:

      • Pilih Secara otomatis menentukan mode konsumsi.

      • Pastikan mode otomatis menentukan konsumsi tidak dipilih dan setel penggantian manual ke OFF.

        catatan

        Secara otomatis menentukan mode konsumsi memiliki aplikasi memanggil DescribeMediaStorageConfiguration API untuk menentukan mode mana yang akan dijalankan (Peer-to-peer atau penyerapan WebRTC). Panggilan API tambahan ini menambahkan sedikit waktu startup.

        Jika Anda tahu sebelumnya mode mana saluran pensinyalan ini berjalan, gunakan penggantian manual untuk melewati panggilan API ini.

    • Generasi kandidat ICE. BiarkanSTUN/TURNdipilih dan biarkan Trickle ICE diaktifkan.

  2. Pilih Start Master untuk terhubung ke saluran pensinyalan.

    Izinkan akses ke and/or mikrofon kamera Anda, jika diperlukan.

  3. Buka konsol Kinesis Video Streams di Konsol Manajemen AWS.

    Pastikan wilayah yang benar dipilih.

  4. Di navigasi kiri, pilih saluran pensinyalan .

    Pilih nama saluran pensinyalan di atas. Gunakan bilah pencarian, jika diperlukan.

  5. Perluas bagian penampil pemutaran media.

  6. Pilih tombol putar pada pemutar video. Ini bergabung dengan sesi WebRTC sebagai. viewer

    Media yang dikirim pada halaman demo harus ditampilkan di Konsol Manajemen AWS.

Streaming peer-to-peer dari aplikasi sampel ke aplikasi sampel

  1. Buka aplikasi contoh Stre ams Video Kinesis dengan WebRTC dan lengkapi informasi berikut:

    • Wilayah AWS. Misalnya,us-west-2.

    • K AWS unci akses dan kunci rahasia untuk pengguna atau peran IAM Anda. Biarkan token sesi kosong jika Anda menggunakan AWS kredenSIAL jangka panjang.

    • Nama saluran pensinyalan yang ingin Anda sambungkan.

      Jika Anda ingin terhubung ke saluran pensinyalan baru, pilih Buat Saluran untuk membuat saluran pensinyalan dengan nilai yang disediakan dalam kotak.

      catatan

      Nama saluran pensinyalan Anda harus unik untuk akun dan wilayah saat ini. Anda dapat menggunakan huruf, angka, garis bawah (_), dan tanda hubung (-), tetapi bukan spasi.

    • Apakah Anda ingin mengirim audio, video, atau keduanya.

    • Penyerapan dan Penyimpanan WebRTC. Perluas simpul dan pilih salah satu dari berikut ini:

      • Pilih Secara otomatis menentukan mode konsumsi.

      • Pastikan mode otomatis menentukan konsumsi tidak dipilih dan setel penggantian manual ke OFF.

        catatan

        Secara otomatis menentukan mode konsumsi memiliki aplikasi memanggil DescribeMediaStorageConfiguration API untuk menentukan mode mana yang akan dijalankan (Peer-to-peer atau penyerapan WebRTC). Panggilan API tambahan ini menambahkan sedikit waktu startup.

        Jika Anda tahu sebelumnya mode mana saluran pensinyalan ini berjalan, gunakan penggantian manual untuk melewati panggilan API ini.

    • Generasi kandidat ICE. BiarkanSTUN/TURNdipilih dan biarkan Trickle ICE diaktifkan.

  2. Pilih Start Master untuk terhubung ke saluran pensinyalan sebagai master peran.

    Izinkan akses ke and/or mikrofon kamera Anda, jika diperlukan.

  3. Buka tab browser lain dan buka Kinesis Video Streams dengan aplikasi sampel WebRTC. Semua informasi dari proses sebelumnya harus dimuat.

  4. Gulir ke bawah dan pilih Start Viewer untuk terhubung ke saluran pensinyalan sebagai viewer peran.

    Anda harus melihat media yang dipertukarkan antara master danviewer.

Streaming peer-to-peer dengan WebRTC Insertion dari halaman sampel ke halaman sampel

  1. Ikuti Mengambil media dari browser untuk menghubungkan peserta master dan pastikan itu terhubung ke sesi penyimpanan.

  2. Ikuti Menambahkan pemirsa ke sesi penyerapan untuk menambahkan peserta pemirsa.

    Peserta penampil akan terhubung ke dan menerima media dari sesi penyimpanan. Mereka dapat mengirim audio opsional kembali ke sesi penyimpanan.

    Sesi penyimpanan menangani pencampuran media yang diterima dari peserta master dan pemirsa dan mengirimkannya ke tujuan yang sesuai.

  3. Anda dapat melihat dan menggunakan media yang dicerna melalui pemutaran https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/how-playback.html Kinesis Video Streams.

Edit aplikasi sampel

Untuk mengedit SDK dan contoh aplikasi untuk tujuan pengembangan, ikuti petunjuk di bawah ini.

Prasyarat

NodeJS versi 16+

catatan

Kami merekomendasikan mengunduh versi dukungan jangka panjang (LTS) terbaru dari https://nodejs.org/en/download.

Edit aplikasi sampel

  1. Unduh Streaming Video Kinesis dengan WebRTC SDK di. JavaScript

    Ketik yang berikut ini di terminal:

    git clone https://github.com/awslabs/amazon-kinesis-video-streams-webrtc-sdk-js.git

  2. Arahkan ke direktori dengan file package.json. File ini terletak di direktori root repositori.

    Ketik yang berikut ini di terminal:

    cd amazon-kinesis-video-streams-webrtc-sdk-js

  3. Instal dependensi.

    Ketik perintah npm CLI berikut di terminal:

    npm install

  4. Mulai server web untuk mulai melayani halaman web.

    Ketik perintah npm CLI berikut di terminal:

    npm run develop

  5. Di browser Anda, kunjungi:3001/ http://localhost.

    Anda dapat mengedit halaman web dengan mengedit file di examples direktori.