Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
JoinStorageSessionAsViewer
catatan
RTCPenyerapan web dengan dukungan multi-penampil (Pratinjau) disediakan di Pratinjau sebagaimana didefinisikan dalam Ketentuan AWS Layanan dan dapat berubah 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 iniAPI, Anda harus memanggil GetSignalingChannelEndpoint API untuk meminta WEBRTC titik akhir. Anda kemudian menentukan titik akhir dan wilayah dalam JoinStorageSessionAsViewer 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.
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 dan audio H.264. AAC
Semua peserta, termasuk pemirsa dan master, akan dapat mendengar satu sama lain. Semua pemirsa juga menerima media dari peserta utama melalui WebRTC.
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 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.
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 memanggilnya API 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 - 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 /joinStorageSessionAsViewer HTTP/1.1
Content-type: application/json
{
"channelArn": "string",
"clientId": "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]+$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 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:
