SDKs و واجهات برمجة التطبيقات REST
يتم تنظيم قدرات Azure Communication Services من الناحية المفاهيمية في مناطق منفصلة استنادا إلى منطقتها الوظيفية. تحتوي معظم المناطق على SDKs مفتوحة المصدر بالكامل مبرمجة مقابل واجهات برمجة تطبيقات REST المنشورة التي يمكنك استخدامها مباشرة عبر الإنترنت. يستخدم Calling SDK واجهات شبكة خاصة ومصدر مغلق.
في الجداول أدناه نلخص هذه المناطق وتوافر واجهات برمجة تطبيقات REST ومكتبات SDK. نلاحظ ما إذا كانت واجهات برمجة التطبيقات وSDKs مخصصة لعملاء المستخدم النهائي أو بيئات الخدمة الموثوق بها. لا ينبغي الوصول مباشرة إلى واجهات برمجة التطبيقات مثل الرسائل النصية القصيرة بواسطة أجهزة المستخدم النهائي في بيئات الثقة المنخفضة.
يمكن تسريع تطوير تطبيقات الاتصال والدردشة بواسطة مكتبة واجهة مستخدم Azure Communication Services. توفر مكتبة واجهة المستخدم القابلة للتخصيص مكونات واجهة مستخدم مفتوحة المصدر لتطبيقات الويب والأجهزة المحمولة ونسق Microsoft Teams.
إنشاء ممارسة لاستخدام أحدث SDK
تتطور المتصفحات وأنظمة التشغيل باستمرار لدعم أحدث التحسينات وإصلاح الأخطاء الموجودة. يمكن أن يساعدك استخدام أحدث Azure Communication Services SDK في تحقيق أفضل تجربة مستخدم شاملة لتطبيقك عند استخدامه مع المستعرضات المحدثة وتحديثات نظام التشغيل. يقدم Azure Communication Services SDK الأكثر تحديثا العديد من الفوائد، مثل الأداء والأمان والتوافق والجودة وسهولة الاستخدام بشكل أفضل. يسمح لك التحديث بالوصول إلى أحدث الميزات والتحديثات التي تتم إضافتها بانتظام إلى المستعرض ونظام التشغيل. يتم تحديث Azure Communication Services SDKs بشكل متكرر (كل 6 أسابيع تقريبا إلى مرة واحدة في ربع السنة). ينصح بإنشاء عملية للتأكد من تحديثك دائما إلى أحدث SDKs.
SDK
| التجميع | البروتوكولات | البيئة | القدرات |
|---|---|---|---|
| Azure Resource Manager | REST | الخدمة | توفير موارد Communication Services وإدارتها |
| عام | غير متوفر | خدمة العميل | توفير أنواع أساسية ل SDKs الأخرى |
| الهوية | REST | الخدمة | إدارة المستخدمين والرموز المميزة للوصول |
| رقم الهاتف | REST | الخدمة | الحصول على أرقام الهواتف وإدارتها |
| SMS | REST | الخدمة | إرسال واستقبال رسائل SMS |
| البريد الإلكتروني | REST | الخدمة | إرسال الحالة والحصول عليها على رسائل البريد الإلكتروني |
| محادثة | REST مع إشارات خاصة | خدمة العميل | إضافة دردشة نصية في الوقت الحقيقي إلى تطبيقاتك |
| الاتصال | النقل الخاص | العميل | الصوت والفيديو ومشاركة الشاشة وغيرها من الاتصالات في الوقت الحقيقي |
| أتمتة المكالمات | REST | الخدمة | إنشاء مهام سير عمل مكالمات مخصصة لمكالمات PSTN وVoIP |
| موجه المهام | REST | الخدمة | تحسين إدارة تفاعلات العملاء عبر التطبيقات المختلفة |
| غرف | REST | الخدمة | إنشاء غرف اتصالات منظمة وإدارتها |
| مكتبة واجهة المستخدم | غير متوفر | العميل | مكونات واجهة المستخدم الجاهزة للإنتاج لتطبيقات الدردشة والمكالمات |
| المراسلة المتقدمة | REST | الخدمة | إرسال رسائل 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
نظام Android البنائي واسع النطاق، ويشمل إصدارات مختلفة ومنصات متخصصة مصممة لمختلف أنواع الأجهزة. يسرد الجدول التالي الأنظمة الأساسية التي تعمل بنظام Android المدعومة حاليا:
| الأجهزة | الوصف | يدعم |
|---|---|---|
| الهواتف وأجهزة الكمبيوتر اللوحي | الأجهزة القياسية التي تعمل بنظام Android Commercial. | دعم كامل مع دقة الفيديو. |
إشعار
نحن ندعم فقط مكالمات الفيديو على الهواتف والأجهزة اللوحية. بالنسبة لحالات الاستخدام التي تتضمن فيديو على أجهزة أو منصات غير قياسية (مثل النظارات الذكية أو الأجهزة المخصصة)، نقترح الاتصال بنا في وقت مبكر من عملية التطوير للمساعدة في تحديد نهج التكامل الأكثر ملاءمة.
في حالة العثور على مشكلات أثناء التنفيذ، نشجعك على زيارة دليل استكشاف الأخطاء وإصلاحها.
دعم 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: