Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
JoinStorageSession
catatan
Sebelum menggunakan iniAPI, Anda harus memanggil GetSignalingChannelEndpoint API untuk meminta WEBRTC titik akhir. Anda kemudian menentukan titik akhir dan wilayah dalam JoinStorageSession API permintaan Anda.
Bergabunglah dengan RTC sesi Web audio satu arah dan/atau audio multi-arah 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 RTC konsumsi Web.
Persyaratan saat ini:
-
Lagu video: H.264
-
Lagu audio: Opus
Video tertelan yang dihasilkan dalam aliran video Kinesis akan memiliki parameter berikut: video dan audio H.264. 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 kamiAPIs.
Anda juga dapat menggunakan HLS fitur Kinesis Video Streams yang ada DASH seperti atau pemutaran, GetImagespembuatan gambar melalui, dan lainnya dengan RTC media Web 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 - Ini API bukan idempoten.
-
Coba lagi perilaku - Ini dihitung sebagai panggilan baruAPI.
-
Panggilan bersamaan - Panggilan bersamaan diizinkan. Penawaran dikirim satu kali per setiap panggilan.
Sintaks Permintaan
POST /joinStorageSession HTTP/1.1
Content-type: application/json
{
"channelArn": "string"
}URIParameter Permintaan
Permintaan tidak menggunakan URI parameter apa pun.
Isi Permintaan
Permintaan menerima data berikut dalam JSON format.
- channelArn
-
Nama Sumber Daya Amazon (ARN) dari saluran pensinyalan.
penting
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 HTTP tubuh kosong.
Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.
- AccessDeniedException
-
Anda tidak memiliki izin yang diperlukan untuk melakukan operasi ini.
HTTPKode Status: 403
- ClientLimitExceededException
-
Kinesis Video Streams telah membatasi permintaan karena Anda telah melampaui batas panggilan klien yang diizinkan. Coba buat panggilan nanti.
HTTPKode Status: 400
- InvalidArgumentException
-
Nilai untuk parameter input ini tidak valid.
HTTPKode Status: 400
- ResourceNotFoundException
-
Sumber daya yang ditentukan tidak ditemukan.
HTTPKode Status: 404
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan ini API di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
