استخدام نموذج التطبيق

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

بعد اكتمال تفويض الحساب واختيار بنية، يحمِّل تطبيق النموذج جميع الأجهزة المحلية المتوفّرة في تلك البنية. إذا كان الجهاز في غرفة، سيتم إدراجه ضمن تلك الغرفة. يتيح تطبيق النموذج أنواع الأجهزة التالية:

  • ضوء درجة حرارة الألوان (التفعيل والإيقاف والسطوع)
  • جهاز استشعار الاتّصال (حالة منطقية)
  • الإضاءة الخافتة (التفعيل والإيقاف والسطوع)
  • الإضاءة الموسّعة بالألوان (التفعيل والإيقاف، السطوع)
  • مفتاح عام
  • أداة استشعار تواجد الأفراد في المنزل
  • تشغيل/إيقاف الإضاءة (تشغيل وإيقاف، السطوع)
  • مفتاح تشغيل/إيقاف الإضاءة
  • وحدة المكونات الإضافية للتشغيل/الإيقاف (تشغيل وإيقاف)
  • أداة استشعار التشغيل/الإيقاف

الإجراءات على الأجهزة الحالية وعمليات التشغيل الآلي

يتألّف نموذج التطبيق من علامتَي تبويب، وهما الأجهزة وعمليات التشغيل الآلي. تقدّم كل علامة تبويب معلومات عن البنية وتسمح لك بتنفيذ المهام.

علامة التبويب "الأجهزة"

تعرض علامة التبويب الأجهزة (الشكل 1) الغرف في البنية (الحديقة الخلفية، والدور العلوي، والسفر) والأجهزة لكل غرفة، بالإضافة إلى حالة كل جهاز. لعرض السمات على جهاز أو تعديلها، انقر على اسم الجهاز. سينقلك هذا الإجراء إلى شاشة التحكّم في هذا الجهاز (الشكل 2).

لإضافة جهاز إلى البنية، انقر على إضافة جهاز من علامة التبويب الأجهزة (الشكل 1)، ثم اتّبِع التعليمات لإضافة جهاز باستخدام رمز استجابة سريعة أو بدونه.

علامة التبويب "الأجهزة" في تطبيق نموذج Home APIs
الشكل 1: شاشة تطبيق نموذجية: عرض علامة التبويب "الأجهزة"
عناصر التحكّم في الأجهزة في تطبيق نموذج Home APIs
الشكل 2: عناصر التحكّم في الأجهزة في التطبيق النموذجية

علامة التبويب "عمليات التشغيل الآلي"

تعرِض علامة التبويب عمليات التشغيل الآلي (الشكل 3) قائمة بجميع عمليات التشغيل الآلي لملف الالتفاف. يعرض كلّ إجراء مبرمَج إجراءات التفعيل والإجراءات. يمكن استخدام عدة عوامل بدء وإجراءات.

انقر على إحدى الإجراءات المبرمَجة للاطّلاع على تفاصيلها، كما هو موضّح في المثال في الشكل 4. في هذه الرؤية التفصيلية، يمكنك حذف عملية التشغيل الآلي أو تنفيذ عملية التشغيل الآلي يدويًا بدون الحاجة إلى بدء عملية التشغيل الآلي، شرط أن يكون الزر تنفيذ يدويًا متوافقًا مع عملية التشغيل الآلي هذه.

في العرض التفصيلي لعملية التشغيل الآلي (الشكل 4)، يمكنك أيضًا تبديل قيمة الحقل isActive لتفعيل عملية التشغيل الآلي أو إيقافها. يحدّد حِزمة تطوير البرامج (SDK) قيمة الحقل isValid، وتكون القيمة false في حال حدوث مشكلة في توفّر الجهاز أو السمة أو مشكلة أخرى.

علامة التبويب "عمليات التشغيل الآلي" في تطبيق نموذج Home APIs
الشكل 3: عرض علامة التبويب "عمليات التشغيل الآلي"
عرض تفصيلي لعملية التشغيل الآلي المحدّدة
الشكل 4: عرض تفصيلي لعملية تشغيل آلي واحدة

إنشاء عملية تشغيل آلي

لإنشاء عملية مبرمَجة جديدة، انقر على الزر إنشاء من عرض قائمة المهام المبرمَجة (الشكل 3). تظهر شاشة عملية التشغيل الآلي الجديدة (الشكل 5).

استخدِم الزرَّين +إضافة إجراء تفعيل و+إضافة إجراء (الشكل 5) لإضافة إجراء تفعيل وإجراء واحدَين أو أكثر إلى الإجراء المبرمَج. يعرض الشكلان 6 و7 مثالين لاختيار إجراء تفعيل وإجراء، على التوالي. بعد تحديد الخيارات وحفظ إجراء التفعيل أو الإجراء، سيظهر لك زرَّا تعديل إجراء التفعيل وإزالة إجراء التفعيل للإجراء التفعيل (وتعديل الإجراء وإزالة الإجراء للإجراء). يمنحك ذلك فرصة تعديل المشغِّل أو الإجراء أو إزالته قبل حفظ عملية التشغيل الآلي نفسها.

عند الانتهاء من إضافة إجراءات التفعيل والإجراءات، يمكنك الرجوع إلى شاشة عملية التشغيل الآلي الجديدة والنقر على إنشاء عملية التشغيل الآلي (الشكل 8).

نموذج شاشة تطبيق لبدء عملية تشغيل آلي جديدة
الشكل 5: بدء إنشاء عملية تشغيل آلي جديدة
نموذج شاشة تطبيق لإضافة إجراء تفعيل لعملية تشغيل آلي
الشكل 6: إضافة عنصر بدء إلى عملية تشغيل آلي
نموذج شاشة تطبيق لإضافة إجراء لعملية تشغيل آلي
الشكل 7: إضافة إجراء إلى عملية التشغيل الآلي
نموذج لشاشة تطبيق لإنشاء عملية تشغيل آلي
الشكل 8: إنشاء عملية التشغيل الآلي

تحديد المشاكل وحلّها

يعرض التطبيق رسائل مربّعات الحوار لبعض الأحداث الشائعة التي قد تحدث. راجِع سجلّات adb للحصول على معلومات عن كيفية حلّ هذه الأحداث.

إذا واجهت مشاكل في استخدام نموذج التطبيق، اطّلِع على مقالة تحديد المشاكل وحلّها.