Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Virtual Rooms memberdayakan pengembang dengan kemampuan keamanan dan kontrol penting untuk membangun pengalaman komunikasi terstruktur dengan baik seperti janji temu virtual dan komunikasi grup. Pengembang dapat menggunakan ruang virtual untuk melakukan panggilan suara, video, dan PSTN. Keamanan dan kontrol di kamar dapat diklasifikasikan sebagai berikut.
Keamanan dan kontrol akses pengguna diterapkan untuk memanggil peserta, mengontrol siapa yang dapat bergabung dengan panggilan dan tindakan mana yang dapat mereka ambil selama panggilan. Misalnya, selama janji temu virtual pasien dengan dokter, hanya staf rumah sakit yang berwenang dan pasien yang dapat bergabung dalam panggilan. Membatasi peserta mempertahankan privasi pasien dan peserta tidak melebihi peran dan hak istimewa yang ditetapkan untuk mengganggu panggilan yang sedang berlangsung.
Keamanan dan kontrol tingkat kamar diterapkan di tingkat panggilan untuk mengontrol kapan panggilan dapat dilakukan dan kemampuan mana yang tersedia selama panggilan. Misalnya, siswa hanya berwenang untuk bergabung dengan panggilan ruang kelas selama waktu yang dialokasikan tetapi pemanggil PSTN tidak dapat bergabung dengan panggilan kelas yang sama.
Kemampuan tingkat tinggi yang didukung di Virtual Rooms
| Kemampuan | Didukung dalam panggilan Kamar |
|---|---|
| Suara melalui Internet (VoIP) | ✔️ |
| Rekaman video | ✔️ |
| Klien memulai dial-out ke nomor PSTN | ✔️ |
| Server memulai dial-out ke nomor PSTN | ✔️ |
| Manajemen panggilan sisi server (Automasi Panggilan)* | ✔️ |
| Sambungan PSTN | ❌ |
| Pesan Asinkron (Obrolan) | ❌ |
| Interoperabilitas dengan Microsoft Teams | ❌ |
* Beberapa pengecualian berlaku. Untuk daftar lengkapnya, lihat Kemampuan Automasi Panggilan.
Kapan menggunakan Virtual Rooms
Tabel berikut ini menjelaskan kapan harus menggunakan Virtual Rooms.
| Kondisi | Gunakan Ruang |
|---|---|
| Ketika penting untuk mengontrol siapa yang diizinkan bergabung dalam panggilan (pengalaman hanya untuk undangan). | ✔️ |
| Ketika penting untuk mengontrol kapan panggilan dimulai dan berakhir. | ✔️ |
| Ketika peran dan izin pengguna diperlukan untuk melakukan komunikasi yang dikelola dengan baik. | ✔️ |
| Ketika solusi memerlukan interoperabilitas Teams.* | ❌ |
* Jika solusi memerlukan interoperabilitas antara Teams dan Azure Communication Services, gunakan panggilan interoperabilitas Teams.
Cara melakukan panggilan di Virtual Rooms
Pada tingkat tinggi, untuk melakukan panggilan di Virtual Rooms, Anda perlu membuat dan mengelola ruang. Tabel berikut menjelaskan cara memungkinkan peserta bergabung dengan panggilan dan melakukan operasi dalam panggilan menggunakan SDK Panggilan di sisi klien dan sisi server.
| Kemampuan | ACS SDK | SDK Klien vs Server | Deskripsi |
|---|---|---|---|
| Membuat dan mengelola Virtual Rooms | Virtual Rooms SDK | pelayan | Virtual Rooms SDK memungkinkan pengembang untuk membuat dan mengelola Virtual Rooms, menambahkan/menghapus pengguna, menetapkan/memperbarui peran pengguna, mengatur/memperbarui jadwal Virtual Rooms. Pengembang juga dapat mengatur batas keamanan seperti untuk membatasi dial-out PSTN dari Rooms. |
| Bergabunglah dengan panggilan Virtual Rooms menggunakan suara, video, atau PSTN, dan lakukan operasi dalam-panggilan yang diprakarsai oleh klien. | Memanggil SDK | Klien | SDK klien Panggilan memungkinkan pengguna untuk bergabung dengan panggilan Virtual Rooms dan menjalankan operasi sisi klien sebagaimana diizinkan oleh peran pengguna yang ditetapkan. Keamanan dalam panggilan Virtual Rooms dipastikan melalui penegakan daftar nama, jadwal, peran pengguna, dan batas kontrol yang ditetapkan melalui pembuatan dan pengelolaan Virtual Rooms. Dengan menggunakan SDK Panggilan klien, pengembang memberdayakan peserta panggilan untuk menjalankan operasi dalam panggilan seperti mematikan suara/menyalakan suara, berbagi layar, mengaktifkan/menonaktifkan video dan memanggil peserta PSTN, dan sebagainya. |
| Pengelolaan dari sisi server untuk operasi panggilan | Memanggil Automation SDK | pelayan | Call Automation SDK memungkinkan pengembang untuk menjalankan operasi dalam panggilan dari sisi server. Operasi selama panggilan mencakup panggilan keluar yang dimulai oleh server ke nomor PSTN, perekaman panggilan, pengiriman dan penerimaan sinyal DTMF, pengiriman pengumuman kepada pengguna tertentu, dan sebagainya. Karena operasi panggilan pada sisi server berjalan secara independen dari pengguna dan dikendalikan oleh pengembang, tindakan ini tidak diatur oleh peran pengguna. |
Untuk mengamankan panggilan dan memicu operasi sisi klien/sisi server selama panggilan, pengembang menggunakan Virtual Rooms SDK, SDK Panggilan, dan Call Automation SDK.
| Kemampuan | Rooms Server SDK | Panggilan SDK Klien | SDK Server Otomasi Panggilan |
|---|---|---|---|
| Manajemen Ruang Virtual - Membuat/Mendapatkan/Memperbarui/Mencantumkan/Menghapus Ruang Virtual | ✔️ | ❌ | ❌ |
| Manajemen daftar nama Virtual Rooms - Menambahkan/Memperbarui/Menghapus pengguna ke Ruang Virtual | ✔️ | ❌ | ❌ |
| Virtual Rooms memanggil manajemen izin peserta - Menetapkan/Memperbarui peran pengguna | ✔️ | ❌ | ❌ |
| Pengelolaan jadwal Virtual Rooms - Tetapkan/Perbarui jadwal yang diizinkan untuk Virtual Rooms | ✔️ | ❌ | ❌ |
| Manajemen kontrol keamanan Ruang Virtual - Mengatur/Memperbarui pengaturan untuk memungkinkan PSTN melakukan dial-out dari Ruang Virtual tertentu | ✔️ | ❌ | ❌ |
| Mendapatkan daftar pengguna yang diundang untuk bergabung dengan Ruang Virtual | ✔️ | ❌ | ❌ |
| Pengguna memulai panggilan Virtual Rooms atau bergabung dengan panggilan yang sedang berlangsung | ❌ | ✔️ | ❌ |
| Menghubungi pengguna PSTN | ❌ | ✔️ | ✔️ |
| Menambahkan/Menghapus peserta VoIP ke panggilan yang sedang berlangsung | ❌ | ✔️ | ✔️ |
| Dapatkan daftar peserta yang bergabung dalam panggilan yang sedang berlangsung | ❌ | ✔️ | ✔️ |
| Mulai/Hentikan keterangan panggilan dan ubah bahasa keterangan | ❌ | ✔️ | ❌ |
| Mengelola perekaman panggilan | ❌ | ❌ | ✔️ |
| Kirim/Terima DTMF ke/dari peserta PSTN | ❌ | ❌ | ✔️ |
| Memutar perintah audio kepada peserta | ❌ | ❌ | ✔️ |
Untuk daftar lengkap operasi panggilan sisi klien dan cara menggunakannya, lihat SDK Klien Panggilan.
Mengelola panggilan Virtual Rooms dari sisi server menggunakan Call Automation Server SDK
SDK Otomasi Panggilan memberdayakan pengembang untuk mengelola panggilan Virtual Rooms dari sisi server dan melaksanakan operasi dalam panggilan. Kemampuan Otomasi Panggilan sedang diaktifkan secara bertahap dalam panggilan di Virtual Rooms. Tabel berikut ini memperlihatkan status kapabilitas ini saat ini. Pengembang mengelola dan mengontrol kemampuan Automasi Panggilan dari sisi server, yang beroperasi pada tingkat yang lebih tinggi daripada hak istimewa peserta panggilan. Jadi kemampuan Automasi Panggilan tidak dikontrol melalui peran dan izin pengguna.
| Kemampuan Automasi Panggilan | Didukung dalam panggilan Kamar |
|---|---|
| Hubungi peserta PSTN | ✔️ |
| Kirim/Baca DTMF ke/dari peserta PSTN | ✔️ |
| Mengirim pengumuman ke peserta panggilan tertentu | ✔️ |
| Menambahkan/Menghapus peserta VoIP dari panggilan yang sedang berlangsung | ✔️ |
| Akhiri panggilan untuk semua pengguna | ✔️ |
| Transkripsi panggilan* | ✔️ |
| Streaming audio media | ✔️ |
* Saat ini dalam pratinjau publik.
Ilustrasi ini menunjukkan konsep untuk mengelola dan menggabungkan ruangan.
Server memulai Dialout PSTN menggunakan Call Automation Server SDK
Pengembang dapat mengaktifkan/menonaktifkan kemampuan untuk melakukan dial-out ke peserta PSTN dengan mengatur bendera pstnDialoutEnabled khusus ruangan. Setelah pengembang menetapkan pstnDialoutEnabled=TRUE untuk Ruangan, pengembang dapat melakukan dial-out ke peserta PSTN dari sisi server menggunakan Call Automation, tanpa memerlukan partisipasi pihak klien.
Misalnya, pasien mungkin meminta layanan interpretasi untuk janji temu virtual mereka yang akan datang dengan dokter mereka. Dalam kebanyakan kasus, nomor telepon ke layanan interpretasi ditentukan secara dinamis melalui proses backend. Kemampuan dial-out PSTN sisi server ini memungkinkan pengembang menentukan nomor telepon target, memulai panggilan dan menambahkannya ke panggilan janji temu virtual pasien, tanpa memerlukan tindakan sisi klien.
Ikuti langkah-langkah ini untuk menambahkan nomor PSTN ke panggilan ruang menggunakan Call Automation SDK:
- Membuat ruangan dengan parameter pstnDialoutEnabled diatur ke
True - Peserta memulai panggilan di ruang
- Gunakan SDK Otomasi Panggilan untuk menyambungkan ke panggilan kamar menggunakan ID kamar
- Gunakan SDK Automasi Panggilan untuk melakukan panggilan ke nomor PSTN
- Pengguna PSTN menerima dan bergabung dengan sebuah panggilan ruang
Mengelola panggilan ruang virtual dari SDK Panggilan sisi klien
Gunakan SDK Panggilan untuk bergabung dengan panggilan di dalam ruangan. Panggilan ruang dapat digabungkan menggunakan SDK Panggilan Web, iOS, atau Android. Untuk contoh dan cara bergabung dengan panggilan ruangan, lihat Bergabung dengan panggilan ruangan.
Ruangan juga dapat diakses menggunakan Perpustakaan Antarmuka Pengguna Azure Communication Services. Pustaka UI memungkinkan pengembang untuk menambahkan klien panggilan yang mendukung Rooms ke dalam aplikasi mereka hanya dengan beberapa baris kode.
Klien memulai Dial-out PSTN menggunakan SDK klien Panggilan
Pengembang dapat mengaktifkan/menonaktifkan kemampuan peserta panggilan untuk melakukan dial-out ke peserta PSTN, dengan mengatur bendera pstnDialoutEnabled khusus Ruangan. Setelah pengembang menetapkan pstnDialoutEnabled=TRUE untuk Ruangan, peserta panggilan dengan peran Penyaji dapat menghubungi peserta PSTN dari klien panggilan mereka. Langkah-langkah berikut digunakan untuk menambahkan nomor PSTN ke panggilan ruang menggunakan SDK Klien Panggilan.
- Buat ruangan dengan bendera pstnDialoutEnabled diatur ke True.
- Peserta memulai panggilan dalam ruangan.
- Peserta dengan peran Penyaji menambahkan nomor PSTN ke dalam panggilan.
- Pengguna PSTN menerima dan bergabung dengan panggilan ruang.
VIRTUAL Rooms API/SDK
Kamar dibuat dan dikelola melalui API ruang atau SDK. Gunakan ROOMS API/SDK di aplikasi server Anda untuk room operasi:
- Buat
- Ubah
- Hapus
- Mengatur dan memperbarui daftar peserta
- Mengatur dan memodifikasi validitas Ruangan
- Tetapkan peran dan izin kepada pengguna
| Virtual Rooms SDK | Versi | Keadaan |
|---|---|---|
| SDK Ruang Virtual | 13-03-2025 | Ketersediaan Umum - Didukung penuh |
| SDK Ruang Virtual | 15-04-2024 | Ketersediaan Umum - Didukung penuh |
| SDK Ruang Virtual | 2023-06-14 | Ketersediaan Umum - Didukung penuh |
| SDK Ruang Virtual | 2023-10-30 | Pratinjau Umum - Didukung penuh |
| SDK Ruang Virtual | 31-03-2023 | Pratinjau Publik - dihentikan |
| SDK Ruang Virtual | 01-02-2022 | Pratinjau Publik - dihentikan |
| SDK Ruang Virtual | 2021-04-07 | Pratinjau Publik - dihentikan |
Peran dan izin peserta yang telah ditentukan sebelumnya dalam panggilan Virtual Rooms
Anda dapat menetapkan peserta ruang salah satu peran berikut: Penyaji, Kolaborator, Peserta, dan Konsumen.
Tabel berikut menyajikan pemetaan kemampuan secara rinci ke dalam peran. Pada tingkat tinggi, peran Penyaji memiliki kontrol penuh, Kolaborator memiliki kemampuan audio, video, dan screenshare, Attendee memiliki kemampuan audio dan video, sementara Konsumen hanya dapat menerima audio, video, dan berbagi layar.
Nota: Peserta panggilan PSTN bukan bagian dari daftar nama Kamar, sehingga peran pengguna tidak ditetapkan untuk mereka. Kemampuan mereka terbatas untuk membisukan/menghidupkan suara mereka sendiri pada perangkat lokal.
| Kemampuan | Peran: Penyaji | Peran: Kolaborator | Peran: Peserta | Peran: Konsumen |
|---|---|---|---|---|
| Kontrol panggilan tengah | ||||
| - Aktifkan/nonaktifkan video | ✔️ | ✔️ | ✔️ | ❌ |
| - Matikan/Nyalakan suara mikrofon | ✔️ | ✔️ | ✔️ | ❌ |
| - Mematikan suara pengguna jarak jauh | ✔️ | ❌ | ❌ | ❌ |
| - Beralih antar kamera | ✔️ | ✔️ | ✔️ | ❌ |
| - Pembicara aktif | ✔️ | ✔️ | ✔️ | ✔️ |
| - Pilih pembicara untuk panggilan | ✔️ | ✔️ | ✔️ | ✔️ |
| - Pilih mikrofon untuk panggilan | ✔️ | ✔️ | ✔️ | ❌ |
| - Tampilkan status peserta: menganggur, menyambungkan, tersambung, Ditangguhkan, Memutuskan Sambungan, Terputus, dan sebagainya. | ✔️ | ✔️ | ✔️ | ✔️ |
| - Tampilkan status panggilan: Media awal, Masuk, Sambungkan, Dering, Tersambung, Tahan, Putuskan Sambungan, Terputus, dan sebagainya. | ✔️ | ✔️ | ✔️ | ✔️ |
| - Tampilkan apakah peserta dibisukan | ✔️ | ✔️ | ✔️ | ✔️ |
| - Menunjukkan alasan mengapa peserta meninggalkan panggilan | ✔️ | ✔️ | ✔️ | ✔️ |
| - Mulai keterangan panggilan | ✔️ | ✔️ | ✔️ | ✔️ |
| - Mengubah bahasa keterangan | ✔️ | ✔️ | ✔️ | ✔️ |
| - Undang peserta Virtual Room untuk bergabung dalam panggilan | ✔️ | ❌ | ❌ | ❌ |
| Berbagi layar | ||||
| - Bagikan layar | ✔️ * | ✔️ * | ❌ | ❌ |
| - Berbagi aplikasi | ✔️ * | ✔️ * | ❌ | ❌ |
| - Bagikan tab browser | ✔️ * | ✔️ * | ❌ | ❌ |
| - Peserta dapat melihat layar bersama | ✔️ | ✔️ | ✔️ | ✔️ |
| Manajemen daftar | ||||
| - Menghapus peserta | ✔️ | ❌ | ❌ | ❌ |
| Manajemen perangkat | ||||
| - Minta izin untuk menggunakan audio dan/atau video | ✔️ | ✔️ | ✔️ | ❌ |
| - Dapatkan daftar kamera | ✔️ | ✔️ | ✔️ | ❌ |
| - Atur kamera | ✔️ | ✔️ | ✔️ | ❌ |
| - Dapatkan kamera yang dipilih | ✔️ | ✔️ | ✔️ | ❌ |
| - Dapatkan daftar mikrofon | ✔️ * | ✔️ * | ✔️ * | ❌ |
| - Set mikrofon | ✔️ * | ✔️ * | ✔️ * | ❌ |
| - Dapatkan mikrofon yang dipilih | ✔️ * | ✔️ * | ✔️ * | ❌ |
| - Dapatkan daftar pembicara | ✔️ * | ✔️ * | ✔️ * | ✔️ * |
| - Atur speaker | ✔️ * | ✔️ * | ✔️ * | ✔️ * |
| - Dapatkan pembicara yang dipilih | ✔️ | ✔️ | ✔️ | ✔️ |
| Penyajian video | ||||
| - Merender video di beberapa tempat (kamera lokal atau aliran jarak jauh) | ✔️ | ✔️ | ✔️ | ✔️ (Hanya Jarak Jauh) |
| - Mengatur/Memperbarui mode penskalakan video | ✔️ | ✔️ | ✔️ | ✔️ (Hanya Jarak Jauh) |
| - Merender aliran video jarak jauh | ✔️ | ✔️ | ✔️ | ✔️ |
| Memanggil peserta PSTN dari klien | ||||
| - Memanggil peserta PSTN dari panggilan Ruang Virtual | ✔️ | ❌ | ❌ | ❌ |
* Hanya tersedia di SDK panggilan web.
Penanganan acara
Peristiwa panggilan suara dan video yang diterbitkan melalui Event Grid diberi anotasi dengan informasi panggilan ruang.
- CallStarted diterbitkan sebagai notifikasi saat panggilan ruang dimulai.
- CallEnded diterbitkan saat panggilan di ruangan berakhir.
- CallParticipantAdded diterbitkan saat peserta baru bergabung dalam panggilan ruang.
- CallParticipantRemoved diterbitkan saat peserta keluar dari panggilan dalam ruang.
Fitur yang tidak digunakan lagi
Versi pratinjau publik sebelumnya dari Rooms API mendukung dua konfigurasi untuk kontrol daftar nama Rooms, sebagai berikut:
- Ruang Undang Saja yang khusus untuk pengguna yang diundang bergabung dalam panggilan Rooms.
- Ruang Terbuka yang kurang aman. Dalam konfigurasi ruangan terbuka, semua pengguna layanan komunikasi Azure dapat bergabung dalam panggilan tanpa diundang secara eksplisit melalui daftar peserta Ruangan.
Konsep Open Room sekarang tidak digunakan lagi. Ke depan, kamar Hanya Undangan adalah satu-satunya jenis kamar yang didukung.
Batasan Umum
- Azure Communication Services Call Automation saat ini tidak mendukung panggilan ke ruang.
Langkah selanjutnya
- Gunakan QuickStart untuk membuat, mengelola, dan bergabung ke dalam sebuah ruang.
- Pelajari cara bergabung dengan panggilan dalam ruang.
- Pelajari cara mengelola panggilan di ruang.
- Tinjau Persyaratan jaringan untuk media dan sinyal.
- Analisis data Kamar Anda, lihat: Catatan Kamar.
- Pelajari cara menggunakan ruang kerja Analitik Log, lihat: Tutorial Analitik Log.
- Buat kueri Anda sendiri di Analitik Log, lihat: Memulai Kueri.