نظرة عامة

AppCard هي مجموعة من عناصر واجهة المستخدم التي يتحكّم مصنّع المعدات الأصلية في تصميمها، ويتم ملؤها بالمعلومات التي تقدّمها التطبيقات. تعرض بطاقات AppCards البيانات والوظائف الأكثر صلة بالتطبيق للمستخدمين بطريقة يسهل الوصول إليها وتكون متاحة دائمًا.

مكوّنات AppCard

الشكل 1. مكوّنات AppCard

يمكن للمطوّرين الخارجيين استخدام AppCards لإجراء ما يلي:

  • عرض حالة طلب الطعام الجاهز لسائق أثناء توجّهه إلى المطعم
  • عرض صور للركاب في المركبات لخلق أجواء ممتعة
  • تتبُّع أسعار العملات المشفّرة وتعديلها بشكل دوري للمستثمرين

تشمل الأمثلة ما يلي:

أمثلة على AppCard

الشكل 2. أمثلة على AppCard

AppCard

المصدر: AppCard.kt

‫AppCard هو عنصر يحتوي على بيانات. نسمح باستخدام ImageAppCard، الذي يتضمّن حالتين. عند تحديد أي نوع من أنواع AppCard، يجب أن يكون لكل مكوّن معرّف فريد.

الشكل 3. صورة تتضمّن نصًا

الشكل 4 شريط التقدّم والأزرار التي تتضمّن نصًا

AppCard ContentProvider

المصدر: AppCardContentProvider.kt

موفّر محتوى مضمّن في تطبيق، وينشئ بطاقات AppCards، ويتم إنشاء مثيل له ويتواصل مع AppCardHost. لمزيد من المعلومات، يمكنك الاطّلاع على AppCardContentProviderExtension.

AppCard Host

المصدر: AppCardHost.kt

تطبيق نظام يتصل بـ AppCardContentProvider لعرض بطاقات التطبيقات وإدارتها. لمزيد من المعلومات، راجِع مقالة ضبط مضيف AppCard.

AppCard Context

المصدر: AppCardContext.kt

كائن يقدّم تلميحات إلى AppCardContentProvider حول كيفية عرض AppCardHost لبطاقة AppCard. يتضمّن AppCardContext المعلومات التالية:

  • مستوى واجهة برمجة التطبيقات
  • فترة إعادة التحميل لما يلي:

    • إكمال تحديثات AppCard
    • مكوّنات AppCard التي تم وضع العلامة EnforceFastUpdateRate عليها
  • هل سيسمح المضيف بالتفاعلات مع AppCard؟

  • الحدّ الأقصى لحجم الصورة:

    • صورة الوسط
    • صورة الزر
    • صورة العنوان
  • الحدّ الأدنى لعدد الأزرار المطلوب عرضها

تتيح هذه المعلومات لمطوّري AppCard تحسين المعلومات التي يتم إرسالها إلى المضيفين.