View a markdown version of this page

Menggunakan Amazon Chime SDK - Amazon Chime SDK

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

Menggunakan Amazon Chime SDK

Anda menggunakan Amazon Chime SDK untuk membuat aplikasi media real-time yang dapat mengirim dan menerima audio dan video serta memungkinkan berbagi konten. Amazon Chime SDK bekerja secara independen dari akun administrator Amazon Chime mana pun, dan tidak memengaruhi rapat yang dihosting di Amazon Chime. Sebagai gantinya, Amazon Chime SDK menyediakan alat pembuat yang Anda gunakan untuk membuat aplikasi rapat Anda sendiri.

Prasyarat untuk menggunakan Amazon Chime SDK

Menggunakan Amazon Chime SDK memerlukan hal berikut:

  • Kemampuan untuk memprogram.

  • Sebuah AWS akun.

  • Peran IAM dengan kebijakan yang memberikan izin untuk mengakses tindakan Amazon Chime API yang digunakan oleh Amazon Chime SDK, seperti kebijakan SDK terkel AWS ola AmazonChime. Untuk informasi selengkapnya, lihat Cara kerja Amazon Chime dengan IAM dan Iz inkan pengguna mengakses tindakan Amazon Chime SDK di Panduan Administrator Amazon Chime SDK.

  • Untuk sebagian besar kasus penggunaan, Anda juga memerlukan yang berikut:

    • Aplikasi server — Mengelola sumber daya rapat dan peserta, dan melayani sumber daya tersebut ke aplikasi klien. Aplikasi server dibuat di AWS akun dan harus memiliki akses ke peran IAM yang disebutkan sebelumnya.

    • Aplikasi klien — Menerima informasi rapat dan peserta dari aplikasi server, dan menggunakan informasi itu untuk membuat koneksi media.

Konsep untuk Amazon Chime SDK

Terminologi dan konsep berikut sangat penting untuk memahami cara menggunakan Amazon Chime SDK.

rapat

Sumber daya fana yang diidentifikasi oleh yang unik. MeetingId Itu MeetingId ditempatkan ke sekelompok layanan media yang menjadi tuan rumah pertemuan aktif.

kelompok layanan media

Kelompok layanan media yang menyelenggarakan pertemuan aktif.

penempatan media

Sekumpulan URL regional yang mewakili grup layanan media. Peserta terhubung ke grup layanan media dengan klien mereka untuk mengirim dan menerima audio dan video real-time, dan berbagi layar mereka.

peserta

Peserta rapat yang diidentifikasi oleh unikAttendeeId. Peserta dapat dengan bebas bergabung dan meninggalkan rapat menggunakan aplikasi klien yang dibuat dengan pustaka klien Amazon Chime SDK.

bergabung dengan token

Token unik yang ditetapkan untuk setiap peserta. Peserta menggunakan token bergabung untuk mengotentikasi dengan grup layanan media.

Arsitektur untuk Amazon Chime SDK

Daftar berikut menjelaskan bagaimana berbagai komponen arsitektur Amazon Chime SDK bekerja sama untuk mendukung rapat dan peserta, audio, video, dan berbagi konten.

Rapat dan peserta

Saat aplikasi server membuat rapat Amazon Chime SDK, rapat ditugaskan ke layanan media khusus wilayah. Tuan rumah dalam layanan bertanggung jawab untuk mentransfer media real-time dengan aman antara klien peserta. Setiap peserta yang dibuat diberi token gabungan unik, kunci rahasia buram yang harus ditransfer aplikasi server Anda dengan aman ke klien yang berwenang untuk bergabung dengan rapat atas nama peserta. Setiap klien menggunakan token bergabung untuk mengotentikasi dengan grup layanan media. Klien menggunakan kombinasi Secure WebSockets dan Datagram Transport Layer Security (DTLS) untuk memberi sinyal dengan aman kepada grup layanan media, dan untuk mengirim dan menerima media ke dan dari peserta lain melalui grup layanan media.

Audio

Layanan media mencampur audio bersama dari setiap peserta dan mengirimkan campuran ke setiap penerima, setelah mengurangi audio mereka sendiri dari campuran. Amazon Chime SDK mengambil sampel audio pada tingkat tertinggi yang didukung oleh perangkat dan browser, hingga maksimum 48kHz. Kami menggunakan codec Opus untuk menyandikan audio, dengan bitrate default 32kbps, yang dapat ditingkatkan hingga 128kbps stereo dan 64kbps mono.

Video

