مرحبًا بك في "مركز مطوّري برامج Google Home"، وجهتك الجديدة لتعلّم كيفية تطوير إجراءات منزلية ذكية. ملاحظة: ستواصل إنشاء الإجراءات في وحدة تحكم الإجراءات.
تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

مخطط سمات دورة المنزل الذكية

action.devices.traits.RunCycle: تمثّل هذه السمة أي جهاز يتضمّن مدة تشغيل متواصلة ويمكن طلبه.

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

  • ما هي دورة تشغيل النشّافة؟
  • كم عدد الدورات المتبقية في غسّالة الأطباق؟
  • ما هي ميزات النشّافة؟
  • متى سيتم الغسيل؟

تتضمن أجهزة معيّنة مدة بتنسيق غير دوري. ويمكن لأي جهاز يتم تشغيله لمدة زمنية محددة الإبلاغ عن الوقت المتبقي، بدون دورات. يعالج هذا الإجراء أيضًا الحالات التي لا تكون فيها الدورات ثابتة (على سبيل المثال، قد لا تستخدم غسالات الأطباق دائمًا جميع الدورات). على سبيل المثال، قد يسأل المستخدِم: كم من الوقت سيستمر تشغيل المكنسة الكهربائية؟ ما سيؤدي إلى عرض مقدار الوقت بالوحدات بالتناسب مع الوقت المتبقي. وينطبق ذلك أيضًا على الأجهزة المذكورة أعلاه، ما هي المدة التي ستبقى فيها ملابسي جافة؟ ستعرض المدة بالدقائق.

يمكن أن تعرض الأجهزة ما تعرفه، وستشكّل استجابة "تحويل النص إلى كلام" في "مساعد Google" أفضل إجابة باستخدام البيانات المتاحة (على سبيل المثال، تشغيل غسّالة الأطباق وستنتهي في غضون 20 دقيقة تقريبًا.)

إن RunCycle هي سمة للقراءة فقط حاليًا - وليست لها أوامر، بل تنص فقط على طلب البحث. في المستقبل، قد تكون هناك آليات لإعادة تشغيل الدورات أو تخطّي الدورات (وهذا مفيد للرشاشات، والغسالات للغسالات).

الجهاز ATTRIBUTES

بلا عري

حالة الجهاز STATES

ويمكن للأجهزة التي تتضمّن هذه السمة الإبلاغ عن الحالات التالية كجزء من عملية QUERY. لمزيد من المعلومات حول التعامل مع إجراءات QUERY، يُرجى الاطّلاع على تنفيذ الإجراء.

الولايات النوع الوصف
currentRunCycle المصفوفة

مطلوبة.

يحتوي على مرادفات للدورة الحالية في كل لغة مدعومة.

[item, ...] العنصر

أسماء مرادفات الدورة

currentCycle سلسلة

مطلوبة.

جارٍ تنفيذ الدورة الحالية.

nextCycle سلسلة

اختياريّ. دورة التشغيل التالية.

lang سلسلة

مطلوبة.

رمز اللغة لأسماء الدورات المحددة. راجع اللغات المعتمدة.

currentTotalRemainingTime عدد صحيح

مطلوبة.

الوقت المتبقي متبقٍ للتشغيل، بالثواني.

currentCycleRemainingTime عدد صحيح

مطلوبة.

الوقت المتبقي في الدورة الحالية، بالثواني.

أمثلة

يجب أن يتم شطف الجهاز لمدة 5 دقائق أخرى، وسيتم الانتهاء منه في غضون 20 دقيقة.

{
  "currentRunCycle": [
    {
      "currentCycle": "rinse",
      "lang": "en"
    }
  ],
  "currentTotalRemainingTime": 1200,
  "currentCycleRemainingTime": 300
}

يُرجى شطف الجهاز لمدة 5 دقائق أخرى قبل تحريك الجهاز للدوران.

{
  "currentRunCycle": [
    {
      "currentCycle": "rinse",
      "nextCycle": "spin",
      "lang": "en"
    }
  ],
  "currentTotalRemainingTime": 600,
  "currentCycleRemainingTime": 300
}

مفاتيح COMMAND

بلا عري

إشعارات الجهاز

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

الحقول النوع الوصف
RunCycle

مطلوبة.

البيانات الأساسية للإشعارات

يتيح أحد الخيارات التالية:
0 العنصر

تم الإجراء بنجاح

priority عدد صحيح

مطلوبة.

يمثل مستوى الإشعار. القيمة المسموح بها حاليًا هي 0، مما يعني أنه يجب قول الإشعار بصوت عالٍ.

status سلسلة

مطلوبة.

نتيجة العملية.

القيم المسموح بها:

SUCCESS
currentCycleRemainingTime عدد صحيح

مطلوبة.

الوقت المتبقي في الدورة الحالية، بالثواني.

1 العنصر

تعذّر الإجراء

priority عدد صحيح

مطلوبة.

يمثل مستوى الإشعار. القيمة المسموح بها حاليًا هي 0، مما يعني أنه يجب قول الإشعار بصوت عالٍ.

status سلسلة

مطلوبة.

نتيجة العملية.

القيم المسموح بها:

FAILURE
errorCode سلسلة

مطلوبة.

يمكن أن تكون القيمة أي رمز خطأ لهذه السمة، مثل deviceStuck.

أمثلة

انتهى تشغيل الجهاز.

{
  "RunCycle": {
    "priority": 0,
    "status": "SUCCESS",
    "currentCycleRemainingTime": 0
  }
}

حدث خطأ أثناء إكمال الدورة الحالية.

{
  "RunCycle": {
    "priority": 0,
    "status": "FAILURE",
    "errorCode": "deviceStuck"
  }
}

أخطاء الجهاز

يمكنك الاطلاع على القائمة الكاملة للأخطاء والاستثناءات.