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

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

action.devices.traits.Modes - تشمل هذه السمة كل الأوضاع المتاحة والإعدادات الخاصة بجهاز معيّن.

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

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

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

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

سمات الجهاز

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

السمات Type الوصف
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
}

حالات الجهاز

قد تُبلِغ الكيانات التي تحمل هذه السمة عن الحالات التالية كجزء من عملية QUERY. للاطّلاع على مزيد من المعلومات حول التعامل مع عناصر intent في QUERY، يُرجى الاطّلاع على تنفيذ النية بالشراء.

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

مطلوب:

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

<string> سلسلة

setting_name حاليًا

أمثلة

ما هو الوضع الذي يعمل به الجهاز؟

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

حوالات الجهاز

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

action.devices.commands.SetModes

تعديل إعدادات الوضع

المعلّمات

المعلّمات Type الوصف
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

أخطاء الجهاز

راجِع القائمة الكاملة للأخطاء والاستثناءات.