SDKs و واجهات برمجة التطبيقات REST
يتم تنظيم قدرات Azure Communication Services من الناحية المفاهيمية في مناطق منفصلة استنادا إلى منطقتها الوظيفية. تحتوي معظم المناطق على SDKs مفتوحة المصدر بالكامل مبرمجة مقابل واجهات برمجة تطبيقات REST المنشورة التي يمكنك استخدامها مباشرة عبر الإنترنت. يستخدم Calling SDK واجهات شبكة خاصة ومصدر مغلق.
في الجداول أدناه نلخص هذه المناطق وتوافر واجهات برمجة تطبيقات REST ومكتبات SDK. نلاحظ ما إذا كانت واجهات برمجة التطبيقات وSDKs مخصصة لعملاء المستخدم النهائي أو بيئات الخدمة الموثوق بها. لا ينبغي الوصول مباشرة إلى واجهات برمجة التطبيقات مثل الرسائل النصية القصيرة بواسطة أجهزة المستخدم النهائي في بيئات الثقة المنخفضة.
يمكن تسريع تطوير تطبيقات الاتصال والدردشة بواسطة مكتبة واجهة مستخدم Azure Communication Services. توفر مكتبة واجهة المستخدم القابلة للتخصيص مكونات واجهة مستخدم مفتوحة المصدر لتطبيقات الويب والأجهزة المحمولة ونسق Microsoft Teams.
SDK
| التجميع | البروتوكولات | البيئة | القدرات |
|---|---|---|---|
| Azure Resource Manager | بقيه | الخدمة | توفير موارد Communication Services وإدارتها |
| عام | غير متوفر | خدمة العميل | توفير أنواع أساسية ل SDKs الأخرى |
| الهوية | بقيه | الخدمة | إدارة المستخدمين والرموز المميزة للوصول |
| رقم الهاتف | بقيه | الخدمة | الحصول على أرقام الهواتف وإدارتها |
| SMS | بقيه | الخدمة | إرسال واستقبال رسائل SMS |
| البريد الإلكتروني | بقيه | الخدمة | إرسال الحالة والحصول عليها على رسائل البريد الإلكتروني |
| محادثة | REST مع إشارات خاصة | خدمة العميل | إضافة دردشة نصية في الوقت الحقيقي إلى تطبيقاتك |
| الاتصال | النقل الخاص | العميل | الصوت والفيديو ومشاركة الشاشة وغيرها من الاتصالات في الوقت الحقيقي |
| أتمتة المكالمات | بقيه | الخدمة | إنشاء مهام سير عمل مكالمات مخصصة لمكالمات PSTN وVoIP |
| موجه المهام | بقيه | الخدمة | تحسين إدارة تفاعلات العملاء عبر التطبيقات المختلفة |
| غرف | بقيه | الخدمة | إنشاء غرف اتصالات منظمة وإدارتها |
| مكتبة واجهة المستخدم | غير متوفر | العميل | مكونات واجهة المستخدم الجاهزة للإنتاج لتطبيقات الدردشة والمكالمات |
| المراسلة المتقدمة | بقيه | الخدمة | إرسال رسائل WhatsApp Business وتلقيها |
اللغات ومواقع النشر
مواقع النشر لحزم SDK الفردية:
| المنطقة | JavaScript | .NET | Python | Java SE | iOS | Android | أخرى |
|---|---|---|---|---|---|---|---|
| Azure Resource Manager | npm | NuGet | PyPi | Maven | - | - | انتقل عبرGitHub |
| عام | npm | NuGet | غير متوفر | Maven | GitHub | Maven | - |
| الهوية | npm | NuGet | PyPi | Maven | - | - | - |
| أرقام الهاتف | npm | NuGet | PyPi | Maven | - | - | - |
| محادثة | npm | NuGet | PyPi | Maven | GitHub | Maven | - |
| SMS | npm | NuGet | PyPi | Maven | - | - | - |
| البريد الإلكتروني | npm | NuGet | PyPi | Maven | - | - | - |
| الاتصال | npm | NuGet | - | - | CocoaPods | Maven | - |
| أتمتة المكالمات | npm | NuGet | PyPi | Maven | |||
| موجه المهام | npm | NuGet | PyPi | Maven | |||
| غرف | npm | NuGet | PyPi | Maven | - | - | - |
| مكتبة واجهة المستخدم | npm | - | - | - | GitHub | GitHub | GitHub, Storybook |
| المراسلة المتقدمة | npm | NuGet | PyPi | Maven | - | - | - |
| الوثائق المرجعية | docs | docs | docs | docs | docs | docs | - |
تفاصيل دعم النظام الأساسي SDK
دعم SDK الاتصال بنظام التشغيل Android
- دعم واجهة برمجة التطبيقات لـAndroid للمستوى 21 أو أعلى
- دعم Java 7 أو أعلى
- الدعم لـ Android Studio 2.0
- أجهزة Android Auto (AAOS) وIoT التي تعمل بنظام Android غير مدعومة حاليا
دعم iOS Calling SDK
- دعم iOS 10.0+ في وقت الإنشاء، و iOS 12.0+ في وقت التشغيل
- Xcode 12.0+
- دعم iPadOS 13.0+
.NET
يدعم الاتصال الأنظمة الأساسية التالية:
- UWP مع .NET Native أو C++/WinRT
- Windows 10/11 10.0.17763 - 10.0.22621.0
- Windows Server 2019/2022 10.0.17763 - 10.0.22621.0
- WinUI3 مع .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
تستهدف جميع حزم Communication Services الأخرى .NET Standard 2.0، والذي يدعم الأنظمة الأساسية التالية:
- الدعم عبر .NET Framework 4.6.1
- Windows 10 و8.1 و8 و7
- Windows Server 2012 R2 و2012 و2008 R2 SP1
- الدعم عبر .NET Core 2.0:
- Windows 10 (1607+)، 7 SP1+، 8.1
- Windows Server 2008 R2 SP1+
- الحد الأقصى لنظام التشغيل X 10.12+
- Linux إصدارات/توزيعات متعددة
- UWP 10.0.16299 (RS3) سبتمبر 2017
- Unity 2018.1
- Mono 5.4
- Xamarin iOS 10.14
- Xamarin Mac 3.8
حجم حزمة SDK
| SDK | حجم مضغوط (ميغابايت) | حجم غير مضغوط (ميغابايت) |
|---|---|---|
| حزمة تطوير برامج الأجهزة التي تعمل بنظام التشغيل iOS | ARM64 - 17.1 ميغابايت | ARM64 - 61.1 ميغابايت |
| حزمة تطوير برامج الأجهزة التي تعمل بنظام التشغيل Android | x86 – 13.3 ميغابايت | x86 – 33.75 ميغابايت |
| x86_64 – 13.3 ميغابايت | x86_64 – 35.75 ميغابايت | |
| ARM64-v8a – 13.1 ميغابايت | ARM64-v8a – 37.02 ميغابايت | |
| armeabi-v7a – 11.4 ميغابايت | armeabi-v7a – 23.97 ميغابايت |
إذا كنت تريد تحسين تطبيقك، نقترح قراءة مقالة أفضل الممارسات. يوفر توصيات وقائمة اختيار لمراجعتها قبل إصدار تطبيقك.
واجهة برمجة تطبيقات REST
يتم توثيق واجهات برمجة تطبيقات Communication Services جنبا إلى جنب مع واجهات برمجة تطبيقات Azure REST الأخرى. تخبرك هذه الوثائق كيفية هيكلة رسائل HTTP الخاصة بك وتقدم إرشادات لاستخدام Postman. يتم أيضا نشر وثائق واجهة REST بتنسيق Swagger على GitHub. يمكنك العثور على حدود التقييد لواجهات برمجة التطبيقات الفردية في صفحة حدود الخدمة.
توقعات استقرار واجهة برمجة التطبيقات
هام
يوفر هذا القسم إرشادات حول واجهات برمجة تطبيقات REST وSDKs المميزة بالاستقرار. قد يتم تغيير واجهات برمجة التطبيقات التي تم وضع علامة عليها قبل الإصدار أو المعاينة أو بيتا أو إهمالها دون إشعار.
في المستقبل، قد نتوقف عن إصدارات SDKs لخدمات الاتصالات، وقد نقدم تغييرات كسرية على واجهات برمجة تطبيقات REST الخاصة بنا وSDKs التي تم إصدارها. تتبع Azure Communication Services بشكل عام نهجين للدعم لإيقاف إصدارات الخدمة:
- سيتم إعلامك قبل ثلاث سنوات على الأقل من مطالبتك بتغيير التعليمات البرمجية بسبب تغيير واجهة Communication Services. تتمتع جميع واجهات برمجة تطبيقات REST الموثقة وواجهات برمجة تطبيقات SDK بشكل عام بتحذير لمدة ثلاث سنوات على الأقل قبل إيقاف تشغيل الواجهات.
- سيتم إعلامك قبل عام واحد على الأقل من الحاجة إلى تحديث تجميعات SDK إلى أحدث إصدار ثانوي. يجب ألا تتطلب هذه التحديثات المطلوبة أي تغييرات في التعليمات البرمجية لأنها في نفس الإصدار الرئيسي. يعد استخدام أحدث SDK مهما بشكل خاص لمكتبات الاتصال والدردشة التي تتطلب في الوقت الفعلي تحديثات الأمان والأداء. نحن نشجعك بشدة على الحفاظ على تحديث جميع SDKs لخدمات الاتصالات الخاصة بك.
أمثلة على إيقاف تشغيل واجهة برمجة التطبيقات وSDK
لقد قمت بدمج إصدار v24 من واجهة برمجة تطبيقات REST SMS في تطبيقك. إصدارات Azure Communication v25.
ستحصل على تحذير لمدة ثلاث سنوات قبل أن تتوقف واجهات برمجة التطبيقات هذه عن العمل وتضطر إلى التحديث إلى الإصدار 25. قد يتطلب هذا التحديث تغيير التعليمات البرمجية.
لقد قمت بدمج إصدار v2.02 من Calling SDK في التطبيق الخاص بك. تصدر Azure Communication الإصدار 2.05.
قد يطلب منك التحديث إلى إصدار v2.05 من Calling SDK في غضون 12 شهرا من إصدار v2.05. يجب أن يكون التحديث بديلا عن البيانات الاصطناعية دون الحاجة إلى تغيير التعليمات البرمجية لأن v2.05 في الإصدار الرئيسي v2 وليس له تغييرات فاصلة.
الخطوات التالية
لمزيد من المعلومات، راجع نظرة عامة على SDK التالية:
- نظرة عامة على استدعاء SDK
- نظرة عامة على أتمتة المكالمات SDK
- نظرة عامة على SDK لموجه الوظيفة
- نظرة عامة على Chat SDK
- نظرة عامة على SDK SMS
- نظرة عامة على البريد الإلكتروني SDK
- نظرة عامة على SDK للمراسلة المتقدمة
لبدء استخدام Azure Communication Services: