

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

# Hubungkan ke sesi penyimpanan
<a name="ingestion-initiate"></a>

Ikuti prosedur ini untuk membuat sesi penyimpanan dan memulai proses koneksi WebRTC. Peserta master harus menelepon [ JoinStorageSession](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_webrtc_JoinStorageSession.html). Peserta pemirsa harus menelepon [ JoinStorageSessionAsViewer](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_webrtc_JoinStorageSessionAsViewer.html). 

Ini akan membuat sesi penyimpanan mengirim penawaran SDP dan kandidat ICE melalui pensinyalan ke peserta master yang terhubung melalui[ConnectAsMaster](ConnectAsMaster.md), atau peserta pemirsa tertentu yang terhubung melalui[ConnectAsViewer](ConnectAsViewer.md). 

1. Dapatkan ARN dari saluran pensinyalan, karena ini adalah input yang diperlukan untuk langkah berikutnya. Jika Anda sudah tahu ARN, lanjutkan dengan langkah berikutnya.

------
#### [ Konsol Manajemen AWS ]

   1. Buka konsol [https://console.aws.amazon.com/kinesisvideo/home/#/signalingChannels](https://console.aws.amazon.com/kinesisvideo/home/#/signalingChannels) Kinesis Video Streams Signaling Channels.

   1. Pilih nama saluran pensinyalan Anda.

   1. Di bawah ** tab Info saluran ** sinyal, cari ARN untuk saluran pensinyalan Anda.

------
#### [ AWS CLI ]

   Verifikasi bahwa Anda telah AWS CLI menginstal dan dikonfigurasi. Untuk informasi selengkapnya, silakan lihat [Panduan Pengguna AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/).

   Untuk petunjuk pemasangan, lihat Panduan [AWS Command Line Interface Pengguna](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html#getting-started-install-instructions). Setelah instalasi, [ konfigurasikan AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-quickstart.html#getting-started-quickstart-new) dengan kredenSIAL dan wilayah.

   Atau, buka AWS CloudShell terminal, yang telah AWS CLI diinstal dan dikonfigurasi. Lihat Panduan [AWS CloudShell Pengguna ](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html#how-to-get-started) untuk informasi lebih lanjut.

   Jalankan [ Describe-Signaling-Channel ](https://docs.aws.amazon.com/cli/latest/reference/kinesisvideo/describe-signaling-channel.html) perintah berikut menggunakan AWS CLI:

   ```
   aws kinesisvideo describe-signaling-channel \
     --channel-name "{{YourChannelName}}" \
   ```

   Tanggapannya akan terlihat seperti berikut:

   ```
   {
       "ChannelInfo": {
           "ChannelName": "{{YourChannelName}}",
           "ChannelARN": "arn:aws:kinesisvideo:{{us-west-2}}:{{123456789012}}:channel/{{YourChannelName}}/{{1234567890123}}",
           "ChannelType": "SINGLE_MASTER", 
           "ChannelStatus": "ACTIVE",
           "CreationTime": "{{2024-07-07T23:28:24.941000-07:00}}",
           "SingleMasterConfiguration": {
           "MessageTtlSeconds": 60
       },
       "Version": "{{Ws0fZvFGXzEpuZ2CE1s9}}"
       }
   }
   ```

   Anda akan menemukan saluran pensinyalan ARN di `ChannelInfo` objek.

------
#### [ AWS SDK ]

   Cuplikan kode ini menunjukkan cara membuat Streams Video Kinesis dengan saluran pensinyalan WebRTC menggunakan SDK untuk v2. AWS JavaScript Sintaks akan berbeda dari AWS SDK lain, tetapi alur umumnya akan sama. 

   Anda dapat melihat contoh kode lengkap untuk [ JoinStorageSession ](https://github.com/awslabs/amazon-kinesis-video-streams-webrtc-sdk-js/blob/master/examples/joinStorageSession.js) atau [ JoinStorageSessionAsViewer](https://github.com/awslabs/amazon-kinesis-video-streams-webrtc-sdk-js/blob/master/examples/joinStorageSessionAsViewer.js).

   Buat klien Kinesis Video Streams. Ini digunakan untuk memanggil [ DescribeSignalingChannel API](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_DescribeSignalingChannel.html).

   ```
   const clientConfig = {
       accessKeyId: '{{YourAccessKey}}',
       secretAccessKey: '{{YourSecretKey}}',
       region: '{{us-west-2}}'
   };
   const kinesisVideoClient = new AWS.KinesisVideo(clientConfig);
   ```

   Gunakan klien untuk memanggil `DescribeSignalingChannel` API.

   ```
   const describeSignalingChannelResponse = await kinesisVideoClient
       .describeSignalingChannel({
           ChannelName: '{{YourChannelName'}},
       })
       .promise();
   ```

   Simpan tanggapannya.

   ```
   const channelARN =
       describeSignalingChannelResponse.ChannelInfo.ChannelARN;
   ```

------

1. Dapatkan titik akhir WEBRTC. Permintaan ke [ JoinStorageSession ](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_webrtc_JoinStorageSession.html) atau [ JoinStorageSessionAsViewer ](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_webrtc_JoinStorageSessionAsViewer.html) untuk saluran pensinyalan tertentu harus dibuat ke titik akhir yang ditunjuk.

------
#### [ Konsol Manajemen AWS ]

**catatan**  
Operasi ini saat ini tidak didukung di Stre Konsol Manajemen AWS aming Video Kinesis.

   Buka AWS CloudShell terminal, yang telah AWS CLI diinstal dan dikonfigurasi. Lihat Panduan [AWS CloudShell Pengguna ](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html#how-to-get-started) untuk informasi selengkapnya. 

   Ikuti instruksi di AWS CLI tab.

------
#### [ AWS CLI ]

   Verifikasi bahwa Anda telah AWS CLI menginstal dan dikonfigurasi. Untuk informasi selengkapnya, lihat [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/) dokumentasi.

   Untuk petunjuk pemasangan, lihat Panduan [AWS Command Line Interface Pengguna](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html#getting-started-install-instructions). Setelah instalasi, [ konfigurasikan AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-quickstart.html#getting-started-quickstart-new) dengan kredenSIAL dan wilayah.

   Atau, buka AWS CloudShell terminal, yang telah AWS CLI diinstal dan dikonfigurasi. Lihat Panduan [AWS CloudShell Pengguna ](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html#how-to-get-started) untuk informasi lebih lanjut.

   Jalan `Get-Signaling-Channel-Endpoint` kan perintah di AWS CLI:

   ```
   aws kinesisvideo get-signaling-channel-endpoint \
     --channel-arn "arn:aws:kinesisvideo:{{us-west-2}}:{{123456789012}}:channel/{{YourChannelName}}/{{1234567890123}}" \
     --single-master-channel-endpoint-configuration "Protocols=['WEBRTC'],Role={{MASTER}}" \
     --region "{{us-west-2}}"
   ```

   Responsnya terlihat seperti berikut ini:

   ```
   {
       "ResourceEndpointList": [
           {
               "Protocol": "WEBRTC",
               "ResourceEndpoint": "https://w-{{abcd1234}}.kinesisvideo.{{aws-region}}.amazonaws.com"
           } 
       ]
   }
   ```

------
#### [ AWS SDK ]

   Cuplikan kode ini menunjukkan cara memanggil `GetSignalingChannelEndpoint` API untuk Streams Video Kinesis dengan saluran pensinyalan WebRTC menggunakan SDK untuk v2. AWS JavaScript Sintaks akan berbeda dari AWS SDK lain, tetapi alur umumnya akan sama. Lihat contoh kode lengkap untuk [ JoinStorageSession ](https://github.com/awslabs/amazon-kinesis-video-streams-webrtc-sdk-js/blob/master/examples/joinStorageSession.js) atau [ JoinStorageSessionAsViewer](https://github.com/awslabs/amazon-kinesis-video-streams-webrtc-sdk-js/blob/master/examples/joinStorageSessionAsViewer.js).

   Buat klien Kinesis Video Streams. Ini adalah klien yang digunakan untuk memanggil [ DescribeSignalingChannel API](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_DescribeSignalingChannel.html). 

   Jika Anda membuat klien Kinesis Video Streams sebelumnya untuk menelepon`DescribeSignalingChannel`, Anda dapat menggunakan kembali klien yang sama.

   ```
   const clientConfig = {
       accessKeyId: '{{YourAccessKey}}',
       secretAccessKey: '{{YourSecretKey}}',
       region: '{{us-west-2}}'
   };
   const kinesisVideoClient = new AWS.KinesisVideo(clientConfig);
   ```

   Gunakan klien untuk memanggil `GetSignalingChannelEndpoint` API.

   ```
   const getSignalingChannelEndpointResponse = await kinesisVideoClient
       .getSignalingChannelEndpoint({
           ChannelARN: {{channelARN}},
           SingleMasterChannelEndpointConfiguration: {
               Protocols: ['WEBRTC'],
               Role: '{{MASTER'}},
           },
       })
       .promise();
   ```

   Simpan tanggapan:

   ```
   const webrtcEndpoint = getSignalingChannelEndpointResponse.ResourceEndpointList[0].ResourceEndpoint;
   ```

------

1. Gunakan saluran ARN dan titik akhir WEBRTC untuk melakukan panggilan API. Jika peserta terhubung dengan benar ke Kinesis Video Streams dengan Pensinyalan WebRTC melalui `ConnectAsViewer` WebSocket API `ConnectAsMaster` atau, penawaran SDP dan aliran pesan kandidat ICE akan dikirim sepanjang sesi WebSocket penyimpanan ke peserta.

------
#### [ Konsol Manajemen AWS ]

**catatan**  
Operasi ini saat ini tidak didukung di Stre Konsol Manajemen AWS aming Video Kinesis.

   Buka AWS CloudShell terminal, yang telah AWS CLI diinstal dan dikonfigurasi. Lihat Panduan [AWS CloudShell Pengguna ](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html#how-to-get-started) untuk informasi selengkapnya. 

   Ikuti instruksi di AWS CLI tab.

------
#### [ AWS CLI ]

   Verifikasi bahwa Anda telah AWS CLI menginstal dan dikonfigurasi. Untuk informasi selengkapnya, lihat [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/) dokumentasi.

   Untuk petunjuk pemasangan, lihat Panduan [AWS Command Line Interface Pengguna](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html#getting-started-install-instructions). Setelah instalasi, [ konfigurasikan AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-quickstart.html#getting-started-quickstart-new) dengan kredenSIAL dan wilayah.

   Atau, buka AWS CloudShell terminal, yang telah AWS CLI diinstal dan dikonfigurasi. Lihat Panduan [AWS CloudShell Pengguna ](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html#how-to-get-started) untuk informasi lebih lanjut.

   Jalan `Join-Storage-Session` kan perintah untuk peserta master dalam AWS CLI menggunakan saluran ARN dan titik akhir WEBRTC dari langkah-langkah sebelumnya:

   ```
   aws kinesis-video-webrtc-storage join-storage-session \
     --endpoint-url https://w-{{abcd1234}}.kinesisvideo.{{us-west-2}}.amazonaws.com \
     --channel-arn arn:aws:kinesisvideo:{{us-west-2}}:{{123456789012}}:channel/{{YourChannelName}}/{{1234567890123}} \
     --region "{{us-west-2}}"
   ```

   Setelah berhasil dijalankan, respons kosong dikembalikan dan tidak ada yang dicetak. 

   Dalam kasus peserta pemirsa, jalankan `Join-Storage-Session-As-Viewer` perintah berikut di AWS CLI menggunakan saluran ARN dan titik akhir WEBRTC dari sebelumnya:

   ```
   aws kinesis-video-webrtc-storage join-storage-session-as-viewer \
     --endpoint-url https://w-{{abcd1234}}.kinesisvideo.{{us-west-2}}.amazonaws.com \
     --channel-arn arn:aws:kinesisvideo:{{us-west-2}}:{{123456789012}}:channel/{{YourChannelName}}/{{1234567890123}} \
     --client-id "{{ExampleViewerClientID}}"
     --region "{{us-west-2}}"
   ```

   Setelah berhasil dijalankan, respons kosong dikembalikan dan tidak ada yang dicetak. 

------
#### [ AWS SDK ]

   Cuplikan kode ini menunjukkan cara memanggil `JoinStorageSessionAsViewer` API `JoinStorageSession` or untuk Streams Video Kinesis dengan saluran pensinyalan WebRTC menggunakan SDK untuk v2. AWS JavaScript Sintaks akan berbeda dari AWS SDK lain, tetapi alur umumnya akan sama. Lihat contoh kode lengkap untuk [ JoinStorageSession ](https://github.com/awslabs/amazon-kinesis-video-streams-webrtc-sdk-js/blob/master/examples/joinStorageSession.js) atau [ JoinStorageSessionAsViewer](https://github.com/awslabs/amazon-kinesis-video-streams-webrtc-sdk-js/blob/master/examples/joinStorageSessionAsViewer.js).

   Buat klien penyimpanan WebRTC Streams Video Streams Kinesis. Ini adalah klien yang digunakan untuk menelepon `JoinStorageSession` atau `JoinStorageSessionAsViewer` dan berbeda dari klien Kinesis Video Streams yang dibuat pada langkah-langkah sebelumnya.

   ```
   const webrtcStorageClientConfig = {
       accessKeyId: '{{YourAccessKey}}',
       secretAccessKey: '{{YourSecretKey}}',
       region: '{{us-west-2}}',
       endpoint: {{webrtcEndpoint}}
   };
   const kinesisVideoWebRTCStorageClient = new AWS.KinesisVideoWebRTCStorage(clientConfig);
   ```

   Gunakan klien untuk memanggil `JoinStorageSession` API untuk peserta master.

   ```
   await kinesisVideoWebRTCStorageClient
       .joinStorageSession({
           channelArn: {{channelARN}},
       })
       .promise();
   ```

   Dalam kasus peserta pemirsa, gunakan klien untuk memanggil `JoinStorageSessionAsViewer` API.

   ```
   await kinesisVideoWebRTCStorageClient
       .joinStorageSessionAsViewer({
           channelArn: {{channelARN}},
           clientId: "{{ExampleViewerClientID}}",
       })
       .promise();
   ```

   Halaman web langsung dengan contoh kode ini tersedia di [ GitHub](https://awslabs.github.io/amazon-kinesis-video-streams-webrtc-sdk-js/examples/index.html). Masukkan wilayah Anda, AWS kredenSIAL, dan nama saluran pensinyalan Anda. Perluas ** simpul Penyerapan dan Penyimpanan ** WebRTC, dan hapus centang Secara ** otomatis menentukan mode konsumsi. ** 

   Alihkan penggantian manual ke ** ON ** dan pilih tombol Tampilkan untuk ** memanggil tombol JoinStorageSession API ** and/or ** Show secara manual untuk memanggil JoinStorageSessionAsViewer API ** secara manual. 

   Ketika Anda memilih ** Start Master ** atau ** Start Viewer**, setelah aplikasi terhubung ke pensinyalan melalui `ConnectAsMaster` atau`ConnectAsViewer`, sebuah tombol akan muncul untuk membuat sesi penyimpanan memulai koneksi WebRTC dengan peer alih-alih aplikasi memanggil API segera setelah terhubung ke pensinyalan.

------