تعقيدات وجه الساعه

الإعلانات

تعقيدات وجه الساعه

 

تعقيدات وجه الساعه

التعقيدات هي أي ميزة في وجه الساعة يتم عرضها بالإضافة إلى الوقت. مثال، مؤشر البطارية عبارة عن تعقيد.

واجهة برمجة تطبيقات التعقيدات تستخدم لكلٍ من، أوجه الساعة وتطبيقات موفر البيانات.

 

اقرأ المصادر التالية:

تصميم أنماط للتعقيدات
أوجه الساعه مع نموذج تعقيدات
كود إختبار لإنشاء وجه للساعة

يصف الجزء المتبقي من هذا المستند موفري البيانات، أوجه الساعه وأنواع التعقيدات.

 

 

 

 

موفري بيانات التعقيد


تسمى التطبيقات التي توفر البيانات (مثل مستوى البطارية أو الطقس أو بيانات عدد الخطوات) لأوجه الساعه الخاصة بالتعقيدات “موفري بيانات التعقيدات”.

يقدم موفروا البيانات هذه بيانات أولية وليست مسؤولة عن التحكم في كيفية عرض بياناتهم على وجه الساعة.

لكتابة التطبيقات التي توفر البيانات لأوجه الساعه، راجع عرض البيانات للتعقيدات.

كما هو موضح في الرسم البياني أدناه، يتوسط نظام تشغيل الساعات من قوقل تدفق البيانات من الموفرين إلى أوجه الساعه.

 

 

 

 

التعقيدات في أوجه الساعة


تتلقى أوجه الساعه البيانات من موفري بيانات التعقيد، مما يسمح لهم بتضمين التعقيدات من دون الحاجة إلى كود للحصول على البيانات الأساسية.

تحتفظ أوجه الساعه بالتحكم في كيفية عرض البيانات، حتى تتمكن من دمج البيانات بشكلٍ طبيعي مع تصاميمها؛ اقرأ تصميم أنماط للتعقيدات.

لمعرفة كيفية إضافة تعقيدات إلى وجه الساعة، راجع إضافة تعقيدات إلى وجه الساعة.

 

 

 

 

 

أنواع التعقيد


أنواع التعقيد تحدد أنواع البيانات التي يمكن عرضها في التعقيدات أو المقدمة من قِبل موفر البيانات.

مثال، يتم إستخدام نوع “النص القصير” SHORT_TEXT عندما تتكون البيانات بشكلٍ أساسي من سلسلة قصيرة.

كائن “بيانات التعقيد” ComplicationData سيحتوي دوماً على نوع تعقيد واحد يقوم بتحديد الحقول المطلوبة والإختيارية.

بشكلٍ عام ، يمثل الحقل المطلوب الجزء الأساسي من البيانات؛ تأخذ معظم الأنواع أسمائها من الحقل المطلوب.

 

يستخدم موفروا البيانات أنواع التعقيدات هذه، بشكلٍ مختلف عن أوجه الساعة: تعقيدات وجه الساعه

 

  • يختار موفر البيانات أنواع بيانات التعقيدات المراد توفيرها (بما في ذلك الحقول الإختيارية من هذه الأنواع لتوفيرها)..

وعدد الأنواع المختلفة التي يمكن دعمها. مثال، قد يدعم موفر عدد الخطوات أنواع RANGED_VALUE و SHORT_TEXT ..

بينما قد يدعم موفر “الإجتماع القادم” نوعي SHORT_TEXT و LONG_TEXT.

 

  • يمكنك إختيار عدد التعقيدات التي يجب تضمينها في وجه الساعة وأنواع التعقيدات التي تحتاج إلى دعم.

مثال، مربع حوار التعقيد على وجه الساعة قد يدعم أنواع SHORT_TEXT و ICON و RANGED_VALUE..

بينما قد يدعم المقياس في وجه الساعة نوع RANGED_VALUE فقط. تعقيدات وجه الساعه تعقيدات وجه الساعه

 

