Odalara genel bakış
Azure İletişim Hizmetleri, sanal randevular veya sanal etkinlikler gibi yapılandırılmış konuşmalar oluşturan geliştiriciler için bir oda kavramı sağlar. Odalar şu anda sesli ve görüntülü aramaya izin verir.
Odaların yararlı olduğu ana senaryolar şunlardır:
- Odalar zamanlanmış iletişim deneyimi sağlar. Odalar, hizmet platformlarının toplantı stili deneyimler sunmasına yardımcı olurken, çok çeşitli sektör uygulamaları için de uygun bir genelliğe sahiptir. Hizmetler tıbbi tavsiye almak isteyen hastalar, müşterilerle çalışan finansal planlayıcılar ve hukuk hizmetleri sağlayan avukatlar için oda zamanlayabilir ve yönetebilir.
- Odalar, yalnızca davet etme deneyimini etkinleştirir. Odalar, hizmetlerinizin hangi kullanıcıların doktorlarla veya finansal danışmanlarla sanal bir randevu için odaya katılabileceğini denetlemesine olanak sağlar. Bu, yalnızca atanmış İletişim Hizmetleri kimliklerine sahip kullanıcıların bir alt kümesinin oda çağrısına katılmasını sağlar.
- Odalar, roller ve izinler aracılığıyla yapılandırılmış iletişimler sağlar. Odalar, geliştiricilerin iletişimde daha yüksek düzeyde denetim ve yapı kullanmaları için kullanıcılara önceden tanımlanmış roller atamasına olanak tanır. Büyük bir toplantıda veya sanal konferansta yalnızca sunucuların konuşma ve içerik paylaşmasını sağlayın.
- PSTN katılımcıları ekleyin. Aboneliğiniz aracılığıyla veya Azure doğrudan Oturum Sınır Denetleyicisi'ne (SBC) yönlendirme yoluyla satın alınan bir numarayı kullanarak genel anahtarlı telefon ağı (PSTN) katılımcılarını bir aramaya davet edin.
Odalar ne zaman kullanılır?
Aşağıdaki özelliklerden herhangi birine ihtiyacınız olduğunda odaları kullanın:
- Hangi kullanıcıların oda çağrılarına katılabileceğini denetleme.
- Belirtilen saat ve tarihte etkinleştirilen ve süresi dolan zamanlama/koordinatlar gerekir.
- Kullanıcılar için roller ve izinler aracılığıyla yapılandırılmış iletişim gerekir.
| Özellik | 1:N Arama | 1:N Arama kısa ömürlü kimlikle |
Oda araması |
|---|---|---|---|
| Etkileşimli katılımcılar | 350 | 350 | 350 |
| Katılımcılara dağıtmak için kısa ömürlü kimlik | ❌ | ✔️ (Grup Kimliği) |
✔️ (Oda Kimliği) |
| Yalnızca davetli katılımı | ❌ | ❌ | ✔️ |
| PSTN kullanıcısını arama özelliği | ✔️ | ✔️ | ✔️ |
| Arama açıklamalı alt yazıları | ✔️ özel önizleme |
✔️ özel önizleme |
✔️ özel önizleme |
| Arama kaydı | ✔️ | ✔️ | ✔️ genel önizleme |
| Bir aramaya katılmak için iletişim hizmeti kaynağındaki tüm kullanıcılar | ❌ | ✔️ | ✔️ |
| Arama için geçerlilik süresini ayarlama | ❌ | ❌ | ✔️ Altı aya kadar |
| Arama için kullanıcı rollerini ve izinlerini ayarlama | ❌ | ❌ | ✔️ |
| Çağrıyı oluşturmak, kaldırmak, güncelleştirmek, silmek için API | ❌ | ❌ | ✔️ Odalar API'si |
Odaları yönetme ve oda aramalarına katılma
Oda API'si/SDK'sı oda oluşturma, katılımcı ekleme ve zamanlama ayarlama gibi eylemleri gerçekleştirmek için kullanılır. Çağrı SDK'sı, bir Oda içinde çağrıyı istemci tarafından başlatmak için kullanılır. Arama SDK'larında bire bir veya grup aramalarında kullanılabilen eylemlerin çoğu oda aramalarında da kullanılabilir. Arama SDK'sında sunulan özelliklerin tam listesi, Arama SDK'sı Genel Bakış bölümünde listelenmiştir.
| Özellik | ÇAĞRı SDK'sı | Odalar API'si/SDK'sı |
|---|---|---|
| Sesli ve görüntülü oda aramasını katılma | ✔️ | ❌ |
| Oda çağrısına katılan katılımcıları listeleme | ✔️ | ❌ |
| PstN kullanıcısına sanal Odalar düzeyinde dışarı aramaya izin verme/reddetme | ❌ | ✔️ |
| Oda oluştur | ❌ | ✔️ |
| Odaya davet edilen tüm katılımcıları listeleme | ❌ | ✔️ |
| VoIP katılımcısı ekleme veya kaldırma | ❌ | ✔️ |
| Oda katılımcılarına rol atama | ❌ | ✔️ |
Aşağıdaki resimde odaları yönetme ve odalara katılma kavramı gösterilmektedir.
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 roller ve izinler atayın. Ayrıntılar aşağıdadır.
| Sanal Odalar SDK'sı | Sürüm | State |
|---|---|---|
| Sanal Oda SDK'ları | 2024-04-15 | Genel Kullanıma Sunuldu - Tam olarak desteklenir |
| Sanal Oda SDK'ları | 2023-10-30 | Genel Önizleme - Tam olarak desteklenir |
| Sanal Oda SDK'ları | 2023-06-14 | Genel Kullanıma Sunuldu - 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 |
SDK'ları çağırma
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 Odalar etkinleştirilmiş bir çağrı istemcisi eklemesine olanak tanır.
Ö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. Varsayılan olarak, başka bir rol atanmamışsa, kullanıcıya Bir Katılımcı rolü atanır.
Aşağıdaki tablolar rollere eşlenmiş ayrıntılı özellikler sağlar. Yüksek düzeyde Sunucu rolü tam denetime sahiptir, Katılımcı özellikleri ses ve görüntü ile sınırlıdırken Tüketici 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 | ✔️ | ✔️ | ✔️ |
| 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 | ✔️ | ✔️ | ✔️ |
| PSTN katılımcıları ekleme | |||
| - Telefon aramalarını kullanarak katılımcıları arama | ✔️ | ❌ | ❌ |
* 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 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 bir "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ın Oda listesi aracılığıyla açıkça davet edilmeden bir aramaya katılmasına izin verildi.
"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ı olacaktı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.
- 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ı.
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin