مشاركة عبر

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 بشكل متكرر (كل ستة أسابيع تقريبا إلى مرة كل ربع). نوصي بإنشاء عملية للتأكد من أنك تقوم دائما بالتحديث إلى أحدث 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 بتنسيق OpenAPI على 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 التالية:

لبدء استخدام Azure Communication Services: