Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Topik di bagian berikut memberikan jawaban atas pertanyaan umum tentang Amazon Chime SDK. Perluas topik untuk mempelajari lebih lanjut.
Rapat FAQs
Topik
Peserta
Hanya peserta dengan token bergabung yang diperlukan. Saat Anda menggunakan CreateAttendee, BatchCreateAttendee, atau CreateMeetingWithAttendees APIs, Anda membuat token gabungan yang Anda berikan kepada klien dan memungkinkan mereka untuk bergabung dengan rapat. Token yang dihasilkan oleh mereka APIs diautentikasi oleh layanan, dan yang memberikan izin untuk bergabung dalam rapat.
catatan
Amazon Chime SDK tidak membuat rapat IDs atau bergabung URLs untuk peserta rapat.
Kuota peserta adalah per pertemuan. Amazon Chime SDK mendukung 250 peserta dalam sesi standar, dan 100 peserta dalam sesi definisi tinggi. Jika Anda membutuhkan lebih banyak peserta, pertimbangkan untuk menggunakan replikasi media. Itu memungkinkan hingga 10.000 peserta setelah meminta peningkatan batas melalui konsol AWS Support
Tidak. Amazon Chime SDK hanya menagih Anda saat peserta bergabung dalam rapat. Selain itu, rapat secara otomatis berakhir 5 menit setelah peserta aktif terakhir turun atau meninggalkan rapat.
AttendeeLeft
dipicu ketika peserta memutuskan untuk meninggalkan rapat. AttendeeDropped
dipicu ketika peserta terputus dari rapat, biasanya karena masalah jaringan. AttendeeDeleted
dipicu ketika DeleteAttendeeAPI disebut.
AttendeeLeft
juga dipicu ketika:
-
Saat
DeleteAttendee
API dipanggil dari penangan rapat sisi server, bersama dengan.AttendeeDeleted
-
Klien Anda memanggil
meetingSession.audioVideo.Stop
API dari pustaka klien untuk JavaScript, yang sesuai APIs di iOS dan Android SDKs, atau saat rapat berakhir.
Untuk informasi lebih lanjut tentang acara rapat, lihatMemahami peristiwa siklus hidup rapat Amazon Chime SDK, sebelumnya dalam panduan ini.
Rapat berakhir secara otomatis ketika:
-
Waktu pertemuan melebihi 24 jam.
-
Pertemuan adalah pertemuan replika dan pertemuan utama berakhir.
-
Dalam pertemuan non-replika, tidak ada peserta yang terhubung selama 5 menit terus menerus.
Secara default, library klien Amazon Chime SDK JavaScript mencoba menyambung kembali selamaMeetingSessionConfiguration
Selain itu, Amazon Chime SDK mengirimkan AttendeeDropped
acara jika peserta dikeluarkan dari rapat dan tidak pernah terhubung kembali ke sesi.
Untuk informasi selengkapnya tentang acara rapat, lihatPemantauan, nanti di FAQ ini.
Keamanan dan enkripsi
Ya. Semua media dienkripsi dalam perjalanan dan mengalir melalui layanan. Media dienkripsi antara klien dan instance media tertentu yang menghosting rapat. Instance media mendekripsi audio untuk pencampuran, lalu mengenkripsi audio campuran untuk transmisi ke klien. Jika media sedang direkam melalui media capture, media dienkripsi antara instance media dan instance capture.
Audio/Video
Umum
Tidak. Namun, aliran video dapat dijeda saat bandwidth dibatasi.
Anda dapat secara terprogram mengontrol aliran video yang dilanggan setiap klien. Hal ini memungkinkan Anda untuk menerapkan logika seperti “presenter always visible” atau “meeting host always visible” dalam tampilan paginasi. Jika klien dibatasi sumber daya, Anda dapat mematikan aliran prioritas terendah. Untuk informasi selengkapnya, lihat Panduan Pengguna untuk Kebijakan Downlink Berbasis Prioritas
Codec dan simulcast
- Codec video
-
H.264,, VP8, VP9 dan. AV1
- Codec audio
-
Opus, 16 kHz, 48 kHz, dan stereo 48 kHz.
Kami mendukung simulcast video dengan VP8 dan H.264, dan pengkodean video yang dapat diskalakan dengan. VP9 Pustaka klien Amazon Chime SDK untuk JavaScript
Pengurangan gema
Tidak. Pengurangan Gema diaktifkan di tingkat rapat untuk semua peserta saat Anda memanggil CreateMeeting atau CreateMeetingWithAttendees APIs. Untuk informasi selengkapnya tentang penggunaan pengurangan gema, lihat Menambahkan Pengurangan Gema ke aplikasi Anda
Penindasan kebisingan
Kami menggunakan Amazon Voice Focus, teknologi peredam bising yang dibangun oleh AWS. Untuk mempelajari lebih lanjut tentang Amazon Voice FocusMemahami VoiceFocus untuk layanan audio Amazon Chime SDK PTSN, lihat, danMengkonfigurasi untuk Amazon Voice Focus, sebelumnya dalam panduan ini.
Bergantung pada bagaimana Anda mengkodekan solusi Anda, peserta rapat biasanya mengaktifkan atau menonaktifkan peredam bising. Pustaka klien Amazon Chime SDK mengekspos kontrol terprogram untuk peredam bising, dan Anda memilih cara menerapkannya. Misalnya, Anda dapat memberikan tombol sakelar, atau pengaturan di tingkat aplikasi untuk mengontrol peredam bising. Untuk informasi selengkapnya, lihat Amazon Voice Focus
Latar belakang kabur
Kami memiliki algoritma v1 dan v2. Algoritma v1 memiliki empat opsi berdasarkan pemanfaatan CPU (10% hingga 40%). Algoritma v2 secara efektif membutuhkan jumlah blur menjadi tinggi, sedang atau rendah. Demo berbasis JavaScript browser
Berbagi layar
Untuk JavaScript klien, browser menyediakan bingkai layar untuk pustaka klien. Resolusi adalah resolusi asli dari layar bersama, dibatasi oleh resolusi maksimum yang didukung oleh rapat. Anda dapat mengatur frame rate, tetapi ingat bahwa frame rate yang lebih tinggi meningkatkan beban CPU.
Anda juga dapat memilih codec untuk berbagi. Dalam pertemuan definisi standar, resolusi 1080p dan dikodekan pada 1,5 Mbps. Dalam pertemuan definisi tinggi, resolusi 4K dikodekan pada 2,5 Mbps.
Browser perangkat seluler tidak mendukung tangkapan layar atau berbagi layar. Anda perlu menggunakan iOS
Transkripsi langsung
Anda menggunakan Amazon Transcribe untuk menyunting PII. Saat Anda menggunakan StartMeetingTranscriptionAPI untuk mentranskripsikan rapat, Anda dapat menentukan jenis redaksi konten dan entitas PII yang berbeda untuk disunting.
catatan
Karena sifat prediktif pembelajaran mesin, Amazon Transcribe mungkin tidak mengidentifikasi dan menghapus semua contoh data sensitif, dan mungkin tidak mematuhi undang-undang privasi medis, seperti Undang-Undang Portabilitas dan Akuntabilitas Asuransi Kesehatan AS tahun 1996 (HIPAA). Untuk informasi selengkapnya, lihat Menyunting atau mengidentifikasi informasi yang dapat diidentifikasi secara pribadi, di Panduan Pengembang Amazon Transcribe.
Ya. Jika Anda berlangganantranscribeEvent
, setiap klien menerima acara itu, dan Anda dapat menampilkannya di klien Anda kepada pengguna akhir. Untuk informasi lebih lanjut, lihatMemahami peristiwa transkripsi langsung Amazon Chime SDK, sebelumnya dalam panduan ini.
Contoh berikut menunjukkan salah satu cara untuk berlangganantranscribeEvent
.
useEffect(() => {
if (audioVideo) {
audioVideo.transcriptionController?.subscribeToTranscriptEvent((transcriptEvent) => {
setTranscripts(transcriptEvent);
});
}
}, [audioVideo]);
Untuk informasi lebih lanjut tentang penggunaantranscribeEvent
, lihatMemahami peristiwa transkripsi langsung Amazon Chime SDK, sebelumnya dalam panduan ini.
Anda menggunakan Amazon Transcribe untuk membuat filter kosakata dan kosakata kustom, dan saat Anda memanggil StartMeetingTranscriptionAPI, Anda berikan VocabularyFilterName
dan VocabularyFilterMethod
nilai untuk menutupi kata-kata yang tidak diinginkan. Untuk informasi selengkapnya, lihat Kosakata khusus dan Membuat filter kosakata di Panduan Pengembang Amazon Transcribe.
Untuk transkripsi langsung real-time, Amazon Transcribe mendukung:
-
Bahasa Mandarin Sederhana (zh-CN)
-
Inggris (Australia (en-AU)
-
Inggris (en-GB)
-
AS (en-AS))
-
Prancis (Prancis (fr-FR) dan Kanada (fr-Ca))
-
Jerman (De-de)
-
Hindi (Hi-in)
-
Italia (IT-it)
-
Jepang (JP-JP)
-
Korea (KO-kr)
-
Portugis (Brasil (pt-BR)
-
Spanyol (AS (es-AS))
-
Thailand (TH-th)
Untuk informasi selengkapnya tentang bahasa yang tersedia untuk transkripsi secara real time atau batch, lihat Bahasa yang didukung dan fitur khusus bahasa, di Panduan Pengembang Amazon Transcribe.
Kuota layanan
Ya. Kuota layanan diterapkan per titik akhir API. Beralih ke titik akhir API yang berbeda menerapkan batas default.
Migrasi namespace
Lihat topik-topik berikut dalam panduan ini:
Ya. Untuk menggunakan peristiwa, Anda harus bermigrasi dari chime
namespace ke namespace. chimesdk
Untuk informasi lebih lanjut, lihat topik berikut dalam panduan ini:
Pemantauan
Kami mengirim acara rapat dan peserta melalui Amazon EventBridge, Amazon SNS, atau Amazon SQS. Acara berisi informasi seperti waktu mulai dan berhenti rapat, dan peserta bergabung, turun, dan meninggalkan tindakan. Untuk informasi selengkapnya tentang acara rapat dan cara menggunakannya, lihat topik berikut:
Metrik termasukAttendeeAuthorizationSuccess
,AttendeeAuthorizationErrors
, danAttendeeAudioDrops
. Untuk mempelajari lebih lanjut tentang metrik, lihatMemahami CloudWatch metrik Amazon untuk rapat Amazon Chime SDK, sebelumnya dalam panduan ini.
Amazon Chime SDK menghasilkan peristiwa rapat berdasarkan status komponen yang berbeda dalam aplikasi klien Anda, seperti audio, video, berbagi layar, atau aktivitas peserta. Anda dapat menulis peristiwa tersebut ke CloudWatch log, lalu membangun dasbor di log tersebut. Anda dapat menyertakan berbagai peristiwa, pesan kesalahan, dan kode status untuk membantu mendapatkan wawasan dari data.
Amazon Chime SDK juga terintegrasi dengan Amazon, EventBridge Amazon SQS, dan Amazon SNS untuk melacak peristiwa sisi server seperti permintaan untuk membuat atau menghapus rapat, peserta, atau saluran media. Anda dapat mengonfigurasi aturan untuk memfilter acara yang Anda minati dan menulis acara ke CloudWatch log.
Untuk mempelajari selengkapnya tentang acara rapat dan menggunakannya untuk membuat dasbor, lihat:
-
Acara Pertemuan
di GitHub. -
Memahami peristiwa siklus hidup rapat Amazon Chime SDKsebelumnya dalam panduan ini.
-
Memahami CloudWatch metrik Amazon untuk rapat Amazon Chime SDKsebelumnya dalam panduan ini.
-
Memahami pemberitahuan acara Amazon Chime SDKsebelumnya dalam panduan ini.
Untuk mencobanya, ikuti petunjuk di posting blog ini:
Kedua cara mengakhiri rapat memicu MeetingFailed
acara. Jika Anda tidak memiliki Cloud Trail atau EventBridge entri untuk DeleteMeetingAPI, Anda dapat berasumsi bahwa rapat berakhir secara otomatis.
Pencatatan log
Jalankan perintah dan bendera berikut:chrome —enable-logging
—vmodule=*/webrtc/*=1
. Ini menyala IFO
dan VERBOSE
masuk ke WebRTC. Log yang dihasilkan diberi nama chrome_debug.log
dan disimpan di direktori data pengguna Chrome.
Ikuti langkah-langkah ini:
-
Di Safari, pilih Pengaturan.
-
Pilih Opsi lanjutan, lalu pilih Tampilkan fitur untuk pengembang web.
Menu Kembangkan muncul di browser.
-
Pada menu Kembangkan, pilih Tampilkan JavaScript Konsol.
-
Di JavaScript konsol, pilih Pengaturan, lalu aktifkan logging WebRTC. Anda dapat memilih logging dasar atau verbose sesuai kebutuhan.
Pesan kesalahan
Lakukan hal-hal berikut:
-
Pastikan jalan keluar untuk port UDP 3478 pada rentang IP 99.77.128.0/18 diaktifkan. Untuk informasi lebih lanjut, lihatMengonfigurasi jaringan Anda untuk rapat Amazon Chime SDK, sebelumnya dalam panduan ini.
-
Pastikan ekstensi browser anti-virus tidak mencegah sumber daya dimuat. UDP 3478 adalah untuk TURN dan perlu dibuka blokir di sisi pengguna akhir, baik di firewall komputer lokal atau di firewall jaringan perusahaan.
-
Coba lagi koneksi kembali ke TLS melalui port 443, jadi pastikan domain atau subnet tidak diblokir.
Kesalahan ini biasanya terjadi ketika layanan tidak dapat menyelesaikan ARN pipa media. Pastikan ARN milik saluran media dan bukan rapat. MediaPipelineArn
adalah bagian dari CreateMediaCapturePipelineRespons API.
Kesalahan ini muncul ketika peserta yang sama bergabung dari dua perangkat. Kesalahan dikembalikan dalam meetingErrorMessage
atribut suatu meetingFailed
peristiwa. Untuk menghindari hal ini, pastikan bahwa setiap peserta memiliki keunikanExternalUserId
, dan pastikan bahwa Anda tidak menggunakan respons peserta yang sama dari CreateAttendee, BatchCreateAttendee, atau CreateMeetingWithAttendees APIs dalam dua atau lebih pertemuan secara bersamaan.
Anda memanggil Amazon Chime API yang tidak digunakan lagi. Untuk mengatasi masalah ini, migrasi ke namespace Amazon Chime SDK. Untuk informasi lebih lanjut, lihat topik berikut sebelumnya dalam panduan ini:
Anda memanggil Amazon Chime API yang tidak digunakan lagi. Untuk mengatasi masalah ini, migrasi ke namespace Amazon Chime SDK. Untuk informasi lebih lanjut, lihat topik berikut sebelumnya dalam panduan ini:
Token permintaan klien adalah pengidentifikasi unik yang membuat permintaan API idempoten. Kesalahan ini terjadi ketika token dikaitkan dengan saluran media yang tidak aktif. Untuk memperbaiki masalah, buat token unik baru dan kirimkan dengan permintaan API.
Pipa media FAQs
Pengambilan media menggunakan MP4 format. Ini termasuk segmen 5 detik dan gabungan rekaman dan file komposit.
Untuk menghapus peserta pengambilan media, Anda dapat mengakhiri pipeline atau memanggil DeleteMediaCapturePipelineAPI.
Saluran pipa penangkap media merekam langsung ke bucket Amazon S3 Anda. Media capture tidak menempatkan bandwidth atau persyaratan konektivitas pada klien.
Untuk memilih Region untuk membuat tangkapan media, pertama-tama pilih titik akhir API dari Area bidang kontrol rapat yang tersedia. Selanjutnya, buat pipeline meeting dan media capture di Region tersebut. Pengambilan media dapat menulis ke bucket Amazon S3 di akun Anda di Wilayah media Amazon Chime SDK mana pun. Untuk informasi selengkapnya tentang Wilayah dan titik akhir yang tersedia, bidang kontrol saluran pipa media, dan Wilayah media, lihat Wilayah AWS yang tersedia untuk Amazon Chime SDK sebelumnya dalam panduan ini, serta titik akhir dan kuota Amazon Chime SDK dalam panduan Referensi.AWS
Tidak. Pipeline hanya menangkap 25 aliran video pertama.
Anda dapat membuat mekanisme untuk memanggil DeleteMediaCapturePipelineAPI setelah beberapa menit tertentu. Misalnya, Anda dapat membuat fungsi langkah yang dimulai saat pengambilan media dimulai dan memiliki waktu tunggu yang telah ditentukan.
Anda dapat menelepon DeleteMediaCapturePipelineAPI untuk mengakhiri rekaman, atau Anda dapat memanggil DeleteMeetingAPI saat rapat dijadwalkan berakhir. Selama rapat, jika peserta penangkap media adalah satu-satunya peserta yang tersisa, rapat secara otomatis berakhir setelah 5 menit.
Audio PSTN FAQs
Tidak. Anda tidak dapat merutekan nomor non-AS ke Konektor Suara menggunakan audio PSTN.
Ya. Pertama-tama panggil Hangup tindakan untuk kaki yang terhubung ke rapat. Itu memutus peserta dari rapat tanpa menghentikan panggilan masuk. Kemudian panggil JoinChimeMeeting tindakan untuk bergabung dengan peserta ke pertemuan baru.