Amazon Kinesis Video Streams RTC SDK dengan JavaScript Web in untuk aplikasi web - Kinesis Video Streams
Instal SDKRTC JavaScript SDKDokumentasi webGunakan aplikasi RTC sampel WebEdit 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 Streams RTC SDK dengan JavaScript Web in untuk aplikasi web

Anda dapat menemukan Kinesis Video Streams RTC SDK dengan JavaScript Web di untuk aplikasi web dan sampel yang sesuai di. GitHub

Instal SDK

Apakah dan bagaimana Anda menginstal Kinesis Video Streams RTC SDK dengan JavaScript Web di tergantung pada apakah kode Node.js dijalankan dalam modul atau skrip browser.

NodeJS module

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

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

Untuk menginstal ini SDK 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 SDK kelas seperti modul Node.js biasa:

// 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 SDK paket yang dihosting langsung dari AWS dengan skrip di HTML halaman Anda.

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

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

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

Misalnya, window.KVSWebRTC.SignalingClient.

RTC JavaScript SDKDokumentasi web

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

Di bagian Penggunaan, ada informasi tambahan untuk mengintegrasikan ini SDK 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 RTC dengan Web 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.

Kinesis Video Streams RTC dengan aplikasi sampel Web terletak di. GitHub

Kode untuk aplikasi sampel ada di examples direktori.

Streaming peer-to-peer dari aplikasi sampel ke AWS Management Console

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

    • Wilayah AWS. Sebagai contoh,us-west-2.

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

    • 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 di 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.

    • RTCPenyerapan dan Penyimpanan Web. Perluas node dan pilih salah satu dari berikut ini:

      • Pilih Secara otomatis menentukan mode konsumsi.

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

        catatan

        Secara otomatis menentukan mode konsumsi memiliki panggilan aplikasi DescribeMediaStorageConfigurationAPIuntuk menentukan mode mana yang akan dijalankan (P eer-to-peer atau RTC konsumsi Web). APIPanggilan tambahan ini menambahkan sedikit waktu startup.

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

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

  2. Pilih Mulai Master untuk terhubung ke saluran pensinyalan.

    Izinkan akses ke kamera dan/atau mikrofon Anda, jika diperlukan.

  3. Buka konsol Kinesis Video Streams di AWS Management Console.

    Pastikan wilayah yang benar dipilih.

  4. Di navigasi kiri, pilih saluran pensinyalan.

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

  5. Perluas bagian Penampil pemutaran media.

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

    Media yang sedang dikirim pada halaman demo harus ditampilkan di AWS Management Console.

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

  1. Buka Kinesis Video Streams RTC dengan aplikasi sampel Web dan lengkapi informasi berikut:

    • Wilayah AWS. Sebagai contoh,us-west-2.

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

    • 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 di 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.

    • RTCPenyerapan dan Penyimpanan Web. Perluas node dan pilih salah satu dari berikut ini:

      • Pilih Secara otomatis menentukan mode konsumsi.

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

        catatan

        Secara otomatis menentukan mode konsumsi memiliki panggilan aplikasi DescribeMediaStorageConfigurationAPIuntuk menentukan mode mana yang akan dijalankan (P eer-to-peer atau RTC konsumsi Web). APIPanggilan tambahan ini menambahkan sedikit waktu startup.

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

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

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

    Izinkan akses ke kamera dan/atau mikrofon Anda, jika diperlukan.

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

  4. Gulir ke bawah dan pilih Mulai Penampil untuk terhubung ke saluran pensinyalan sebagai viewer peran.

    Anda harus melihat media dipertukarkan antara master danviewer.

Streaming peer-to-peer dengan Web RTC Ingetion dari halaman sampel ke halaman sampel

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

  2. Ikuti Tambahkan pemirsa ke sesi konsumsi untuk menambahkan peserta pemirsa.

    Peserta pemirsa akan terhubung 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 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 Kinesis Video Streams RTC SDK dengan Web 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 CLI perintah npm berikut di terminal:

    npm install

  4. Mulai server web untuk mulai melayani halaman web.

    Ketik CLI perintah npm berikut di terminal:

    npm run develop

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

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