Arama SDK'sına genel bakış
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 ek özellikler ekleyen isteğe bağlı bir Azure İletişim Hizmetleri API'dir.
Arama SDK'sı ile kendi kullanıcı deneyiminizi oluşturmak için Bkz . Arama hızlı başlangıçları veya Çağrı hero örneği.
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.
SDK bağlantıları
| Platform | Web (JavaScript) | Windows (.NET) | iOS | Android | Diğer |
|---|---|---|---|---|---|
| Arama | npm | NuGet | GitHub | Maven | |
| Kullanıcı Arabirimi Kitaplığı | npm | - | GitHub | GitHub | GitHub, Storybook |
Önemli Özellikler
- 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.
- Teams Toplantıları ve Arama - Arama SDK'sı Teams toplantılara katılabilir ve Teams ses ve video veri düzlemiyle etkileşimde bulunabilir.
- Ş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.
- Video Kısıtlamaları - Arama SDK'sı, farklı video kalitesi düzeyleri için farklı çağrı durumlarını destekleyen çözünürlük ve kare hızı gibi parametreleri ayarlayarak görüntülü aramalar sırasında diğer parametreler arasında video kalitesini düzenleme yeteneği kazanan API'ler sağlar
- 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 | ✔️ | ✔️ | ✔️ | ✔️ |
| Ölçeklendirme modunu ayarlama/güncelleştirme | ✔️ | ✔️ | ✔️ | ✔️ | |
| Uzak video akışını işleme | ✔️ | ✔️ | ✔️ | ✔️ | |
| Video Efektleri | Arka Plan Bulanıklaştırma | ✔️ | ✔️ | ✔️ | ✔️ |
| Özel arka plan resmi | ✔️ | ✔️ | ✔️ | ✔️ | |
| Ses Efektleri | Müzik Modu | ❌ | ✔️ | ✔️ | ✔️ |
| Yankı iptali | ❌ | ✔️ | ✔️ | ✔️ | |
| Gürültü engelleme | ✔️ | ✔️ | ✔️ | ✔️ | |
| Otomatik kazanç denetimi (AGC) | ❌ | ✔️ | ✔️ | ✔️ | |
| Bildirimler 4 | Anında bildirimler | ✔️ | ✔️ | ✔️ | ✔️ |
| Özel bağlam | Aramaya Kullanıcıdan Kullanıcıya (UUI) veya özel üst bilgiler ekleme | ✔️ | ❌ | ❌ | ❌ |
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ılavuzunu ziyaret edin.
3 Çağrı SDK'sının bu işlevler için açık bir API'si yoktur, bunun yerine android ve iOS OS API'lerini kullanmanız gerekir.
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.
- Safari'de bir iOS uygulaması mikrofon ve hoparlör cihazlarını (örneğin, Bluetooth) numaralandıramaz/seçemez. Bu sorun, iOS'un bir sınırlamasıdır ve işletim sistemi varsayılan cihaz seçimini denetler.
İstemciyi çağırma - tarayıcı güvenlik modeli
HTTPS üzerinden WebRTC kullanma
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:
<iframe allow="camera *; microphone *">
Android Arama SDK'sı desteği
- Android API Düzeyi 21 veya Üzeri için destek
- Java 7 veya üzeri için destek
- Android Studio 2.0 desteği
Desteklenen Android platformlarını ziyaret ederek senaryonuzu tanımlamanızı ve doğrulamanızı kesinlikle öneririz
iOS Arama SDK'sı desteği
- 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
Arama süresi üst sınırı 30 saattir, arama süresi üst sınırı olan 30 saate 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, Arama 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 kaç geçerli gelen video akışını destekleyebileceğinizi belirlemek için En uygun Video Sayısı API'sini kullanın. 16 gelen videoyu düzgün bir şekilde desteklemek için bilgisayarda 16 GB RAM'lik bir mimimum ve 3 yaşından eski olmayan 4 çekirdekli veya daha büyük bir CPU olmalıdı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 serilerini 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 veya Teams + ACS aramasına en fazla 350 kullanıcı katılabilir.
- Arama boyutu bir aramada 100'den fazla katılımcıya ulaştığında, yalnızca video kamerasını çeviren en baskın 4 hoparlör görülebilir.
- Aramadaki kişi sayısı 100+ olduğunda, görüntülenebilir gelen video işleme 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.
SDK zaman aşımlarını çağırma
aşağıdaki zaman aşımları İletişim Hizmetleri Çağrı SDK'ları için geçerlidir:
| Eylem | Saniye olarak 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 çağrısı oluşturma zaman aşımı | 115 |
| 1:1 aramasını grup araması zaman aşımına yükseltme | 115 |
Sonraki adımlar
Daha fazla bilgi için aşağıdaki makaleleri inceleyin: