Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
catatan
Penyerapan WebRTC dengan dukungan multi-penampil (Pratinjau) disediakan di Pratinjau sebagaimana didefinisikan dalam Ketentuan Layanan dan dapat berubah AWS sewaktu-waktu. Saat ini hanya tersedia di us-east-1 (IAD).
Untuk berpartisipasi dalam pratinjau, email kami di kvs-webrtc-multi-view-preview@amazon.com
catatan
Sebelum menggunakan API ini, Anda harus memanggil GetSignalingChannelEndpoint API untuk meminta endpoint WEBRTC. Anda kemudian menentukan titik akhir dan wilayah dalam permintaan JoinStorageSessionAsViewer API Anda.
JoinStorageSessionAsViewermemungkinkan pemirsa untuk bergabung dengan sesi streaming WebRTC yang direkam cloud yang sedang berlangsung. API ini memulai koneksi WebRTC dengan mengirimkan penawaran SDP dan kandidat ICE antara pemirsa dan agen perekam, memungkinkan pemirsa untuk menerima video real-time dari master melalui agen perekam dan berpartisipasi dalam komunikasi audio dua arah melalui agen perekam. Setelah terhubung, audio pemirsa, jika disediakan, diteruskan ke semua rekan lain yang terhubung, termasuk peserta utama, dan dimasukkan ke dalam aliran WebRTC yang disimpan ke aliran Video Kinesis.
penting
Pemirsa saat ini tidak dapat mengirim trek video apa pun. Pemirsa dapat mengirim trek audio opsional atau tidak ada trek sama sekali.
Persyaratan pengiriman peserta penampil saat ini:
-
Trek video: Tidak didukung
-
Trek audio (opsional): Opus
Jika peserta master saat ini terhubung ke perangkat penghasil video, video yang tertelan yang dihasilkan dalam aliran video Kinesis akan memiliki parameter berikut: Video H.264 dan audio AAC.
catatan
Peserta pemirsa terhubung langsung ke sesi penyimpanan dan tidak langsung ke peserta utama. Sesi penyimpanan menangani pencampuran, duplikasi, dan perutean media ke tujuan yang sesuai.
catatan
Jika peserta utama tidak hadir, pemirsa tidak akan dapat mendengar satu sama lain.
Setelah peserta pemirsa menegosiasikan koneksi melalui WebRTC, sesi audio yang dicerna akan disimpan dalam aliran video Kinesis selama peserta master juga terhubung ke sesi penyimpanan.
Anda juga dapat menggunakan HLS fitur Kinesis Video Streams yang ada DASH seperti atau pemutaran, GetImagespembuatan 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.
Batas
Batas saat ini ada:
-
Jumlah maksimum pemirsa: 3
-
Waktu maksimum peserta penampil tetap terhubung 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.
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 /joinStorageSessionAsViewer HTTP/1.1
Content-type: application/json
{
"channelArn": "string",
"clientId": "string"
}Parameter Permintaan URI
Permintaan tidak menggunakan parameter URI apa pun.
Isi Permintaan
Permintaan menerima data berikut dalam format JSON.
- 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]+$Wajib: Ya
- clientId
-
Pengidentifikasi unik untuk klien pengirim.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.
Pola:
^[a-zA-Z0-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 Kesalahan Umum.
- 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:
