Aracılığıyla paylaş

SDK'lar ve REST API'ler

Azure İletişim Hizmetleri özellikleri kavramsal olarak işlevsel alanlarına göre ayrık alanlar halinde düzenlenir. Çoğu alan, doğrudan İnternet üzerinden kullanabileceğiniz yayımlanmış REST API'lere göre programlanmış tam açık kaynak SDK'lara sahiptir. Çağrı SDK'sı özel ağ arabirimleri kullanır ve kapalı kaynaktır.

Aşağıdaki tablolarda bu alanlar ve REST API'leri ile SDK kitaplıklarının kullanılabilirliği özetlenir. API'lerin ve SDK'ların son kullanıcı istemcilerine mi yoksa güvenilen hizmet ortamlarına mı yönelik olduğunu not ediyoruz. Düşük güven ortamlarında son kullanıcı cihazlarını kullanarak SMS gibi API'lere doğrudan erişmemelisiniz.

Azure İletişim Hizmetleri kullanıcı arabirimi kitaplığını kullanarak Arama ve Sohbet uygulamalarının geliştirilmesini hızlandırabilirsiniz. Özelleştirilebilir kullanıcı arabirimi kitaplığı, Web ve mobil uygulamalar için açık kaynak kullanıcı arabirimi bileşenleri ve bir Microsoft Teams teması sağlar.

En son SDK'yi kullanmak için bir yöntem oluşturma

Tarayıcılar ve işletim sistemleri, en son iyileştirmeleri desteklemek ve mevcut hataları düzeltmek için sürekli olarak gelişmektedir. En son Azure İletişim Hizmetleri SDK'sını kullanmak, güncelleştirilmiş tarayıcılar ve işletim sistemi güncelleştirmeleriyle kullanıldığında uygulamanız için en iyi genel son kullanıcı deneyimini elde etme konusunda size yardımcı olabilir. En güncelleştirme Azure İletişim Hizmetleri SDK'sı daha iyi performans, güvenlik, uyumluluk, kalite ve kullanılabilirlik gibi birçok avantaj sunar. Güncelleştirme, tarayıcıya ve işletim sistemine düzenli olarak eklenen en yeni özelliklere ve güncelleştirmelere erişmenizi sağlar. Azure İletişim Hizmetleri SDK'lar sık sık güncelleştirilir (yaklaşık altı haftada bir çeyrekte bire kadar). Her zaman en son SDK'lara güncelleştirdiğinizden emin olmak için bir işlem oluşturmanızı öneririz.

SDK

Montaj Protokoller Ortam Özellikler
Azure Resource Manager REST Hizmet İletişim Hizmetleri kaynaklarını sağlama ve yönetme.
Yaygın Yok İstemci ve Hizmet Diğer SDK'lar için temel türler sağlar.
Kimlik REST Hizmet Kullanıcıları ve erişim belirteçlerini yönetin.
Telefon numaraları REST Hizmet Telefon numaralarını alma ve yönetme.
SMS REST Hizmet SMS iletileri gönderme ve alma.
E-posta REST Hizmet E-posta iletilerini gönderin ve durumlarını alın.
Sohbet Özel sinyal ile REST İstemci ve Hizmet Uygulamalarınıza gerçek zamanlı metin sohbeti ekleyin.
Çağrı Özel taşıma Müşteri Ses, video, ekran paylaşımı ve diğer gerçek zamanlı iletişim.
Çağrı Otomasyonu REST Hizmet PSTN ve VoIP çağrıları için özelleştirilmiş çağrı iş akışları oluşturun.
İş Yönlendirici REST Hizmet Çeşitli uygulamalardaki müşteri etkileşimlerinin yönetimini iyileştirin.
Odalar REST Hizmet Yapılandırılmış iletişim odaları oluşturma ve yönetme.
Kullanıcı Arabirimi Kitaplığı Yok Müşteri Sohbet ve arama uygulamaları için üretime hazır kullanıcı arabirimi bileşenleri.
Gelişmiş Mesajlaşma REST Hizmet WhatsApp Business iletileri gönderin ve alın.

Diller ve yayımlama konumları

Tek tek SDK paketleri için yayımlama konumları:

Alan JavaScript .NET Python Java SE iOS Android Diğer
Azure Resource Manager npm NuGet PyPi Maven - - GitHub üzerinden git
Yaygın npm NuGet Yok Maven GitHub Maven -
Kimlik npm NuGet PyPi Maven - - -
Telefon Numaraları npm NuGet PyPi Maven - - -
Sohbet npm NuGet PyPi Maven GitHub Maven -
SMS npm NuGet PyPi Maven - - -
E-posta npm NuGet PyPi Maven - - -
Çağrı npm NuGet - - CocoaPods Maven -
Çağrı Otomasyonu npm NuGet PyPi Maven
İş Yönlendirici npm NuGet PyPi Maven
Odalar npm NuGet PyPi Maven - - -
UI Kitaplığı npm - - - GitHub GitHub GitHub, Storybook
Gelişmiş Mesajlaşma npm NuGet PyPi Maven - - -
Başvuru Belgeleri belgeler belgeler belgeler belgeler belgeler dokümanlar -

SDK platformu destek ayrıntıları

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
Android platform desteği

Android ekosistemi kapsamlıdır ve çeşitli cihaz türleri için tasarlanmış çeşitli sürümleri ve özel platformları kapsar. Sonraki tabloda şu anda desteklenen Android platformları listelenir:

Cihazlar Açıklama Destek
Telefonlar ve tabletler Android Ticari çalıştıran standart cihazlar. Video çözünürlüğünü tam olarak destekleyin.

Not

