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

مخطط سمة سرعة الصفحة الرئيسية الذكية

action.devices.traits.FanSpeed: تنطبق هذه السمة على الأجهزة التي تتيح ضبط سرعة المروحة.

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

الجهاز ATTRIBUTES

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

السمات النوع الوصف
reversible منطقي

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

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

commandOnlyFanSpeed منطقي

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

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

يحتوي على أي من العناصر التالية:
0 العنصر

دعم إعدادات السرعة.

availableFanSpeeds العنصر

مطلوبة.

إعدادات السرعة المتوافقة مع الجهاز.

speeds المصفوفة

مطلوبة.

قائمة إعدادات السرعة.

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

إعداد السرعة.

speed_name سلسلة

مطلوبة.

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

speed_values المصفوفة

مطلوبة.

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

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

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

speed_synonym المصفوفة

مطلوبة.

يجب أن تتضمن مرادفات إعداد السرعة كلاً من صيغ المفرد والجمع، إن أمكن. وسيتم اعتبار أول مرادف في القائمة الاسم المتعارف عليه لإعداد السرعة.

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

مرادف

lang سلسلة

مطلوبة.

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

ordered منطقي

مطلوبة.

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

1 العنصر

دعم النسبة المئوية للسرعة.

supportsFanSpeedPercent منطقي

مطلوبة.

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

في حال ضبط هذه السياسة على "صحيح"، سيقبل هذا الجهاز طلبات ضبط السرعة باستخدام نسبة مئوية تتراوح بين 0.0 و100.0.

أمثلة

جهاز مزوّد بإعدادات السرعة: الاتجاه العكسي وتعديل النسبة المئوية.

{
  "availableFanSpeeds": {
    "speeds": [
      {
        "speed_name": "speed_low",
        "speed_values": [
          {
            "speed_synonym": [
              "low",
              "slow"
            ],
            "lang": "en"
          }
        ]
      },
      {
        "speed_name": "speed_high",
        "speed_values": [
          {
            "speed_synonym": [
              "high",
              "fast"
            ],
            "lang": "en"
          }
        ]
      }
    ],
    "ordered": true
  },
  "reversible": true,
  "supportsFanSpeedPercent": true
}

حالة الجهاز STATES

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

الولايات النوع الوصف
currentFanSpeedSetting سلسلة

يمثل ذلك الاسم الداخلي لإعداد السرعة الحالي من السمة availableFanSpeeds.

currentFanSpeedPercent Number

يشير إلى سرعة المروحة الحالية بالنسبة المئوية. مطلوبة إذا تم ضبط سمة supportsFanSpeedPercent على true

أمثلة

ما هي سرعة المروحة في غرفة المعيشة؟

{
  "currentFanSpeedSetting": "speed_low",
  "currentFanSpeedPercent": 10
}

مفاتيح COMMAND

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

action.devices.commands.SetFanSpeed

تعيين السرعة.

المَعلمات

تحتوي الحمولة على واحد مما يلي:

تعيين السرعة من خلال الإعدادات.

المَعلمات النوع الوصف
fanSpeed سلسلة

مطلوبة.

إعدادات السرعة المطلوبة في المروحة.

اضبط السرعة حسب النسبة المئوية.

المَعلمات النوع الوصف
fanSpeedPercent Number

مطلوبة.

النسبة المئوية لإعداد السرعة المطلوبة.

أمثلة

اضبط المروحة على درجة عالية.

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeed": "speed_high"
  }
}

ضبط المروحة على 50%

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeedPercent": 50
  }
}

action.devices.commands.SetFanSpeedRelative

تعيين السرعة النسبية.

يتطلب هذا الأمر السمات التالية:
{
  "commandOnlyFanSpeed": true
}

المَعلمات

تحتوي الحمولة على واحد مما يلي:

تعيين السرعة النسبية حسب الوزن.

المَعلمات النوع الوصف
fanSpeedRelativeWeight عدد صحيح

مطلوبة.

تشير هذه القيمة إلى المقدار النسبي لتغيير السرعة. تشير القيمة المطلقة إلى المبلغ المتدرج بينما تشير العلامة الرقمية إلى اتجاه التغيير.

تعيين السرعة النسبية حسب النسبة المئوية.

المَعلمات النوع الوصف
fanSpeedRelativePercent Number

مطلوبة.

وتمثل هذه القيمة النسبة المئوية للتغيير في السرعة.

أمثلة

اخفض سرعة المروحة قليلاً.

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativeWeight": -1
  }
}

ارفع سرعة المروحة بنسبة 10%.

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativePercent": 10
  }
}

action.devices.commands.Reverse

عكس اتجاه المروحة.

يتطلب هذا الأمر السمات التالية:
{
  "reversible": true
}

المَعلمات

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

ما من مواقع

أمثلة

اعكس اتجاه المروحة.

{
  "command": "action.devices.commands.Reverse",
  "params": {}
}

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

de-DE

  • stell die Geschwindigkeit vom Ventilator auf hoch

en-US

  • إسقاط مكيّف الهواء سرعة المروحة إلى الوسيط

es-ES

  • cambia la velocidad del ventilador أ ميديو

fr-FR

  • ميتس لا تهوية au الحد الأقصى

أخطاء الجهاز

يمكنك الاطلاع على القائمة الكاملة للأخطاء والاستثناءات.
  • maxSpeedReached: سبق ضبط الجهاز على أقصى سرعة.
  • minSpeedReached: سبق ضبط الجهاز على الحد الأدنى للسرعة.