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

تبديل المنزل المزوّد بأجهزة ذكية إلى مخطط السمات

action.devices.traits.Toggles: تنتمي هذه السمة إلى أيّ أجهزة تتضمّن إعدادات يمكن استخدامها في إحدى حالتَين فقط.

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

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

سمات الجهاز

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

السمات Type الوصف
availableToggles مصفوفة

مطلوب:

قائمة بمفاتيح التبديل المتاحة

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

زر التبديل متاح

name سلسلة

مطلوب:

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

name_values مصفوفة

مطلوب:

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

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

مرادفات زر التبديل بلغة معيّنة

name_synonym مصفوفة

مطلوب:

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

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

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

lang سلسلة

مطلوب:

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

commandOnlyToggles منطقي

(تلقائي: false)

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

queryOnlyToggles منطقي

(تلقائي: false)

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

أمثلة

الجهاز يتضمّن ميزة التبديل المتعدد

{
  "availableToggles": [
    {
      "name": "sterilization_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Clean",
            "Bio clean"
          ],
          "lang": "en"
        }
      ]
    },
    {
      "name": "energysaving_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Energy saving",
            "Eco"
          ],
          "lang": "en"
        }
      ]
    }
  ]
}

جهاز يتضمّن أزرار التحكّم بالأوامر فقط

{
  "availableToggles": [
    {
      "name": "filter_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Filtered",
            "Filter"
          ],
          "lang": "en"
        }
      ]
    }
  ],
  "commandOnlyToggles": true
}

الجهاز المزوّد بإمكانية إيقاف/تفعيل طلب البحث فقط:

{
  "availableToggles": [
    {
      "name": "filter_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Filtered",
            "Filter"
          ],
          "lang": "en"
        }
      ]
    }
  ],
  "queryOnlyToggles": true
}

حالات الجهاز

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

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

مطلوب:

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

<string> منطقي

حالة التبديل الحالية

أمثلة

هل التعقيم مفعّل؟

{
  "currentToggleSettings": {
    "sterilization_toggle": true,
    "energysaving_toggle": false
  }
}

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

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

action.devices.commands.SetToggles

ضبط حالة تبديل معيّنة.

المعلّمات

المعلّمات Type الوصف
updateToggleSettings العنصر

مطلوب:

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

<string> منطقي

حالة تبديل جديدة

أمثلة

تفعيل ميزة "توفير الطاقة"

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "energysaving_toggle": true
    }
  }
}

أوقِف الفلتر.

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "filter_toggle": false
    }
  }
}

نماذج من الكلمات

de-DE

  • Bitte schalte Power Cool am Kühlschrank aus
  • stelle den Kühlschrank auf Power Cool

en-US

  • activate power freeze for the freezer
  • cancel power cool for the kitchen fridge

es-ES

  • pon el enfriamiento rápido en la nevera
  • quita el enfriamiento rápido

fr-FR

  • mets le mode power cool sur le réfrigérateur
  • Éteins le mode power freeze du réfrigérateur .

hi-IN

  • रेफ़्रिजरेटर का पावर कूल मोड बंद कर दो
  • रेफ़्रिजरेटर में पावर कूल मोड चालू करो

it-IT

  • disattiva il power freeze del freezer
  • imposta la funzione power freeze del surgelatore

ja-JP

  • 冷蔵庫 急速冷凍 つけて
  • 冷蔵庫 急速冷凍 を切ってくれる

ko-KR

  • 냉장고 급속 냉장 해제해
  • 냉장고 모드 급속 냉장 으로 바꿔

nl-NL

  • Zet de power cool uit op de koelkast
  • zet de koelkast op superkoelen

pt-BR

  • Ativa a função power freeze no congelador .
  • Desativa o bloqueio infantil do forno .
  • desligar o power cool da geladeira
  • iniciar o modo power freeze do freezer

sv-SE

  • Stäng av power cool i kylskåpet
  • sätt på power freeze frysen

أخطاء الجهاز

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