Azure İletişim Hizmetleri, son kullanıcı tarayıcılarının, uygulamalarının ve hizmetlerinin ses ve video iletişimi oluşturmasına olanak tanır. Bu sayfa, web sitelerine ve yerel uygulamalara ekleyebileceğiniz İstemci SDK'sı çağırmaya odaklanır. Bu sayfa, platform ve tarayıcı destek bilgileri gibi çağrı istemci özelliklerinin ayrıntılı açıklamalarını sağlar. Hizmetler, Çağrı Otomasyonu API'lerini kullanarak çağrıları program aracılığıyla yönetir ve bu api'lere erişir. Odalar API'si, bir sesli veya görüntülü aramaya roller ve izinler gibi daha fazla özellik ekleyen isteğe bağlı bir Azure İletişim Hizmetleri API'dir.
Not
Azure İletişim Hizmetleri hakkındaki düşüncelerinizi ve geri bildirimlerinizi paylaşmak için bu kısa anketi tamamlayın.
Son kullanıcı deneyimiyle ilgili yardım almak isterseniz Azure İletişim Hizmetleri Kullanıcı Arabirimi Kitaplığı, uygulamanıza bırakabileceğiniz açık kaynak üretime hazır ui bileşenlerinden oluşan bir koleksiyon sağlar. Bu önceden oluşturulmuş denetim kümesiyle, Microsoft'un Fluent tasarım dilini kullanarak güzel iletişim deneyimleri oluşturabilirsiniz. Kullanıcı Arabirimi Kitaplığı hakkında daha fazla bilgi edinmek istiyorsanız genel bakış sitesini ziyaret edin.
Geliştirmeye başladıktan sonra üzerinde çalıştığımız hataları bulmak için bilinen sorunlar sayfasına göz atın.
Cihaz Yönetimi ve Medya - Arama SDK'sı ses ve video cihazlarına bağlama olanağı sağlar, iletişim veri düzlemi üzerinden verimli iletim için içeriği kodlar ve içeriği belirttiğiniz çıkış cihazları ve görünümler için işler. API'ler ayrıca ekran ve uygulama paylaşımı için de sağlanır.
PSTN - Arama SDK'sı, Azure portalında veya program aracılığıyla edindiğiniz telefon numaralarını kullanarak geleneksel genel olarak değiştirilmiş telefon ağıyla sesli aramalar başlatabilir. Oturum kenarlık denetleyicilerini kullanarak kendi numaralarınızı da getirebilirsiniz.
Şifreleme - Arama SDK'sı trafiği şifreler ve kablo üzerinde oynanmasını önler.
Adresleme - Azure İletişim Hizmetleri, iletişim uç noktalarını ele almak için kullanılan genel kimlikler sağlar. İstemciler, hizmette kimlik doğrulaması yapmak ve birbirleriyle iletişim kurmak için bu kimlikleri kullanır. Bu kimlikler, istemcilere bir çağrıya (liste) kimlerin bağlı olduğu hakkında görünürlük sağlayan Çağrı API'lerinde kullanılır.
Kullanıcı Erişim Güvenliği
Liste denetimi, zamanlama denetimi ve kullanıcı rolleri/izinleri Sanal Odalar aracılığıyla uygulanır.
Kullanıcının yeni bir çağrı başlatma veya Mevcut bir aramaya katılma özelliği Kullanıcı Kimlikleri ve Belirteçleri aracılığıyla yönetilebilir
Bildirimler - Arama SDK'sı, istemcilerin gelen bir çağrı hakkında bilgilendirilmesini sağlayan API'ler sağlar. Uygulamanızın ön planda çalışmadığı durumlarda, son kullanıcıları gelen arama hakkında bilgilendirmek için açılır bildirimleri ("bildirimler") tetikleyebileceğiniz desenler kullanılabilir.
Medya İstatistikleri - Arama SDK'sı, VoIP ve görüntülü aramalarınızın ölçümleri hakkında kapsamlı içgörüler sağlar. Bu bilgilerle, geliştiriciler çağrı kalitesini daha net bir şekilde anlayabilir ve iletişim deneyimlerini daha da geliştirmek için bilinçli kararlar alabilir.
Kullanıcıya Yönelik Tanılama (UFD) - Çağrı SDK'sı, çağrı kalitesini etkileyebilecek temel sorunlarla ilgili içgörüler sağlamak için tasarlanmış olaylar sağlar. Geliştiriciler zayıf ağ sinyalleri veya kapalı mikrofonlar gibi tetikleyicilere abone olarak çağrıları etkileyen faktörlerden her zaman haberdar olmalarını sağlayabilir.
Ayrıntılı özellikler
Aşağıdaki listede, Azure İletişim Hizmetleri Çağırma SDK'larında şu anda kullanılabilen özellikler kümesi sunulmaktadır.
Özellik grubu
Özellik
JS
Windows
Java (Android)
Objective-C (iOS)
Temel Özellikler
İki kullanıcı arasında bire bir arama yerleştirme
✔️
✔️
✔️
✔️
İkiden fazla kullanıcıyla (en fazla 100 kullanıcı) grup araması yapın
✔️
✔️
✔️
✔️
İki kullanıcılı bire bir aramayı ikiden fazla kullanıcı içeren bir grup çağrısına yükseltme
✔️
✔️
✔️
✔️
Başlatıldıktan sonra bir grup çağrısına katılma
✔️
✔️
✔️
✔️
Devam eden bir grup çağrısına katılmak için başka bir VoIP katılımcısını davet etme
✔️
✔️
✔️
✔️
Orta çağrı denetimi
Videonuzu açma/kapatma
✔️
✔️
✔️
✔️
Mikrofonun sesini kapatma/açma
✔️
✔️
✔️
✔️
Diğer katılımcıların sesini kapatma
✔️
✔️1
✔️1
✔️1
Kameralar arasında geçiş yapma
✔️
✔️
✔️
✔️
Yerel ayrı tutma/saklamayı kaldırma
✔️
✔️
✔️
✔️
Etkin hoparlör
✔️
✔️
✔️
✔️
Aramalar için hoparlör seçme
✔️
✔️
✔️
✔️
Aramalar için mikrofon seçme
✔️
✔️
✔️
✔️
Katılımcının durumunu gösterme Boşta, Erken medya, Bağlanma, Bağlı, Beklemede, Lobide, Bağlantısı Kesildi
✔️
✔️
✔️
✔️
Aramanın durumunu gösterme Erken Medya, Gelen, Bağlanma, Çaldırma, Bağlı, Tutma, Bağlantıyı Kesme, Bağlantısı Kesildi
✔️
✔️
✔️
✔️
Katılımcının sesinin kapalı olup olmadığını gösterme
✔️
✔️
✔️
✔️
Katılımcının aramadan ayrılma nedenini gösterme
✔️
✔️
✔️
✔️
Ekran paylaşımı
Uygulamanın içinden ekranın tamamını paylaşma
✔️
✔️2
✔️2
✔️2
Belirli bir uygulamayı paylaşma (çalışan uygulamalar listesinden)
✔️
✔️2
❌
❌
Açık sekmeler listesinden web tarayıcısı sekmesini paylaşma
✔️
Ekran paylaşımı sırasında sistem sesini paylaşma
✔️
❌
❌
❌
Katılımcı uzak ekran paylaşımını görüntüleyebilir
✔️
✔️
✔️
✔️
Liste
Katılımcıları listeleme
✔️
✔️
✔️
✔️
Katılımcıyı kaldırma
✔️
✔️
✔️
✔️
PSTN
PSTN katılımcısıyla bire bir arama yerleştirme
✔️
✔️
✔️
✔️
PSTN katılımcılarıyla grup araması yapın
✔️
✔️
✔️
✔️
PSTN katılımcısıyla bire bir aramayı grup çağrısına yükseltme
✔️
✔️
✔️
✔️
PSTN katılımcısı olarak grup aramasından dışarı arama
✔️
✔️
✔️
✔️
Erken medya desteği
✔️
✔️
✔️
✔️
Genel
Mikrofonunuzu, hoparlörünüzü ve kameranızı bir ses test hizmetiyle test edin (8:echo123'i arayarak kullanılabilir)
✔️
✔️
✔️
✔️
Aygıt Yönetimi
Ses ve/veya video kullanmak için izin isteyin
✔️
✔️
✔️
✔️
Kamera listesini alma
✔️
✔️
✔️
✔️
Kamerayı ayarlama
✔️
✔️
✔️
✔️
Seçili kamerayı alma
✔️
✔️
✔️
✔️
Mikrofon listesini alma
✔️
✔️
❌
3
❌
3
Mikrofonu ayarlama
✔️
✔️
❌
3
❌
3
Seçili mikrofonu alma
✔️
✔️
❌
3
❌
3
Konuşmacılar listesini alma
✔️
✔️
❌
3
❌
3
Hoparlörü ayarlama
✔️
✔️
❌
3
❌
3
Seçili konuşmacıyı alma
✔️
✔️
❌
3
❌
3
Video İşleme
Birçok yerde (yerel kamera veya uzak akış) tek bir video işleme
1 Başkalarının Sesini Kapatma özelliği şu anda genel önizleme aşamasındadır.
2 Paylaşım Ekranı özelliği Ham Medya API'leri kullanılarak elde edilebilir. Daha fazla bilgi edinmek için ham medya erişimi hızlı başlangıç kılavuzuna bakın.
3 Çağrı SDK'sının bu işlevler için açık bir API'si yoktur. Bunun yerine başarmak için Android ve iOS OS API'lerini kullanın.
4 Yerel platformlarda TTL için en yüksek değer 180 gündür (15.552.000 saniye) ve en düşük değer 5 dakikadır (300 saniye). CTE (Özel Teams Uç Noktası)/M365 Kimliği için en fazla TTL değeri 24 saat (86.400 saniye) olur.
İşletim sistemi ve tarayıcı tarafından JavaScript Çağrı SDK'sı desteği
Aşağıdaki tablo, şu anda kullanılabilen desteklenen tarayıcı kümesini temsil eder.
Aksi belirtilmedikçe tarayıcının en son üç ana sürümünü (Safari için en son üç ikincil sürüm) destekliyoruz.
Platform
Chrome
Safari
Edge
Firefox
Web görünümü
Electron
Android
✔️
❌
✔️
❌
✔️
❌
iOS
✔️
✔️
✔️
❌
✔️
❌
macOS
✔️
✔️
✔️
✔️
❌
✔️
Windows
✔️
❌
✔️
✔️
❌
✔️
Ubuntu/Linux
✔️
❌
❌
❌
❌
❌
Giden Ekran Paylaşımı iOS veya Android mobil tarayıcılarında desteklenmez.
Firefox desteği genel önizleme aşamasındadır.
Şu anda, çağrı SDK'sı genel önizlemede yalnızca Android'de Android System WebView'u, iOS WebView'u (WKWebView) destekler. Diğer işletim sistemi platformlarında diğer ekli tarayıcı türleri veya WebView resmi olarak desteklenmez, örneğin GeckoView, Chromium Embedded Framework (CEF), Microsoft Edge WebView2. Bu platformlarda JavaScript Arama SDK'sı çalıştırmak etkin olarak test edilmediğinden çalışabilir veya çalışmayabilir.
Gibi getUserMedia WebRTC API'leri, bu API'leri çağıran uygulamanın HTTPS üzerinden hizmetlendirilmesini gerektirir. Yerel geliştirme için kullanabilirsiniz http://localhost.
İletişim Hizmetleri Arama SDK'sını bir iframe'e ekleme
Çeşitli tarayıcılarda yeni bir izin ilkesi (özellik ilkesi olarak da adlandırılır) kullanılabilir. Bu ilke, uygulamaların çıkış noktaları arası bir iframe öğesi aracılığıyla cihazın kamerasına ve mikrofona nasıl erişebileceğini denetleyerek çağrı senaryolarını etkiler.
Uygulamanın bir bölümünü farklı bir etki alanından barındırmak için bir iframe kullanmak istiyorsanız, iframe'inize doğru değere sahip özniteliği eklemeniz allow gerekir.
Örneğin, bu iframe hem kamera hem de mikrofon erişimine izin verir:
Derleme zamanında iOS 10.0+ ve çalışma zamanında iOS 12.0+ desteği
Xcode 12.0+
iPadOS 13.0+ desteği
Maksimum arama süresi
Maksimum arama süresi 30 saattir ve en fazla 30 saatlik arama süresine ulaşan katılımcıların aramayla bağlantısı kesilir.
Desteklenen gelen video akışı sayısı
Azure İletişim Hizmetleri Çağırma SDK'sı aşağıdaki akış yapılandırmalarını destekler:
Sınır
Web
Windows/Android/iOS
Aynı anda gönderilebilen en fazla giden yerel akış sayısı
1 video ve 1 ekran paylaşımı
1 video + 1 ekran paylaşımı
Aynı anda işlenebilen en fazla gelen uzak akış sayısı
Masaüstü tarayıcılarda 16 video + 1 ekran paylaşımı*, web mobil tarayıcılarında 4 video + 1 ekran paylaşımı
9 video + 1 ekran paylaşımı
* Azure İletişim Hizmetleri Web Çağrısı SDK'sı sürüm 1.16.3'ten başlayarak. Çağrı SDK'sı bu sınırları zorlamasa da, kullanıcılarınız aşılırsa performans düşüşü yaşayabilir. Web ortamınızın destekleyebileceğiniz gelen video akışlarının sayısını belirlemek için En uygun Video Sayısı API'sini kullanın. 16 gelen videoyu düzgün bir şekilde desteklemek için, bilgisayarın en az 16 GB RAM'e ve 3 yaşından küçük 4 çekirdekli veya daha büyük bir CPU'ya ihtiyacı vardır.
Desteklenen video çözünürlükleri
Azure İletişim Hizmetleri Arama SDK'sı, arama sırasında video ve ekran paylaşımı akışlarının çözünürlüklerini otomatik olarak ayarlar.
Not
Çözüm, bir aramadaki katılımcı sayısına, istemcinin kullanabileceği bant genişliği miktarına, uzak video akışlarını işleyen yerel katılımcının donanım özelliklerine ve diğer genel çağrı parametrelerine bağlı olarak farklılık gösterebilir.
Azure İletişim Hizmetleri Arama SDK'sı aşağıdaki video çözünürlüklerinin gönderilmesini destekler
Maksimum video çözünürlüğü
WebJS
iOS
Android
Pencereler
Video gönderme
720P
720P
720P
1080P
Ekran paylaşımı gönderiliyor
1080P
1080P
1080P
1080P
Uzak video akışı veya ekran paylaşımı alma
1080P
1080P
1080P
1080P
Arama desteğindeki katılımcı sayısı
Bir grup aramasına, Oda aramasına veya Teams + Azure İletişim Hizmetleri aramaya en fazla 350 kullanıcı katılabilir.
Arama boyutu 100'den fazla katılımcıya ulaştığında, Arama SDK'sı yalnızca video kamerası etkin olan ilk dört baskın konuşmacıyı görüntüler.
Aramadaki kişi sayısı 100+ olduğunda, görüntülenebilir gelen video sayısı otomatik olarak 4x4'ten (16 gelen video) 2x2'ye (4 gelen video) düşer.
Kullanıcı sayısı 100'ün altına indiğinde, desteklenen gelen videoların sayısı 4x4'e (16 gelen video) kadar geri gider.
ÇAĞRı SDK'sı zaman aşımları
aşağıdaki zaman aşımları İletişim Hizmetleri Çağrı SDK'ları için geçerlidir:
Eylem
Saniyeler içinde zaman aşımı
Katılımcıyı yeniden bağlama/kaldırma
60
Aramada yeni modalite ekleme veya kaldırma (Videoyu başlat/durdur veya ekran paylaşımı)
40
Arama Aktarımı işlemi zaman aşımı
60
1:1 arama kuruluş zaman aşımı
85
Grup araması oluşturma zaman aşımı
85
PSTN arama kuruluşu zaman aşımı
115
1:1 aramasını grup araması zaman aşımına yükseltme
Learn the meetings and calling features in Microsoft Teams, including managing meetings experiences, managing Microsoft Teams devices, managing calling features with Calling Plans and Microsoft Teams, and the basic troubleshooting tool for Teams issue.
Geliştiricilerin örneğin iç çalışmalarıyla ilgili daha fazla bilgi edinebilmesi için Azure İletişim Hizmetleri kullanarak hero örneğini çağırmaya genel bakış.