تطبيقات نموذجية لحزمة Engage SDK

تتضمّن حزمة تطوير البرامج Engage مجموعة من التطبيقات النموذجية التي توضّح كيفية دمج حزمة تطوير البرامج في تطبيقك لنشر أنواع مختلفة من المحتوى. تُعدّ هذه التطبيقات طريقة رائعة للتعرّف على كيفية استخدام حزمة تطوير البرامج (SDK) والبدء في دمجها في تطبيقك الخاص، بالإضافة إلى بعض أفضل الممارسات.

تتوفّر التطبيقات النموذجية باللغات التالية:

  • Java
  • Kotlin

لتشغيل تطبيق نموذجي، استنسِخ مستودع نماذج Engage SDK وافتح مشروع التطبيق النموذجي في بيئة التطوير المتكاملة (IDE) المفضّلة لديك. بعد ذلك، اتّبِع التعليمات الواردة في ملف README لإنشاء التطبيق وتشغيله.

يتضمّن مستودع تطبيقات العيّنات تطبيقَين لتوضيح كيفية نشر أنواع مختلفة من المحتوى:

تطبيق Read Sample

يوضّح نموذج التطبيق هذا كيفية دمج محتوى "القراءة" باستخدام واجهات برمجة التطبيقات الخاصة بحزمة تطوير البرامج (SDK) Engage. يتضمّن التطبيق استخدام واجهات برمجة تطبيقات مختلفة مذكورة في Engage SDK Read: تعليمات التكامل الفني مع الجهات الخارجية

عند مراجعة هذا التطبيق النموذجي، يجب مراعاة ما يلي:

  • تمت كتابة التطبيق بالكامل بلغة Java.
  • يقع التركيز الرئيسي للرمز في الدليل read/publish، الذي يحتوي على جميع الرموز اللازمة للنشر من خلال حزمة Engage SDK.
  • يوضّح التطبيق كيفية استخدام WorkManager على النحو الموصى به في مستندات Engage API، وEngageServiceWorker هو العامل الذي ينفّذ عملية النشر.
  • يحتوي EbookToEntityConverter على طرق لإنشاء كيان للنشر. هذه الفئة مفيدة لتوضيح كيفية إنشاء عنصر من البيانات المتوفّرة في تطبيقك.

رابط إلى تطبيق Engage SDK Read Sample على GitHub

تطبيق Watch Sample

يوضّح نموذج التطبيق هذا كيفية دمج محتوى الفيديو باستخدام واجهات برمجة التطبيقات الخاصة بحزمة تطوير البرامج Engage. يتضمّن التطبيق استخدام واجهات برمجة تطبيقات مختلفة مذكورة في Engage SDK Watch: تعليمات التكامل الفني مع الجهات الخارجية

عند مراجعة هذا التطبيق النموذجي، يجب مراعاة ما يلي:

  • تمت كتابة التطبيق بالكامل بلغة Kotlin.
  • يقع التركيز الرئيسي للرمز في الدليل watch/publish، الذي يحتوي على جميع الرموز اللازمة للنشر من خلال حزمة Engage SDK.
  • يوضّح التطبيق كيفية استخدام WorkManager على النحو الموصى به في مستندات Engage API، وEngageServiceWorker هو العامل الذي ينفّذ عملية النشر.
  • يحتوي ItemToEntityConverter على طرق لإنشاء كيان للنشر. هذه الفئة مفيدة لتوضيح كيفية إنشاء كيان من البيانات المتوفّرة في تطبيقك.

رابط إلى تطبيق Engage SDK Watch Sample App على GitHub

نصائح إضافية

في ما يلي بعض النصائح الإضافية لاستخدام التطبيقات النموذجية لحزمة تطوير البرامج (SDK) الخاصة بمنصة Engage:

  • استخدِم نماذج التطبيقات لفهم كيفية استدعاء واجهات برمجة تطبيقات معيّنة في حزمة Engage SDK داخل تطبيقك.
  • جرِّب ميزات مختلفة في حزمة Engage SDK.

الدعم

يُرجى التواصل مع engage-developers@google.com إذا كان لديك أي أسئلة لم يتم تناولها هنا.