Layanan media bertindak sebagai Unit Penerusan Selektif (SFU) menggunakan model publikasi dan berlangganan. Setiap peserta dapat mempublikasikan satu sumber video, hingga total 25 video simultan per rapat. Pustaka klien Amazon Chime SDK untuk JavaScript mendukung resolusi video hingga 1280x720 pada 30 frame per detik tanpa simulcast, dan 15 frame per detik dengan simulcast. Pustaka klien Amazon Chime SDK untuk iOS, Android, dan Windows mendukung resolusi video hingga 1280x720 dan 30 frame per detik, namun framerate dan resolusi sebenarnya dikelola secara otomatis oleh Amazon Chime SDK.

Saat aktif, video simulcast mengirimkan setiap aliran video dalam dua resolusi dan bitrate yang berbeda. Klien dengan batasan bandwidth secara otomatis berlangganan aliran bitrate yang lebih rendah. Pengkodean dan decoding video menggunakan akselerasi perangkat keras jika tersedia untuk meningkatkan kinerja.

Pesan data

Selain konten audio dan video, peserta rapat dapat saling mengirim pesan data real-time masing-masing hingga 2 KB. Anda dapat menggunakan pesan untuk menerapkan fitur rapat khusus seperti papan tulis, obrolan, reaksi emoji real-time, dan pensinyalan kontrol lantai khusus aplikasi.

Berbagi konten

Aplikasi klien dapat berbagi konten audio dan video, seperti tangkapan layar atau file media. Berbagi konten mendukung video konten pra-rekaman hingga 1280x720 pada 15 frame per detik, dan audio hingga 48kHz pada 64kbps. Tangkapan layar untuk berbagi konten didukung hingga 15 frame per detik, tetapi mungkin dibatasi oleh kemampuan perangkat dan browser.

Kuota untuk Amazon Chime SDK

Kuota untuk layanan Amazon Chime SDK didokumentasikan di Referensi Umum AWS. Untuk informasi selengkapnya, lihat titik akhir dan kuota Amazon Chime SDK di. Referensi Umum AWS

catatan

Kuota layanan adalah per titik akhir API. Saat meminta peningkatan kuota layanan, pastikan untuk meminta peningkatan pada semua titik akhir API yang digunakan aplikasi Anda.

Persyaratan sistem Amazon Chime SDK

Persyaratan sistem berikut berlaku untuk aplikasi yang dibuat dengan Amazon Chime SDK.

Browser yang didukung, pustaka klien Amazon Chime SDK untuk JavaScript

Sistem operasi Peramban Versi yang didukung Catatan

Windows

Mozilla Firefox

Tiga versi terakhir

Google Chrome

Tiga versi terakhir

Chromium-based Tepi

Tiga versi terakhir

Chromium-based Elektron

Tiga versi terakhir

Electron mendukung tiga versi utama stabil terbaru, masing-masing melacak rilis Chromium genap. Lihat rilis Electron di situs web Electron.

Opera

Tiga versi terakhir

macOS

Mozilla Firefox

Tiga versi terakhir

Google Chrome

Tiga versi terakhir

Chromium-based Tepi

Tiga versi terakhir

Chromium-based Elektron

Tiga versi terakhir

Electron mendukung tiga versi utama stabil terbaru, masing-masing melacak rilis Chromium genap. Lihat rilis Electron di situs web Electron.

Safari

Tiga versi terakhir

Opera

Tiga versi terakhir

iOS

Mozilla Firefox

Tiga versi terakhir

Hanya audio dan video, tidak ada berbagi konten.

Google Chrome

Tiga versi terakhir

Hanya audio dan video, tidak ada berbagi konten.

Safari

Tiga versi terakhir

Hanya audio dan video, tidak ada berbagi konten.

WKWebView

14.3 dan yang lebih baru

Hanya audio dan video, tidak ada berbagi konten.

Android

Google Chrome

Tiga versi terakhir

Hanya audio dan video, tidak ada berbagi konten.

Internet Samsung

12 dan seterusnya

Hanya audio dan video, tidak ada berbagi konten.

Kromium WebView

5 dan setelahnya

Hanya audio dan video, tidak ada berbagi konten.

Ubuntu LTS 16.04 dan yang lebih baru

Google Chrome

Tiga versi terakhir

Pustaka klien Amazon Chime SDK untuk iOS
  • iOS versi 13 dan yang lebih baru

Pustaka klien Amazon Chime SDK untuk Android
  • OS Android versi 5 dan yang lebih baru, arsitektur ARM dan ARM64