

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

# Menelan media
<a name="ingest-media"></a>

Batasan berikut sudah ada: 
+ **Durasi sesi:** satu jam, maksimal
+ **Saluran pensinyalan:** maksimum 100 per akun dengan konfigurasi penyimpanan diaktifkan

**Topics**
+ [Menelan media dari browser](#ingest-browser)
+ [Menelan media dari WebRTC C SDK](#ingest-webrtc-sdk)
+ [Tambahkan pemirsa ke sesi konsumsi](#ingest-add-viewers)

## Menelan media dari browser
<a name="ingest-browser"></a>

**penting**  
Chrome saat ini adalah satu-satunya browser yang didukung.

1. [Buka Amazon Kinesis Video Streams dengan WebRTC SDK di halaman contoh. JavaScript ](https://awslabs.github.io/amazon-kinesis-video-streams-webrtc-sdk-js/examples/index.html)

1. Lengkapi informasi berikut:
   + **KVS Endpoint** - Di bidang **Region**, pilih wilayah Anda. 

     Misalnya, `us-west-2`.
   + **AWS Kredensialnya**

     Lengkapi bidang berikut:
     + **ID Kunci Akses**
     + **Kunci Akses Rahasia**
     + **Token Sesi** - Aplikasi sampel mendukung kredensyal sementara dan jangka panjang. Biarkan bidang ini kosong jika Anda menggunakan kredensi IAM jangka panjang. Lihat [Kredensi keamanan sementara di IAM](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_credentials_temp.html) untuk informasi selengkapnya.
   + **Saluran Sinyal** - Di bidang **Nama Saluran**, ketik nama saluran pensinyalan yang Anda konfigurasikan sebelumnya. Untuk informasi selengkapnya, lihat [Konfigurasikan tujuan](configure-ingestion.md).
   + **Trek** - Pilih **Kirim Video** dan **Kirim Audio**.
   + **WebRTC Ingestion and Storage - Perluas node dan pilih** **Secara otomatis menentukan mode konsumsi.** Opsi ini membuat aplikasi sampel memanggil [DescribeMediaStorageConfiguration](https://docs.aws.amazon.com//kinesisvideostreams/latest/dg/API_DescribeMediaStorageConfiguration.html)API untuk menentukan mode mana yang akan dijalankan.

1. Pilih **Mulai Master**.

   Jika saluran pensinyalan dikonfigurasi untuk konsumsi menggunakan [DescribeMediaStorageConfiguration](https://docs.aws.amazon.com//kinesisvideostreams/latest/dg/API_DescribeMediaStorageConfiguration.html)API, aplikasi sampel akan secara otomatis memanggil [JoinStorageSession](https://docs.aws.amazon.com//kinesisvideostreams/latest/dg/API_webrtc_JoinStorageSession.html)API segera setelah tersambung ke saluran Signaling untuk memulai alur kerja penyerapan WebRTC.

## Menelan media dari WebRTC C SDK
<a name="ingest-webrtc-sdk"></a>

Ikuti [Amazon Kinesis Video Streams dengan WebRTC SDK di C untuk perangkat yang disematkan](kvswebrtc-sdk-c.md) prosedur untuk membangun aplikasi sampel.

1. Siapkan lingkungan Anda dengan Akun AWS kredensi Anda:

   ```
   export AWS_ACCESS_KEY_ID=YourAccessKey
   export AWS_SECRET_ACCESS_KEY=YourSecretKey
   export AWS_DEFAULT_REGION=YourAWSRegion
   ```

   Jika Anda menggunakan AWS kredensil sementara, ekspor juga token sesi Anda:

   ```
   export AWS_SESSION_TOKEN=YourSessionToken
   ```

1. Jalankan sampel:

   **Sampel master**

   Arahkan ke `build` folder dan gunakan “1" sebagai argumen kedua. Jenis:

   ```
   ./samples/kvsWebrtcClientMaster channel-name 1
   ```

   **GStreamer sampel master**

   Arahkan ke `build` folder dan gunakan audio-video-storage "" sebagai argumen kedua. Jenis:

   ```
   ./samples/kvsWebrtcClientMasterGstSample channel-name audio-video-storage testsrc
   ```

Ini memulai konsumsi WebRTC. 

**catatan**  
Saluran pensinyalan yang disediakan harus dikonfigurasi untuk penyimpanan. Gunakan [DescribeMediaStorageConfiguration](https://docs.aws.amazon.com//kinesisvideostreams/latest/dg/API_DescribeMediaStorageConfiguration.html)API untuk mengonfirmasi.

## Tambahkan pemirsa ke sesi konsumsi
<a name="ingest-add-viewers"></a>

Setelah saluran pensinyalan berada dalam mode WebRTC Ingestion, peserta pemirsa tidak lagi terhubung langsung ke peserta utama. Peserta penampil terhubung langsung ke sesi penyimpanan. Peserta pemirsa menerima media yang dikirim oleh peserta utama, dan peserta pemirsa dapat mengirim kembali audio opsional ke peserta utama. Setiap audio yang dikirim kembali oleh pemirsa akan dikirim ke semua rekan lain yang terhubung ke sesi penyimpanan dan dicerna ke Kinesis Video Stream, selama peserta utama terhubung ke sesi penyimpanan.

Batasan berikut sudah ada:
+ **Jumlah maksimum pemirsa:** 3 
+ **Waktu maksimum peserta penampil dapat dihubungkan ke sesi penyimpanan tanpa peserta master hadir:** 3 menit 

**penting**  
Jika pemirsa terputus dari sesi penyimpanan (menutup koneksi rekan), kuota mereka (batas penampil) tetap dikonsumsi selama 1 menit. Selama periode 1 menit ini, pemirsa dapat memanggil API ini dengan ID Klien yang sama untuk bergabung kembali dengan sesi tanpa menggunakan kuota penampil tambahan. Setelah 1 menit, kuota pemirsa dirilis dan tersedia bagi pemirsa lain untuk bergabung.

**Browser**

**penting**  
Chrome adalah satu-satunya browser yang didukung.

1. [Buka tab lain di Amazon Kinesis Video Streams dengan WebRTC SDK di halaman contoh. JavaScript ](https://awslabs.github.io/amazon-kinesis-video-streams-webrtc-sdk-js/examples/index.html) Semua informasi dari halaman sebelumnya akan diisi secara otomatis. Jika tidak, lengkapi informasi berikut:
   + **KVS Endpoint** - Di bidang **Region**, pilih wilayah Anda. 

     Misalnya, `us-west-2`.
   + **AWS Kredensialnya**

     Lengkapi bidang-bidang berikut:
     + **ID Kunci Akses**
     + **Kunci Akses Rahasia**
     + **Token Sesi** - Aplikasi sampel mendukung kredensyal sementara dan jangka panjang. Biarkan bidang ini kosong jika Anda menggunakan kredensi IAM jangka panjang. Lihat [Kredensi keamanan sementara di IAM](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_credentials_temp.html) untuk informasi selengkapnya.
   + **Saluran Sinyal** - Di bidang **Nama Saluran**, ketik nama saluran pensinyalan yang Anda konfigurasikan sebelumnya. Untuk informasi selengkapnya, lihat [Konfigurasikan tujuan](configure-ingestion.md).
   + **Trek** - Pilih **Kirim Audio**. Perhatikan bahwa jika **Kirim Video** dicentang, secara otomatis akan dihapus centang saat memilih **Mulai Penampil**.
   + **WebRTC Ingestion and Storage - Perluas node dan pilih** **Secara otomatis menentukan mode konsumsi.** Opsi ini membuat aplikasi sampel memanggil [DescribeMediaStorageConfiguration](https://docs.aws.amazon.com//kinesisvideostreams/latest/dg/API_DescribeMediaStorageConfiguration.html)API untuk menentukan mode mana yang akan dijalankan.

1. Pilih **Mulai Penampil**.

   Aplikasi secara otomatis memanggil [JoinStorageSessionAsViewer](https://docs.aws.amazon.com//kinesisvideostreams/latest/dg/API_webrtc_JoinStorageSessionAsViewer.html)API segera setelah terhubung ke saluran pensinyalan untuk memicu penawaran SDP yang dikirim ke pemirsa dari sesi.

**catatan**  
Dengan peer-to-peer WebRTC, peserta pemirsa adalah rekan pengendali dan peserta utama adalah rekan yang dikendalikan. Dalam mode konsumsi WebRTC, sesi penyimpanan sekarang menjadi rekan pengendali. Setelah terhubung ke pensinyalan dan pemanggilan [JoinStorageSessionAsViewer](https://docs.aws.amazon.com//kinesisvideostreams/latest/dg/API_webrtc_JoinStorageSessionAsViewer.html), penampil harus menanggapi penawaran SDP dan membuat koneksi ke sesi penyimpanan melalui WebRTC.

**catatan**  
Sesi penyimpanan hanya akan mengirim `TURN` kandidat. Saat mencalonkan pasangan kandidat ICE dari sudut pandang peserta, kandidat jarak jauh akan selalu bertipe. `relay`