Yalnızca telefon ve tabletlerde görüntülü aramaları destekleriz. Standart olmayan cihazlarda veya platformlarda (akıllı gözlük veya özel cihazlar gibi) video içeren kullanım örnekleri için, en uygun tümleştirme yaklaşımını belirlemeye yardımcı olmak için geliştirme sürecinizin başlarında bizimle iletişime geçmenizi öneririz.

Uygulamanız sırasında sorun bulduysanız sorun giderme kılavuzuna bakın.

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

.NET

Arama aşağıdaki platformları destekler:

  • .NET Native veya C++/WinRT ile UWP
    • Windows 10/11 10.0.17763 - 10.0.22621.0
    • Windows Server 2019/2022 10.0.17763 - 10.0.22621.0
  • .NET 6 ile WinUI3
    • Windows 10/11 10.0.17763.0 - net6.0-windows10.0.22621.0
    • Windows Server 2019/2022 10.0.17763.0 - net6.0-windows10.0.22621.0

Diğer tüm İletişim Hizmetleri paketleri, aşağıdaki platformları destekleyen .NET Standard 2.0'ı hedefler:

  • .NET Framework 4.6.1 aracılığıyla destek
    • Windows 10, 8.1, 8 ve 7
    • Windows Server 2012 R2, 2012 ve 2008 R2 SP1
  • .NET Core 2.0 aracılığıyla destek:
    • Windows 10 (1607+), 7 SP1+, 8.1
    • Windows Server 2008 R2 SP1+
    • Mac OS X 10.12+
    • Linux birden çok sürümü/dağıtımı
    • UWP 10.0.16299 (RS3) Eylül 2017
    • Unity 2018.1
    • Mono 5.4
    • Xamarin iOS 10.14
    • Xamarin Mac 3.8

Not

Paketlenmemiş uygulama şu anda desteklenmiyor

SDK paket boyutu

SDK Sıkıştırılmış boyut (MB) Sıkıştırılmamış boyut (MB)
iOS SDK Arm64 - 17,1 MB Arm64 - 61,1 MB
Android SDK x86 – 13,3 MB x86 – 33,75 MB
x86_64 – 13,3 MB x86_64 – 35,75 MB
Arm64-v8a – 13,1 MB Arm64-v8a – 37,02 MB
armeabi-v7a – 11,4 MB armeabi-v7a – 23,97 MB

Uygulamanızı geliştirmek istiyorsanız En İyi Yöntemler makalesine bakın. Uygulamanızı yayınlamadan önce gözden geçirmeniz gereken öneriler ve bir denetim listesi sağlar.

REST API'leri

İletişim Hizmetleri API'leri diğer Azure REST API'leriyle belgelenmiştir. Bu belgede HTTP iletilerinizin nasıl yapılandırıldığı açıklanır ve Postman kullanımına yönelik yönergeler sunulur. REST arabirimi belgeleri, GitHub'da OpenAPI biçiminde de yayımlanır. Hizmet sınırları sayfasında, bireysel API'ler için kısıtlama sınırlarını bulabilirsiniz.

API kararlılığı beklentileri

Önemli

Bu bölümde rest API'ler ve kararlı olarak işaretlenmiş SDK'lar hakkında rehberlik sağlanır. Ön sürüm, önizleme veya beta olarak işaretlenen API'ler bildirimde bulunmaksızın değiştirilebilir veya kullanımdan kaldırılabilir.

Gelecekte İletişim Hizmetleri SDK'larının sürümlerini desteklemeyi bırakabiliriz ve REST API'lerimizde ve yayımlanan SDK'larımızda önemli değişiklikler yapabiliriz. Azure İletişim Hizmetleri genellikle hizmet sürümlerini kullanımdan kaldırmaya yönelik iki desteklenebilirlik ilkesi izler:

  • İletişim Hizmetleri arabirim değişikliği nedeniyle kod değiştirmeniz gerekmeden en az üç yıl önce size bildirilir. Belgelenen tüm REST API'ler ve SDK API'leri genellikle arabirimler kullanımdan kaldırilmeden önce en az üç yıl uyarı alır.
  • SDK derlemelerini en son alt sürüme güncellemeniz gerekmeden en az bir yıl önce size haber verilir. Bu gerekli güncelleştirmeler aynı ana sürümde olduğundan kod değişikliği gerektirmemelidir. En son SDK'nın kullanılması, genellikle güvenlik ve performans güncelleştirmeleri gerektiren gerçek zamanlı bileşenlerin çağrı ve sohbet kitaplıkları için özellikle önemlidir. Tüm İletişim Hizmetleri SDK'larınızı güncel tutmanızı kesinlikle öneririz.

API ve SDK devreden çıkarma örnekleri

SMS REST API'sinin v24 sürümünü uygulamanıza tümleştirdiniz. Azure İletişim v25'i yayınlar.

Bu API'lerin çalışmayı durduracağı konusunda üç yıl önceden uyarı alırsınız ve v25'e güncellemeye zorlanırsınız. Bu güncelleştirme için kod değişikliği gerekebilir.

Çağrı SDK'sının v2.02 sürümünü uygulamanıza tümleştirdiniz. Azure İletişim v2.05 sürümünü yayınlar.

v2.05'in yayımlanmasından sonra 12 ay içinde Çağrı SDK'sının v2.05 sürümüne güncelleştirmeniz gerekebilir. Güncelleme, v2.05'in v2 ana sürümünde olması ve herhangi bir hataya neden olan değişiklik içermemesi nedeniyle kod değişikliği gerektirmeden artefaktın yerini alacak şekilde olmalıdır.

Sonraki adımlar

Daha fazla bilgi için aşağıdaki SDK genel bakışlarına bakın:

Azure İletişim Hizmetleri kullanmaya başlamak için: