استخدام تطبيق Android التجريبي

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

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

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

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

الإجراءات على الأجهزة والعمليات المبرمَجة الحالية

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

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

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

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

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

علامة التبويب "العمليات المبرمَجة"

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

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

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

علامة التبويب "العمليات المبرمَجة" في تطبيق Home APIs Sample App
الشكل 3: عرض علامة التبويب "العمليات المبرمَجة"
طريقة العرض التفصيلية لعملية مبرمَجة محدّدة
الشكل 4: عرض تفصيلي لإحدى العمليات المبرمَجة

إنشاء عملية مبرمَجة

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

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

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

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

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

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

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