لمعرفة المزيد حول أنواع التعقيدات والحقول المختلفة المدعومة من كل نوع، راجع إستخدام وإختبار أنواع التعقيد.

 

 

 

 

 

ملخص واجهة برمجة التطبيقات


فيما يلي ملخص لواجهة برمجة تطبيقات التعقيدات. واجهة برمجة التطبيقات هي جزء من مكتبة دعم الساعه؛ اقرأ مرجع واجهة برمجة تطبيقات الساعه.

  • ComplicationData بيانات التعقيد
    •  Parcelable (بإستخدام حزمه داخلياً)؛ غير قابل للتغيير
    •  يمثل كافة أنواع بيانات التعقيد
    •  يتضمن باني “بناء” لمثيل الإنشاء

 

  • ComplicationDrawable رسوميات التعقيد
    • تمكنك من تقديم تعقيد كامل على لوحه

 

  • ComplicationHelperActivity نشاط مساعد التعقيد
    •  يستخدم لطلب الإذن التالي:
      com.google.android.wearable.permission.RECEIVE_COMPLICATION_DATA
    •  يستخدم بدلاً من ProviderChooserIntent لبدء المنتقي في كافة الحالات تقريباً

 

  • ComplicationManager مدير التعقيد
    •  غلاف “لخدمة إدارة التعقيد”، لإستخدامها بواسطة الموفرين
    •  يسمح للموفرين بإرسال بيانات التعقيدات إلى النظام

 

  • ComplicationProviderService خدمة موفر التعقيد
    • يوسع الخدمة ويتضمن دوال إستدعاء للرد على نظام التعقيدات
    • يتم إستدعاء كافة دوال الإستدعاء على التسلسل الرئيسي

 

  • ComplicationText نص التعقيد
    •  يستخدم لتزويد القيم المستندة إلى النص في كائن “بيانات التعقيد” ComplicationData
    •  يتضمن خيارات للقيم التي تعتمد على الوقت، والتي تعتمد قيمتها النصية على الوقت الحالي

 

  • ProviderChooserIntent غرض منتقي الموفر
    • فئة “لايمكن إنشاء مثيل” و التي لاتستخدم بشكلٍ شائع؛ بدلاً منها إستخدم ComplicationHelperActivity

 

  • ProviderInfoRetriever
    • يمكن إستخدامها (من خلال أنشطة تكوين وجه الساعة) لإستيراد المعلومات الحالية لموفر البيانات..

(التطبيق، أسم الموفر، الأيقونه) لجميع التعقيدات التي تخص وجه الساعة

 

  • ProviderUpdateRequester
    • يمكن إستخدامها من قبل تطبيقات موفر البيانات لتشغيل الطلبات على OnComplicationUpdated في موفر الخدمة..

لتمكين إرسال تحديثات موفروا النظام

 

  • SystemProviders
    • يسرد موفروا النظام الذين يعتبرون “آمنين”، لأنهم فقط يقدمون المعلومات التي يمكن أن يحصل عليها وجه الساعة بالفعل

 

  • TextRenderer
    • يخفف من رسم النص على اللوحه

بالإضافة إلى ذلك، تحتوي فئة WatchFaceService.Engine على الدوال التالية:

 

  • ()setActiveComplications
    • يجب إستدعائها بواسطة وجه الساعة لإخبار كائن ComplicationManager ما هي فتحات التعقيدات المتاحة وما هي الأنواع المدعومة

 

  • ()onComplicationDataUpdate
    • يتم إستدعائها بواسطة كائن ComplicationManager لإرسال بيانات التعقيد إلى وجه الساعة

 

  • ()setDefaultSystemComplicationProvider
    • تقوم بضبط موفر نظام إفتراضي للتعقيد. تأخذ هذه الدالة معرف (كعدد صحيح) لموفر النظام. يتم سرد المعرفات المتوفرة في فئة SystemProviders.

 


للإطلاع على المقال باللغة الإنجليزية أضغط هنا.

الإعلانات