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

مخطط سمات أوضاع المنزل الذكية

action.devices.traits.Modes: تغطي هذه السمة جميع الأوضاع المتاحة والإعدادات الخاصة بالوضع في الجهاز.

تنتمي هذه السمة إلى أي أجهزة ذات عدد عشوائي من أوضاع "n-way" التي تكون فيها الأوضاع والإعدادات لكل وضع عشوائية ومميّزة لكل جهاز أو نوع جهاز. يحتوي كل وضع على إعدادات متعددة محتملة، ولكن يمكن اختيار إعداد واحد فقط في كل مرة، ولا يمكن استخدام النشّافة في الوضع "الناعم" و"العادي" و"المجهود الثقيل" في آنٍ واحد. أحد الإعدادات التي يمكن تفعيلها أو إيقافها ببساطة ينتمي إلى سمة Toggles.

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

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

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

الجهاز ATTRIBUTES

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

السمات النوع الوصف
availableModes المصفوفة

مطلوبة.

قائمة بالأوضاع المتاحة.

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

الوضع المتاح.

name سلسلة

مطلوبة.

الاسم الداخلي للوضع الذي سيتم استخدامه في الأوامر والحالات. يمكن أن يكون هذا غير سهل الاستخدام، وستتم مشاركته عبر جميع اللغات.

name_values المصفوفة

مطلوبة.

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

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

مرادفات الوضع بلغة معينة.

name_synonym المصفوفة

مطلوبة.

مرادفات الوضع. ويتم استخدام السلسلة الأولى في هذه القائمة كاسم أساسي للمستوى بهذه اللغة.

[item, ...] سلسلة

اسم المرادفات.

lang سلسلة

مطلوبة.

رمز اللغة (ISO 639-1). راجع اللغات المعتمدة.

settings المصفوفة

مطلوبة.

الإعدادات المتوافقة لهذا الوضع.

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

الإعداد المتوافق.

يتطلب عنصرين على الأقل.

setting_name سلسلة

مطلوبة.

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

setting_values المصفوفة

مطلوبة.

مرادفات الإعدادات بكل اللغات المعتمدة.

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

مرادفات الإعداد بلغة معينة.

setting_synonym المصفوفة

مطلوبة.

مرادفات الإعداد. ويتم استخدام السلسلة الأولى في هذه القائمة كاسم أساسي للمستوى بهذه اللغة.

[item, ...] سلسلة

اسم المرادفات.

lang سلسلة

مطلوبة.

رمز اللغة (ISO 639-1). راجع اللغات المعتمدة.

ordered منطقي

(القيمة التلقائية: false)

إذا تم ضبط هذه السياسة على "صحيح"، سيتم تطبيق قواعد إضافية لزيادة المنطق/تقليله، بالترتيب (يزيد) لمصفوفة الإعدادات.

commandOnlyModes منطقي

(القيمة التلقائية: false)

تشير إلى ما إذا كان الجهاز يتيح استخدام اتصال أحادي الاتجاه (صحيح) أو ثنائي الاتجاه (خطأ). اضبط هذه السمة على "صحيح" إذا تعذّر على الجهاز الرد على طلب QUERY أو حالة التقرير لهذه السمة.

queryOnlyModes منطقي

(القيمة التلقائية: false)

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

أمثلة

الجهاز ذو الإعدادات والإعدادات المتعددة:

{
  "availableModes": [
    {
      "name": "load_mode",
      "name_values": [
        {
          "name_synonym": [
            "load",
            "size",
            "load size"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "small_load",
          "setting_values": [
            {
              "setting_synonym": [
                "small",
                "half"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "medium_load",
          "setting_values": [
            {
              "setting_synonym": [
                "medium",
                "normal"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "large_load",
          "setting_values": [
            {
              "setting_synonym": [
                "large",
                "full"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": true
    },
    {
      "name": "temp_mode",
      "name_values": [
        {
          "name_synonym": [
            "temperature",
            "temp"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "hot_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "hot",
                "white"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "warm_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "warm",
                "color"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "cold_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "cold",
                "delicate"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ]
}

الجهاز يتضمن أوضاع الأوامر فقط.

{
  "availableModes": [
    {
      "name": "light_mode",
      "name_values": [
        {
          "name_synonym": [
            "light",
            "lighting"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "day_light",
          "setting_values": [
            {
              "setting_synonym": [
                "day",
                "bright"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "night_light",
          "setting_values": [
            {
              "setting_synonym": [
                "night",
                "dark"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "reading_light",
          "setting_values": [
            {
              "setting_synonym": [
                "reading",
                "ambiant"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ],
  "commandOnlyModes": true,
  "queryOnlyModes": false
}

حالة الجهاز STATES

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

الولايات النوع الوصف
currentModeSettings العنصر

مطلوبة.

زوج المفتاح/القيمة مع وضع name للجهاز كمفتاح، وsetting_name الحالي كقيمة.

<string> سلسلة

setting_name حاليًا

أمثلة

ما هو وضع الجهاز؟

{
  "currentModeSettings": {
    "load_mode": "small_load",
    "temp_mode": "cold_temp"
  }
}

مفاتيح COMMAND

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

action.devices.commands.SetModes

تحديث إعدادات الوضع.

المَعلمات

المَعلمات النوع الوصف
updateModeSettings العنصر

مطلوبة.

إقران المفتاح/القيمة مع الوضع name للجهاز كمفتاح، وsetting_name الجديد كقيمة.

<string> سلسلة

setting_name جديد.

أمثلة

ضبط الفيديو على حِمل كبير

{
  "command": "action.devices.commands.SetModes",
  "params": {
    "updateModeSettings": {
      "load_mode": "large_load"
    }
  }
}

نماذج من الألفاظ

de-DE

  • Stelle den Staubsauger auf Ruhemodus

en-US

  • set the vacuum to energy saver mode

es-ES

  • pon la lavadora en modo frío

fr-FR

  • mets l'aspirateur en silencieux

hi-IN

  • वैक्यूम पर कार्पेट मोड लगाएं

it-IT

  • imposta l'aspirapolvere su silenzioso

ja-JP

  • 掃除機 静音 モードに設定して

ko-KR

  • 세탁기 세탁량 많음 으로 설정해

pt-BR

  • acionar a função autolimpeza do aspirador
  • ligar o modo de aquecimento

أخطاء الجهاز

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