Arama SDK'sına genel bakış
Önemli
31 Temmuz 2021 ' e kadar JavaScript için SDK 1.1.0 (veya daha yeni) çağıran Azure Iletişim hizmetlerine yükseltin.
Plan B oturum açıklaması Protokolü (SDP) API 'SI kullanım dışıdır. Bu kullanım dışı bırakılmasının Kullanıcı tarafından etkilenmeden kaçınmak için SDK hizmetleri 'ni (veya daha yeni) 31 Temmuz 2021 ' e çağıran Iletişim hizmetlerinizi güncelleştirin. Daha fazla bilgi için bkz. arama Kitaplığı sürüm notları .
Çağıran SDK, son kullanıcı cihazlarının sesli ve görüntülü iletişim deneyimlerini kullanmasına olanak sağlar. Bu sayfa, platform ve tarayıcı destek bilgileri de dahil olmak üzere, çağırma özelliklerinin ayrıntılı açıklamalarını sağlar. Hemen başlamak için, lütfen hızlı başlangıçlara çağrı yapın veya Hero örneği çağırmakonusuna bakın.
Geliştirmeye başladıktan sonra, üzerinde çalıştığımız hataları bulmak için bilinen sorunlar sayfasına göz atın.
Çağıran SDK 'nın temel özellikleri:
- Adresleme -Azure iletişim hizmetleri, iletişim uç noktalarına yönelik olarak kullanılan genel kimlikler sağlar. İstemciler bu kimlikleri, hizmette kimlik doğrulamak ve birbirleriyle iletişim kurmak için kullanır. Bu kimlikler, istemcilere, bir çağrıya (Roster) bağlı olan kullanıcılara görünürlük sağlayan API 'Leri çağırmak için kullanılır.
- Şifreleme -çağıran SDK trafiği şifreler ve tel karşı izinsiz değişiklik yapılmasını önler.
- Cihaz yönetimi ve medya -çağıran SDK, ses ve video cihazlarına bağlama, iletişim veri düzlemi üzerinden etkili iletim için içerik kodlama ve içeriği çıktı cihazlarına ve belirttiğiniz görünümlere göre oluşturan olanaklar sunar. Ayrıca, ekran ve uygulama paylaşımı için API 'Ler de sağlanır.
- PSTN -çağıran SDK, Azure Portal veya programlı olarak elde ettiğiniz telefon numaralarını kullanarak geleneksel, genel olarak anahtarlamalı telefon sistemiyle sesli çağrılar alabilir ve başlatabilir.
- Teams toplantılar -çağıran SDK, Teams toplantılara katılabilir ve Teams ses ve video veri düzlemi ile etkileşime geçebilir.
- Bildirimler -çağıran SDK, istemcilere gelen bir çağrı hakkında bildirim almasına Izin veren API 'ler sağlar. Uygulamanızın ön planda çalışmadığı durumlarda, gelen bir çağrının son kullanıcılarını bilgilendirmek için açılır bildirimleri ("toyalar") tetiklemesi için desenler kullanılabilir.
Ayrıntılı yetenekler
Aşağıdaki liste, şu anda SDK 'Ları çağıran Azure Iletişim hizmetlerinde kullanılabilen özellikler kümesini gösterir.
| Özellik grubu | Özellik | JS | Windows | Java (Android) | Objective-C (iOS) |
|---|---|---|---|---|---|
| Temel yetenekler | İki kullanıcı arasında bire bir çağrı yerleştir | ✔️ | ✔️ | ✔️ | ✔️ |
| İkiden fazla kullanıcısı olan bir grup çağrısı Yerleştir (en fazla 350 Kullanıcı) | ✔️ | ✔️ | ✔️ | ✔️ | |
| İki kullanıcıyla daha fazla kullanıcı içeren bir grup çağrısında bir tek-bir çağrıyı yükseltin | ✔️ | ✔️ | ✔️ | ✔️ | |
| Başlatıldıktan sonra bir grup çağrısına katılır | ✔️ | ✔️ | ✔️ | ✔️ | |
| Başka bir VoIP katılımcısını devam eden bir grup çağrısına katılmaya davet etme | ✔️ | ✔️ | ✔️ | ✔️ | |
| PARÇAAL çağrısı denetimi | Videonuzu açma/kapatma | ✔️ | ✔️ | ✔️ | ✔️ |
| Mikrofonu sustur/aç | ✔️ | ✔️ | ✔️ | ✔️ | |
| Kameralar arasında geçiş yapma | ✔️ | ✔️ | ✔️ | ✔️ | |
| Yerel saklama/tutma | ✔️ | ✔️ | ✔️ | ✔️ | |
| Etkin konuşmacı | ✔️ | ✔️ | ✔️ | ✔️ | |
| Çağrılar için konuşmacı seçin | ✔️ | ✔️ | ✔️ | ✔️ | |
| Çağrılar için mikrofon seçin | ✔️ | ✔️ | ✔️ | ✔️ | |
| Katılımcının durumunu göster Boşta, erken medya, bağlanma, bağlı, bekleme süresi, giriş, bağlantısız |
✔️ | ✔️ | ✔️ | ✔️ | |
| Bir çağrının durumunu göster Erken medya, gelen, bağlantı, çalma, bağlı, bekletme, bağlantısı kesiliyor, bağlantısı kesildi |
✔️ | ✔️ | ✔️ | ✔️ | |
| Bir katılımcının engelli olup olduğunu göster | ✔️ | ✔️ | ✔️ | ✔️ | |
| Katılımcının bir çağrıdan neden ayrıldığını gösterme | ✔️ | ✔️ | ✔️ | ✔️ | |
| Ekran paylaşımı | Ekranın tamamını uygulamanın içinde paylaşma | ✔️ | ❌ | ❌ | ❌ |
| Belirli bir uygulamayı paylaşma (çalışan uygulamalar listesinden) | ✔️ | ❌ | ❌ | ❌ | |
| Açık sekmeler listesinden bir web tarayıcısı sekmesi paylaşma | ✔️ | ❌ | ❌ | ❌ | |
| Katılımcı uzak ekran paylaşımını görüntüleme | ✔️ | ✔️ | ✔️ | ✔️ | |
| Liste | Katılımcıları listele | ✔️ | ✔️ | ✔️ | ✔️ |
| Katılımcıyı kaldırma | ✔️ | ✔️ | ✔️ | ✔️ | |
| PSTN | PSTN katılımcısı ile bire bir çağrıda bulun | ✔️ | ✔️ | ✔️ | ✔️ |
| PSTN katılımcıları ile grup çağrısında bulun | ✔️ | ✔️ | ✔️ | ✔️ | |
| PSTN katılımcısı olan bire bir çağrıyı grup çağrısına yükseltin | ✔️ | ✔️ | ✔️ | ✔️ | |
| PSTN katılımcısı olarak grup çağrısından dışarı çevirme | ✔️ | ✔️ | ✔️ | ✔️ | |
| Genel | Mikrofon, konuşmacı ve kameranızı bir ses testi hizmetiyle test etme (8:echo123 çağrısıyla kullanılabilir) | ✔️ | ✔️ | ✔️ | ✔️ |
| Aygıt Yönetimi | Ses ve/veya video kullanma izni isteme | ✔️ | ✔️ | ✔️ | ✔️ |
| Kamera listesini al | ✔️ | ✔️ | ✔️ | ✔️ | |
| Kamerayı ayarlama | ✔️ | ✔️ | ✔️ | ✔️ | |
| Seçili kamerayı al | ✔️ | ✔️ | ✔️ | ✔️ | |
| Mikrofon listesini al | ✔️ | ✔️ | ❌ | ❌ | |
| Mikrofon ayarlama | ✔️ | ✔️ | ❌ | ❌ | |
| Seçili mikrofonu al | ✔️ | ✔️ | ❌ | ❌ | |
| Konuşmacı listesini al | ✔️ | ✔️ | ❌ | ❌ | |
| Konuşmacı ayarlama | ✔️ | ✔️ | ❌ | ❌ | |
| Seçili konuşmacıyı al | ✔️ | ✔️ | ❌ | ❌ | |
| Video İşleme | Tek videoyu birçok yerde işleme (yerel kamera veya uzak akış) | ✔️ | ✔️ | ✔️ | ✔️ |
| Ölçeklendirme modunu ayarlama /güncelleştirme | ✔️ | ✔️ | ✔️ | ✔️ | |
| Uzak video akışını işleme | ✔️ | ✔️ | ✔️ | ✔️ |
SDK akış desteğini çağırma
İ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önderilene giden yerel akış sayısı üst sayısı | 1 video veya 1 ekran paylaşımı | 1 video + 1 ekran paylaşımı |
| Aynı anda işlenecek gelen uzak akış sayısı üst sayısı | 4 video + 1 ekran paylaşımı | 6 video + 1 ekran paylaşımı |
Çağrı SDK'sı bu sınırları zorlamasa da, kullanıcılarınız aşılırsa performans düşüşüyle karşı karşınıza olabilir.
SDK zaman aşımını çağırma
aşağıdaki zaman aşımı, İletişim Hizmetleri Çağrı SDK'ları için geçerlidir:
| Eylem | Saniye olarak zaman aşımı |
|---|---|
| Yeniden bağlanma/kaldırma katılımcısı | 120 |
| Bir çağrıdan yeni kalıcılık ekleme veya kaldırma (Video veya ekran paylaşımını başlat/durdur) | 40 |
| Çağrı Aktarımı işlemi zaman aşımı | 60 |
| 1:1 çağrı kuruluş zaman aşımı | 85 |
| Grup çağrısı kuruluş zaman aşımı | 85 |
| PSTN çağrısı kuruluş zaman aşımı | 115 |
| Grup çağrısı zaman aşımına 1:1 çağrısını yükseltin | 115 |
Işletim sistemi ve tarayıcı tarafından JavaScript Arama SDK'sı desteği
Aşağıdaki tablo, şu anda kullanılabilir durumda olan desteklenen tarayıcıları temsil eder. Aksi belirtilmedikçe tarayıcının en son üç sürümünü destekliyoruz.
| Platform | Chrome | Safari | Edge (Chromium) |
|---|---|---|---|
| Android | ✔️ | ❌ | ❌ |
| iOS | ❌ | ✔️ | ❌ |
| Mac OS | ✔️ | ✔️ | ❌ |
| Windows | ✔️ | ❌ | ✔️ |
| Ubuntu/Linux | ✔️ | ❌ | ❌ |
- Giden Ekran Paylaşımı iOS veya Android'de desteklenmiyor.
- Safari'de bir iOS uygulaması mikrofon ve konuşmacı cihazlarını (örneğin, Bluetooth) numaralama/seçme seçeneğinin olmadığını gösterir. Bu, işletim sistemiyle ilgili bir sınırlamadır ve her zaman yalnızca bir cihaz vardır ve işletim sistemi varsayılan cihaz seçimini kontrol eder.
Android Arama SDK'sı desteği
Android API Düzey 21 veya Daha Yüksek Desteği
Java 7 veya daha yenisi için destek
Android Studio 2.0 desteği
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+
İstemci çağırma - tarayıcı güvenlik modeli
HTTPS üzerinden Kullanıcı WebRTC
gibi WebRTC getUserMedia API'leri, bu API'leri çağıran uygulamanın HTTPS üzerinden hizmette olması gerekir.
Yerel geliştirme için http://localhost kullanabilirsiniz.
bir iframe'e İletişim Hizmetleri Çağırma SDK'sı ekleme
Çeşitli tarayıcılar tarafından yeni bir izin ilkesi (özellik ilkesi olarak da adlandırılan) benimsenmektedir. Bu ilke, uygulamaların çıkış noktası arası bir iframe öğesi aracılığıyla cihazın kamerasına ve mikrofonuna nasıl erişeyeceğini denetleyerek çağrı senaryolarını etkiler.
Uygulamanın bir bölümünü farklı bir etki alanında barındırmak için bir iframe kullanmak için özniteliğini doğru değerle allow iframe'inize eklemeniz gerekir.
Örneğin, bu iframe hem kameraya hem de mikrofona erişim sağlar:
<iframe allow="camera *; microphone *">
Sonraki adımlar
Daha fazla bilgi için aşağıdaki makaleleri inceleyin:
- Genel çağrı akışlarını tanıma
- Çağrı türleri hakkında bilgi
- PSTN çözümlerinizi planlama