Sanal Odalara genel bakış
Sanal Odalar, sanal randevular ve grup iletişimleri gibi iyi yapılandırılmış iletişim deneyimleri oluşturmak için geliştiricileri temel güvenlik ve denetim özellikleriyle güçlendirmektedir. Geliştiriciler ses, video ve PSTN çağrıları yürütmek için sanal odaları kullanabilir. Odalardaki güvenlik ve denetimler aşağıdaki gibi sınıflandırılabilir.
Arama katılımcılarına kullanıcı erişimi güvenliği ve denetimleri uygulanır, kimlerin bir aramaya katılabileceğini ve arama sırasında hangi eylemleri gerçekleştirebileceklerini denetler. Örneğin, bir hastanın bir doktorla sanal randevusu sırasında yalnızca yetkili hastane personeli ve hastalar aramaya katılabilir. Katılımcıların sınırlanması hastanın gizliliğini korur ve devam eden aramayı kesintiye uğratmak için katılımcılar atanmış rollerini ve ayrıcalıklarını aşmaz.
Aramanın ne zaman gerçekleştirilebileceğini ve arama sırasında hangi özelliklerin kullanılabilir olduğunu denetlemek için oda düzeyinde güvenlik ve denetimler çağrı düzeyinde uygulanır. Örneğin, öğrenciler yalnızca ayrılan süre boyunca sınıf çağrısına katılma yetkisine sahip olur, ancak PSTN arayan aynı sınıf çağrısına katılamaz.
Sanal Odalarda desteklenen üst düzey özellikler
| Özellik | Rooms çağrısında desteklenir |
|---|---|
| Ses (VoIP) | ✔️ |
| Video | ✔️ |
| İstemci tarafından başlatılan bir PSTN numarasına çevirme | ✔️ |
| PstN numarasına sunucu tarafından başlatılan arama** | ✔️ |
| Sunucu tarafı çağrı yönetimi (Çağrı Otomasyonu)* | ✔️ |
| PSTN Arayarak Bağlanma | ❌ |
| Zaman Uyumsuz Mesajlaşma (Sohbet) | ❌ |
| Microsoft Teams ile birlikte çalışabilirlik | ❌ |
* Bazı özel durumlar geçerlidir. Desteklenen Çağrı Otomasyonu özelliklerinin tam listesi bu belgede listelenmiştir.
** Şu anda genel önizleme aşamasındadır.
Sanal Odalar ne zaman kullanılır?
Aşağıdaki tabloda Sanal Odaların ne zaman kullanılacağı gösterilmektedir.
| Koşul | Odaları Kullanma |
|---|---|
| Bir aramaya kimlerin katılma izni olduğunu denetlemek önemli olduğunda (yalnızca davet etme deneyimi). | ✔️ |
| Çağrının ne zaman başlatılıp sonlandırılıp sonlandırılamını denetlemek önemlidir. | ✔️ |
| İyi yönetilen iletişimleri yürütmek için kullanıcı rolleri ve izinler gerektiğinde. | ✔️ |
| Çözüm, Teams birlikte çalışabilirliğini gerektirdiğinde.* | ❌ |
* Çözüm Teams ile Azure İletişim Hizmetleri arasında birlikte çalışabilirlik gerektiriyorsa Teams birlikte çalışabilirlik çağrılarını kullanın
Sanal Odalarda arama yapma
Yüksek düzeyde, bir Sanal Odalarda arama yapmak için odalar oluşturmanız ve yönetmeniz gerekir. Aşağıdaki tabloda, katılımcıların çağrılara katılmasını ve çağrı içi işlemleri çağırma SDK'sından istemci tarafında ve sunucu tarafında yürütmesini sağlama açıklanmaktadır.
| Özellik | ACS SDK | İstemci ve Sunucu SDK'sı karşılaştırması | Açıklama |
|---|---|---|---|
| Sanal Oda oluşturma ve yönetme | Sanal Odalar SDK'sı | Sunucu | Sanal Odalar SDK'sı, geliştiricilerin Sanal Odalar oluşturup yönetmesine, kullanıcı eklemesine/kaldırmasına, kullanıcı rollerini atamasına/güncelleştirmesine, Sanal Oda zamanlamalarını ayarlamasına/güncelleştirmesine olanak tanır. Geliştiriciler, PstN aramasını Odalardan kısıtlama gibi güvenlik sınırları da ayarlayabilir. |
| Ses, video veya PSTN ile sanal odalar çağrısına katılma ve istemci tarafından başlatılan arama içi işlemleri yürütme | ÇAĞRı SDK'sı | İstemci | Çağırma istemcisi SDK'sı, kullanıcıların atanan kullanıcı rollerinin izin verdiği şekilde bir Sanal Oda çağrısına katılmasını ve istemci tarafı işlemleri yürütmesini sağlar. Sanal Odalar çağrısında güvenlik, Sanal Odalar oluşturma ve yönetimi aracılığıyla belirlenen liste, zamanlama, kullanıcı rolleri ve denetim sınırlarının uygulanması yoluyla sağlanır. Geliştiriciler, İstemci Arama SDK'sını kullanarak arama katılımcılarına sesi kapatma/açma, ekranı paylaşma, videoyu açma/kapatma ve PSTN katılımcısını arama gibi arama içi işlemleri yürütme gücü verir. |
| Arama içi işlemlerin sunucu tarafı yönetimi | Çağrı Otomasyonu SDK'sı | Sunucu | Çağrı Otomasyonu SDK'sı, geliştiricilerin çağrı içi işlemleri sunucu tarafından yürütmesini sağlar. Arama içi işlemler pstn numarasına sunucu tarafından başlatılan arama, arama kaydı, DTMF gönderme/alma, belirli kullanıcılara duyuru gönderme gibi işlemleri içerir. Sunucu tarafı çağrı içi işlemleri çalıştırmak kullanıcılardan bağımsız olduğundan ve geliştiriciler tarafından denetlendiğinden, bu eylemler kullanıcı rolleri tarafından denetlenemez. |
Geliştiriciler, çağrılarının güvenliğini sağlamak ve çağrı içi istemci tarafı/sunucu tarafı işlemlerini tetikleme amacıyla Sanal Odalar SDK'sı, Çağrı istemcisi SDK'sı ve Çağrı Otomasyonu SDK'sını kullanır.
| Özellik | Rooms Server SDK'sı | İstemci SDK'sı Çağırma | Otomasyon Sunucusu SDK'sını Çağırma |
|---|---|---|---|
| Sanal Odalar yönetimi - Sanal Odaları Oluşturma/Alma/Güncelleştirme/Listeleme/Silme | ✔️ | ❌ | ❌ |
| Sanal Oda listesi yönetimi - Sanal Odaya kullanıcı ekleme/güncelleştirme/kaldırma | ✔️ | ❌ | ❌ |
| Sanal Odalar katılımcıları arama izinleri yönetimi - Kullanıcı rollerini atama/güncelleştirme | ✔️ | ❌ | ❌ |
| Sanal Odalar zamanlama yönetimi - İzin verilen Sanal Odaları ayarlama/güncelleştirme zamanlaması | ✔️ | ❌ | ❌ |
| Sanal Odalar güvenlik denetimleri yönetimi - Belirli Sanal Odalardan PSTN aramasına izin vermek için bayrağı ayarlama/güncelleştirme | ✔️ | ❌ | ❌ |
| Sanal Odaya katılmaya davet edilen kullanıcıların listesini alma | ✔️ | ❌ | ❌ |
| Kullanıcı Sanal Odalar çağrısı başlatır veya devam eden bir çağrıya katılır | ❌ | ✔️ | ❌ |
| PSTN kullanıcısını arama | ❌ | ✔️ | ✔️* |
| Devam eden bir aramaya VoIP katılımcıları ekleme/kaldırma | ❌ | ✔️ | ✔️* |
| Devam eden aramaya katılan katılımcıların listesini alma | ❌ | ✔️ | ✔️* |
| Arama açıklamalı alt yazılarını başlatma/durdurma ve açıklamalı alt yazı dilini değiştirme | ❌ | ✔️* | ❌ |
| Arama kaydını yönetme | ❌ | ❌ | ✔️* |
| PSTN katılımcılarına DTMF Gönderme/Alma | ❌ | ❌ | ✔️* |
| Sesli istemleri katılımcılara yürütme | ❌ | ❌ | ✔️* |
İstemci SDK'sını çağırmak, istemci tarafı arama işlemlerinin tam listesini sağlar ve bunların nasıl kullanılacağını açıklar.
* Şu anda genel önizleme aşamasındadır.
Sanal Oda çağrılarını Çağrı Otomasyonu Sunucusu SDK'sını kullanarak sunucu tarafından yönetme
Çağrı Otomasyonu SDK'sı, geliştiricilerin sanal oda çağrılarını sunucu tarafından yönetmesine ve arama içi işlemleri yürütmesine yardımcı olur. Sanal Oda çağrılarında Çağrı Otomasyonu özellikleri aşamalı olarak etkinleştiriliyor. Aşağıdaki tabloda bu özelliklerin geçerli durumu gösterilmektedir. Geliştiriciler, çağrı katılımcısının ayrıcalıklarından daha yüksek bir düzeyde çalışan Çağrı Otomasyonu özelliklerini sunucu tarafında yönetir ve denetler. Bu nedenle Çağrı Otomasyonu özellikleri kullanıcı rolleri ve izinleri aracılığıyla denetlenmiyor.
| Çağrı Otomasyonu özelliği | Rooms çağrısında desteklenir |
|---|---|
| PSTN katılımcısına arayarak bağlanma * | ✔️ |
| PSTN katılımcısına/katılımcısından DTMF gönderme/okuma * | ✔️ |
| Belirli arama katılımcılarına duyuru gönderme * | ✔️ |
| Devam eden bir aramada VoIP katılımcısı ekleme/kaldırma | ✔️ |
| Tüm kullanıcılar için aramayı sonlandır | ✔️ |
| Çağrı transkripsiyonları | ❌ |
| Ses medyası akışı | ❌ |
* Şu anda genel önizleme aşamasındadır.
Bu çizimde odaları yönetme ve odalara katılma kavramları gösterilmektedir.
Çağrı Otomasyonu Sunucusu SDK'sını kullanarak sunucu tarafından başlatılan PSTN Dialout
Geliştiriciler, Odaya özgü pstnDialoutEnabled bayrağını ayarlayarak PSTN katılımcısını arama özelliğini etkinleştirebilir/devre dışı bırakabilir. Geliştirici bir Oda için pstnDialoutEnabled=TRUE değerini ayarladıktan sonra, geliştiriciler istemci tarafı katılımına gerek kalmadan Çağrı Otomasyonu'nu kullanarak sunucu tarafından bir PSTN katılımcısına arama yapabilir.
Örneğin, bir hasta doktoruyla yaklaşan sanal randevusu için yorumlama hizmeti isteyebilir. Çoğu durumda, yorumlama hizmetinin telefon numarası bir arka uç işlemi aracılığıyla dinamik olarak belirlenir. Bu sunucu tarafı PSTN dışarı arama özelliği, geliştiricilerin istemci tarafı eylemlerine gerek kalmadan hedef telefon numarasını belirlemesine, aramayı başlatmasına ve hastanın sanal randevu çağrısına eklemesine olanak tanır.
Çağrı Otomasyonu SDK'sını kullanarak oda çağrısına PSTN numarası eklemek için şu adımları izleyin:
- pstnDialoutEnabled bayrağının ayarlandığı bir oda oluşturma
True - Katılımcılar oda araması başlatır
- Oda kimliği kullanarak oda çağrısına bağlanmak için Çağrı Otomasyonu SDK'sını kullanma
- PSTN numarasını aramak için Çağrı Otomasyonu SDK'sını kullanma
- PSTN kullanıcısı oda aramasını kabul eder ve bir odaya katılır
sanal oda çağrılarını istemci tarafı Arama SDK'larından yönetme
Oda çağrısına katılmak için Arama SDK'larını kullanın. Oda aramaları Web, iOS veya Android Arama SDK'ları kullanılarak birleştirilebilir. Oda aramalarına katılmak için hızlı başlangıç örneklerini burada bulabilirsiniz.
Odalara Azure İletişim Hizmetleri kullanıcı arabirimi kitaplığı kullanılarak da erişilebilir. Kullanıcı Arabirimi Kitaplığı, geliştiricilerin uygulamalarına yalnızca birkaç kod satırıyla Rooms özellikli bir çağrı istemcisi eklemesini sağlar.
İstemci SDK'sı çağrılırken istemci tarafından başlatılan PSTN Arama
Geliştiriciler, odaya özgü pstnDialoutEnabled bayrağını ayarlayarak arama katılımcılarının PSTN katılımcısını aramasına izin verebilir/izin verebilir. Geliştirici bir Oda için pstnDialoutEnabled=TRUE değerini ayarladıktan sonra Sunucu rolüne sahip arama katılımcıları, arama istemcilerinden bir PSTN katılımcısını arayabilir. Aşağıdaki adımlar, İstemci SDK'sını Çağırarak oda çağrısına PSTN numarası eklemek için kullanılır.
- pstnDialoutEnabled bayrağı True olarak ayarlanmış bir oda oluşturma
- Katılımcılar oda araması başlatır
- Sunucu rolüne sahip bir katılımcı aramaya PSTN numarası ekler
- PSTN kullanıcısı oda aramasını kabul eder ve bir odaya katılır
Sanal Odalar API'leri/SDK'ları
Odalar, oda API'leri veya SDK'ları aracılığıyla oluşturulur ve yönetilir. İşlemler için room sunucu uygulamanızdaki oda API'lerini/SDK'larını kullanın:
- Oluştur
- Değiştir
- Sil
- Katılımcı listesini ayarlama ve güncelleştirme
- Oda geçerliliğini ayarlama ve değiştirme
- Kullanıcılara rol ve izin atama
| Sanal Odalar SDK'sı | Sürüm | Durum |
|---|---|---|
| Sanal Oda SDK'ları | 2024-04-15 | Genel Kullanıma Sunuldu - Tam olarak desteklenir |
| Sanal Oda SDK'ları | 2023-06-14 | Genel Kullanıma Sunuldu - Tam olarak desteklenir |
| Sanal Oda SDK'ları | 2023-10-30 | Genel Önizleme - Tam olarak desteklenir |
| Sanal Oda SDK'ları | 2023-03-31 | 30 Nisan 2024'te kullanımdan kaldırılacak |
| Sanal Oda SDK'ları | 2022-02-01 | 30 Nisan 2024'te kullanımdan kaldırılacak |
| Sanal Oda SDK'ları | 2021-04-07 | 30 Nisan 2024'te kullanımdan kaldırılacak |
Sanal Oda çağrılarında önceden tanımlanmış katılımcı rolleri ve izinleri
Oda katılımcılarına şu rollerden biri atanabilir: Sunucu, Katılımcı ve Tüketici.
Aşağıdaki tabloda rollere eşlenen ayrıntılı özellikler sağlanmaktadır. Yüksek düzeyde Sunucu rolü tam denetime sahiptir, Katılımcı özellikleri ses ve video ile sınırlıdır, Tüketici ise yalnızca ses, video ve ekran paylaşımı alabilir.
| Özellik | Rol: Sunucu | Rol: Katılımcı | Rol: Tüketici |
|---|---|---|---|
| Orta arama denetimleri | |||
| - Videoyu açma/kapatma | ✔️ | ✔️ | ❌ |
| - Mikrofonun sesini kapatma/açma | ✔️ | ✔️ | ❌ |
| - Uzak kullanıcının sesini kapatma | ✔️ | ❌ | ❌ |
| - Kameralar arasında geçiş yapma | ✔️ | ✔️ | ❌ |
| - Etkin hoparlör | ✔️ | ✔️ | ✔️ |
| - Aramalar için hoparlör seçme | ✔️ | ✔️ | ✔️ |
| - Aramalar için mikrofon seçme | ✔️ | ✔️ | ❌ |
| - Katılımcıların durumunu göster (boşta, bağlanıyor, bağlı, Beklemede, Bağlantı Kesiliyor, Bağlantısı kesildi vb.) | ✔️ | ✔️ | ✔️ |
| - Arama durumunu göster (Erken medya, Gelen, Bağlanma, Çaldırma, Bağlı, Tutma, Bağlantıyı Kesme, Bağlantı Kesildi | ✔️ | ✔️ | ✔️ |
| - Katılımcının sesinin kapalı olup olmadığını göster | ✔️ | ✔️ | ✔️ |
| - Katılımcının aramadan ayrılma nedenini gösterme | ✔️ | ✔️ | ✔️ |
| - Arama açıklamalı alt yazılarını başlatma ** | ✔️ | ✔️ | ✔️ |
| - Açıklamalı alt yazı dilini değiştirme ** | ✔️ | ✔️ | ❌ |
| - Toplantıyı tüm katılımcılar için sonlandır | ✔️ | ❌ | ❌ |
| - Sanal Oda katılımcısını aramaya katılmaya davet etme | ✔️ | ❌ | ❌ |
| Ekran paylaşımı | |||
| - Paylaşım ekranı | ✔️ * | ❌ | ❌ |
| - Uygulama paylaşma | ✔️ * | ❌ | ❌ |
| - Tarayıcı sekmesini paylaşma | ✔️ * | ❌ | ❌ |
| - Katılımcılar paylaşılan ekranı görüntüleyebilir | ✔️ | ✔️ | ✔️ |
| Liste yönetimi | |||
| - Katılımcıyı kaldırma | ✔️ | ❌ | ❌ |
| Cihaz yönetimi | |||
| - Ses ve/veya video kullanmak için izin isteyin | ✔️ | ✔️ | ❌ |
| - Kamera listesini al | ✔️ | ✔️ | ❌ |
| - Kamerayı ayarla | ✔️ | ✔️ | ❌ |
| - Seçili kamerayı al | ✔️ | ✔️ | ❌ |
| - Mikrofon listesini alma | ✔️ * | ✔️ * | ❌ |
| - Mikrofonu ayarla | ✔️ * | ✔️ * | ❌ |
| - Seçili mikrofonu al | ✔️ * | ✔️ * | ❌ |
| - Konuşmacıları alma listesi | ✔️ * | ✔️ * | ✔️ * |
| - Hoparlörü ayarlama | ✔️ * | ✔️ * | ✔️ * |
| - Seçili hoparlörü alma | ✔️ | ✔️ | ✔️ |
| Video işleme | |||
| - Videoları birden çok yerde işleme (yerel kamera veya uzak akış) | ✔️ | ✔️ | ✔️ (Yalnızca Uzak) |
| - Video ölçeklendirme modunu ayarlama/güncelleştirme | ✔️ | ✔️ | ✔️ (Yalnızca Uzak) |
| - Uzak video akışını işleme | ✔️ | ✔️ | ✔️ |
| İstemci tarafından PSTN katılımcılarına arama yapma | |||
| - Sanal Oda aramalarından PSTN katılımcılarına arayarak bağlanma | ✔️ | ❌ | ❌ |
* Yalnızca web çağrısı SDK'sı üzerinde kullanılabilir. iOS ve Android arama SDK'larında kullanılamaz
** Şu anda genel önizleme aşamasındadır.
Olay işleme
Event Grid aracılığıyla yayımlanan sesli ve görüntülü arama etkinliklerine oda arama bilgileriyle açıklama eklenir.
- CallStarted , bir oda araması başladığında yayımlanır.
- CallEnded , bir oda araması sona erdiğinde yayımlanır.
- Yeni bir katılımcı bir oda çağrısına katıldığında CallParticipantAdded yayımlanır.
- Bir katılımcı oda aramasından düştüğünde CallParticipantRemoved yayımlanır.
Kullanım Dışı Özellikler
Rooms API'sinin önceki bir genel önizleme sürümü, Oda listesi denetimi için aşağıdaki gibi iki yapılandırmayı desteklemektedir:
- Yalnızca davet edilen kullanıcıların Odalar çağrısına katılmasına izin veren Yalnızca Davet Et odası.
- Daha az güvenli bir Açık Oda . Açık oda yapılandırmasında, tüm Azure İletişim Hizmetleri kullanıcıları Oda listesi aracılığıyla açıkça davet edilmeden bir aramaya katılabildi.
Açık Oda kavramı artık kullanım dışı bırakılmıştır. Bundan sonra, desteklenen tek Oda türü Yalnızca Davet Et odalarıdır.
Bilinen Sınırlamalar
- Azure İletişim Hizmetleri Çağrı Otomasyonu özellikleri şu anda Rooms çağrısını desteklemiyor.
Sonraki adımlar:
- Bir oda oluşturmak, yönetmek ve odaya katılmak için Hızlı Başlangıç'ı kullanın.
- Oda aramasına katılmayı öğrenin.
- Oda aramasını yönetmeyi öğrenin.
- Medya ve sinyal için Ağ gereksinimlerini gözden geçirin.
- Odalar verilerinizi analiz edin, bkz. Oda Günlükleri.
- Log Analytics çalışma alanını kullanmayı öğrenin, bkz. Log Analytics Öğreticisi.
- Log Analytics'te kendi sorgularınızı oluşturun, bkz. Başlarken Sorguları.