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

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

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

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

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

الجهاز ATTRIBUTES

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

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

حالة الجهاز STATES

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

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

مطلوبة.

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

<string> منطقي

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

أمثلة

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

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

مفاتيح COMMAND

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

action.devices.commands.SetToggles

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

المَعلمات

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

أخطاء الجهاز

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