SDK dan REST API
Kemampuan Azure Communication Services secara konseptual diatur ke dalam area diskrit berdasarkan area fungsionalnya. Sebagian besar area memiliki SDK sumber terbuka sepenuhnya yang diprogram terhadap REST API yang diterbitkan yang dapat Anda gunakan langsung melalui Internet. SDK Panggilan menggunakan antarmuka jaringan kepemilikan dan bersumber tertutup.
Pada tabel di bawah kami merangkum area ini serta ketersediaan REST API dan pustaka SDK. Kami mencatat apakah API dan SDK ditujukan untuk klien pengguna akhir atau lingkungan layanan tepercaya. API seperti SMS tidak boleh diakses langsung oleh perangkat pengguna akhir di lingkungan kepercayaan rendah.
Pengembangan aplikasi Panggilan dan Obrolan dapat dipercepat oleh pustaka antarmuka pengguna Azure Communication Services. Pustaka UI yang dapat disesuaikan menyediakan komponen UI sumber terbuka untuk aplikasi Web dan seluler, dan tema Microsoft Teams.
Membuat praktik untuk menggunakan SDK terbaru
Browser dan sistem operasi terus berkembang untuk mendukung peningkatan terbaru dan untuk memperbaiki bug yang ada. Menggunakan Azure Communication Services SDK terbaru dapat membantu Anda mencapai pengalaman pengguna akhir terbaik secara keseluruhan untuk aplikasi Anda saat digunakan dengan browser yang diperbarui dan pembaruan sistem operasi. SDK Azure Communication Services yang paling baru menawarkan banyak manfaat, seperti performa, keamanan, kompatibilitas, kualitas, dan kegunaan yang lebih baik. Pembaruan memungkinkan Anda mengakses fitur dan pembaruan terbaru yang secara teratur ditambahkan ke browser dan sistem operasi. SDK Azure Communication Services sering diperbarui (sekitar setiap 6 minggu hingga seperempat sekali). Disarankan agar Anda membuat proses untuk memastikan bahwa Anda selalu memperbarui ke SDK terbaru.
SDK
| Rakitan | Protokol | Lingkungan | Kemampuan |
|---|---|---|---|
| Azure Resource Manager | REST | Layanan | Memprovisi dan mengelola sumber daya Communication Services |
| Biasa | T/A | Klien dan Layanan | Menyediakan jenis dasar untuk SDK lainnya |
| Identitas | REST | Layanan | Mengelola pengguna, token akses |
| Nomor telepon | REST | Layanan | Memperoleh dan mengelola nomor telepon |
| SMS | REST | Layanan | Mengirim dan menerima pesan SMS |
| REST | Layanan | Mengirim dan mendapatkan status di pesan Email | |
| Obrolan | REST dengan sinyal kepemilikan | Klien dan Layanan | Menambahkan obrolan teks real time ke aplikasi Anda |
| Memanggil | Transportasi kepemilikan | Klien | Suara, video, berbagi layar, dan komunikasi real time lainnya |
| Automasi Panggilan | REST | Layanan | Membangun alur kerja panggilan yang dikustomisasi untuk panggilan PSTN dan VoIP |
| Router Pekerjaan | REST | Layanan | Mengoptimalkan manajemen interaksi pelanggan di berbagai aplikasi |
| Ruangan | REST | Layanan | Membuat dan mengelola ruang komunikasi terstruktur |
| Pustaka UI | T/A | Klien | Komponen antarmuka pengguna siap produksi untuk aplikasi obrolan dan panggilan |
| Olahpesan Tingkat Lanjut | REST | Layanan | Mengirim dan menerima pesan WhatsApp Business |
Bahasa dan lokasi penerbitan
Lokasi penerbitan untuk paket SDK individual:
| Luas | JavaScript | .NET | Python | Java SE | iOS | Android | Lainnya |
|---|---|---|---|---|---|---|---|
| Azure Resource Manager | npm | NuGet | PyPi | Maven | - | - | Buka melalui GitHub |
| Biasa | npm | NuGet | T/A | Maven | GitHub | Maven | - |
| Identitas | npm | NuGet | PyPi | Maven | - | - | - |
| Nomor Telepon | npm | NuGet | PyPi | Maven | - | - | - |
| Obrolan | npm | NuGet | PyPi | Maven | GitHub | Maven | - |
| SMS | npm | NuGet | PyPi | Maven | - | - | - |
| npm | NuGet | PyPi | Maven | - | - | - | |
| Memanggil | npm | NuGet | - | - | CocoaPods | Maven | - |
| Automasi Panggilan | npm | NuGet | PyPi | Maven | |||
| Router Pekerjaan | npm | NuGet | PyPi | Maven | |||
| Ruangan | npm | NuGet | PyPi | Maven | - | - | - |
| Pustaka UI | npm | - | - | - | GitHub | GitHub | GitHub, Storybook |
| Olahpesan Tingkat Lanjut | npm | NuGet | PyPi | Maven | - | - | - |
| Dokumentasi Rujukan | dokumen | dokumen | dokumen | dokumen | dokumen | dokumen | - |
Detail dukungan platform SDK
Dukungan Android Calling SDK
- Dukungan untuk Android API Level 21 atau Yang Lebih Tinggi
- Dukungan untuk Java 7 atau yang lebih tinggi
- Dukungan untuk Android Studio 2.0
Dukungan platform Android
Ekosistem Android luas, mencakup berbagai versi dan platform khusus yang dirancang untuk berbagai jenis perangkat. Tabel berikutnya mencantumkan platform Android yang saat ini didukung:
| Perangkat | Deskripsi | Dukungan |
|---|---|---|
| Ponsel dan tablet | Perangkat standar yang menjalankan Android Commercial. | Dukungan penuh dengan resolusi video. |
Catatan
Kami hanya mendukung panggilan video di ponsel dan tablet. Untuk kasus penggunaan yang melibatkan video pada perangkat atau platform non-standar (seperti kacamata pintar atau perangkat kustom), sebaiknya hubungi kami di awal proses pengembangan Anda untuk membantu menentukan pendekatan integrasi yang paling cocok.
Jika Anda menemukan masalah selama implementasi, kami mendorong Anda untuk mengunjungi panduan pemecahan masalah.
Dukungan sdk Panggilan iOS
- Dukungan untuk iOS 10.0+ pada waktu build, dan iOS 12.0+ pada waktu berjalan
- XCode 12.0+
- Dukungan untuk iPadOS 13.0+
.NET
Panggilan mendukung platform berikut:
- UWP dengan .NET Native atau C++/WinRT
- Windows 10/11 10.0.17763 - 10.0.22621.0
- Windows Server 2019/2022 10.0.17763 - 10.0.22621.0
- WinUI3 dengan .NET 6
- 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
Semua paket Communication Services lainnya menargetkan .NET Standard 2.0, yang mendukung platform berikut:
- Dukungan melalui .NET Framework 4.6.1
- Windows 10, 8.1, 8 dan 7
- Windows Server 2012 R2, 2012 dan 2008 R2 SP1
- Dukungan melalui .NET Core 2.0:
- Windows 10 (1607+), 7 SP1+, 8.1
- Windows Server 2008 R2 SP1+
- Max OS X 10.12+
- Linux beberapa versi/distribusi
- UWP 10.0.16299 (RS3) September 2017
- Unity 2018.1
- Mono 5.4
- Xamarin iOS 10.14
- Xamarin Mac 3.8
Ukuran paket SDK
| SDK | Ukuran terkompresi (MB) | Ukuran tidak dikompresi (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 |
Jika Anda ingin meningkatkan aplikasi, sebaiknya baca artikel Praktik Terbaik. Ini memberikan rekomendasi dan daftar periksa untuk ditinjau sebelum merilis aplikasi Anda.
REST API
API Communication Services didokumenkan bersama REST API Azure lainnya. Dokumentasi ini memberi tahu Anda cara menyusun pesan HTTP Anda dan menawarkan panduan untuk menggunakan Postman. Dokumentasi antarmuka REST juga diterbitkan dalam format Swagger di GitHub. Anda dapat menemukan batas pembatasan untuk API individual pada halaman batas layanan.
Ekspektasi stabilitas API
Penting
Bagian ini menyediakan panduan tentang REST API dan SDK yang ditandai stabil. API yang ditandai prarilis, pratinjau, atau beta dapat diubah atau tidak digunakan tanpa pemberitahuan.
Di masa mendatang, kami dapat menonaktifkan versi SDK Communication Services dan memperkenalkan perubahan besar pada REST API dan SDK yang telah dirilis. Azure Communication Services umumnya mengikuti dua kebijakan dukungan untuk menghentikan versi layanan:
- Anda diberi tahu setidaknya tiga tahun sebelum diminta untuk mengubah kode karena perubahan antarmuka Communication Services. Semua REST API dan SDK API yang didokumentasikan umumnya diberi peringatan setidaknya tiga tahun sebelum antarmuka dinonaktifkan.
- Anda diberi tahu setidaknya satu tahun sebelum harus memperbarui rakitan SDK ke versi minor terbaru. Pembaruan yang diperlukan ini seharusnya tidak memerlukan perubahan kode karena berada dalam versi utama yang sama. Menggunakan SDK terbaru adalah hal penting bagi pustaka Panggilan dan Obrolan dengan komponen real time yang sering kali memerlukan pembaruan keamanan dan performa. Kami sangat menganjurkan Anda untuk terus memperbarui SDK Communication Services.
Contoh penonaktifan API dan SDK
Anda telah mengintegrasikan versi v24 REST API SMS ke dalam aplikasi Anda. Azure Communication merilis v25.
Anda mendapatkan peringatan tiga tahun sebelum API ini berhenti berfungsi dan dipaksa untuk memperbarui ke v25. Pembaruan ini mungkin memerlukan perubahan kode.
Anda telah mengintegrasikan SDK Panggilan versi v2.02 ke dalam aplikasi Anda. Azure Communication merilis v2.05.
Anda mungkin diharuskan untuk memperbarui SDK Panggilan ke versi v2.05 dalam waktu 12 bulan sejak v2.05 dirilis. Pembaruan harus menjadi pengganti artefak tanpa memerlukan perubahan kode karena v2.05 berada dalam versi utama v2 dan tidak memiliki perubahan yang melanggar.
Langkah berikutnya
Untuk informasi selengkapnya, lihat referensi berikut ini:
- Ringkasan SDK Panggilan
- Gambaran Umum SDK Automation Panggilan
- Gambaran Umum Job Router SDK
- Ringkasan SDK Obrolan
- Ringkasan SDK SMS
- Gambaran Umum SDK Email
- Gambaran Umum SDK Olahpesan Tingkat Lanjut
Untuk mulai menggunakan Azure Communication Services: