Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# JoinStorageSession
**catatan**
Sebelum menggunakan API ini, Anda harus memanggil `GetSignalingChannelEndpoint` API untuk meminta endpoint WEBRTC. Anda kemudian menentukan titik akhir dan wilayah dalam permintaan `JoinStorageSession` API Anda.
Bergabunglah dengan sesi WebRTC and/or audio multi-arah satu arah video yang sedang berlangsung sebagai perangkat penghasil video untuk saluran input. Jika tidak ada sesi yang ada untuk saluran tersebut, buat sesi streaming baru dan berikan Nama Sumber Daya Amazon (ARN) dari saluran pensinyalan.
Saat ini untuk `SINGLE_MASTER` jenisnya, perangkat penghasil video mampu menyerap media audio dan video ke dalam aliran. Hanya perangkat penghasil video yang dapat bergabung dengan sesi dan merekam media.
**penting**
Baik trek audio dan video saat ini diperlukan untuk konsumsi WebRTC.
Persyaratan saat ini:
Lagu video: H.264
Lagu audio: Opus
Video:
Resolusi maks adalah SQFHD (1920x1920)
Konsumsi WebRTC KVS saat ini mendukung serangkaian profil H264 tertentu:
terbatas-baseline
garis dasar
utama
tinggi
terbatas-tinggi
progresif-tinggi
Video tertelan yang dihasilkan dalam aliran video Kinesis akan memiliki parameter berikut: video H.264 dan audio AAC.
Setelah peserta master menegosiasikan koneksi melalui WebRTC, sesi media yang dicerna akan disimpan dalam aliran video Kinesis. Beberapa pemirsa kemudian dapat memutar kembali media real-time melalui Pemutaran kami APIs.
Anda juga dapat menggunakan `HLS` fitur Kinesis Video Streams yang ada `DASH` seperti atau pemutaran, [GetImages](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/gs-getImages.html)pembuatan gambar melalui, dan lainnya dengan media WebRTC yang dicerna.
**catatan**
Pengiriman gambar S3 dan pemberitahuan saat ini tidak didukung.
**catatan**
Asumsikan bahwa hanya satu klien perangkat penghasil video yang dapat dikaitkan dengan sesi untuk saluran tersebut. Jika lebih dari satu klien bergabung dengan sesi saluran tertentu sebagai perangkat penghasil video, permintaan klien terbaru diutamakan.
**Informasi tambahan**
+ **Idempoten - API ini tidak idempoten**.
+ **Perilaku coba lagi** - Ini dihitung sebagai panggilan API baru.
+ **Panggilan bersamaan - Panggilan** bersamaan diizinkan. Penawaran dikirim satu kali per setiap panggilan.
## Minta Sintaks
```
POST /joinStorageSession HTTP/1.1
Content-type: application/json
{
"channelArn": "{{string}}"
}
```
## Parameter Permintaan URI
Permintaan tidak menggunakan parameter URI apa pun.
## Isi Permintaan
Permintaan menerima data berikut dalam format JSON.
** [channelArn](#API_webrtc_JoinStorageSession_RequestSyntax) **
Nama Sumber Daya Amazon (ARN) dari saluran pensinyalan.
Perhatikan kapitalisasi parameter input ini.
Tipe: String
Pola: `arn:(aws[a-zA-Z-]*):kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+`
Diperlukan: Ya
## Sintaksis Respons
```
HTTP/1.1 200
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.
## Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Jenis Kesalahan Umum](CommonErrors.md).
** AccessDeniedException **
Anda tidak memiliki izin yang diperlukan untuk melakukan operasi ini.
Kode Status HTTP: 403
** ClientLimitExceededException **
Kinesis Video Streams telah membatasi permintaan karena Anda telah melampaui batas panggilan klien yang diizinkan. Coba buat panggilan nanti.
Kode Status HTTP: 400
** InvalidArgumentException **
Nilai untuk parameter input ini tidak valid.
Kode Status HTTP: 400
** ResourceNotFoundException **
Sumber daya yang ditentukan tidak ditemukan.
Kode Status HTTP: 404
## Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+ [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK for C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)