مخطط سمة Smart Home FanSpeed

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

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

سمات الجهاز

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

السمات النوع الوصف
reversible Boolean

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

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

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

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

إتاحة إعدادات السرعة
availableFanSpeeds الكائن

مطلوبة

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

مطلوبة

قائمة إعدادات السرعة
[item, ...] الكائن

إعداد السرعة
speed_name String

مطلوبة

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

مطلوبة

مرادفات لإعداد السرعة في كل اللغات المتاحة
[item, ...] الكائن

مرادف لإعداد السرعة بلغة معيّنة يجب توفير عنصر واحد على الأقل بقيمة lang تساوي en من أجل توفير لغة احتياطية.
speed_synonym المصفوفة

مطلوبة

مرادفات لإعداد السرعة، ويجب أن تتضمّن صيغتَي المفرد والجمع، إذا كان ذلك منطبقًا. سيتم اعتبار المرادف الأول في القائمة هو الاسم الأساسي لإعداد السرعة.
[item, ...] String

مرادف يجب توفير عنصر واحد على الأقل بقيمة lang تساوي en من أجل توفير لغة احتياطية.
lang String

مطلوبة

رمز اللغة (ISO 639-1) اللغات المتاحة
ordered Boolean

مطلوبة

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

إتاحة نسبة السرعة
supportsFanSpeedPercent Boolean

مطلوبة

(القيمة التلقائية: 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
}

حالات الجهاز

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

الولايات النوع الوصف
currentFanSpeedSetting String

يمثّل هذا الاسم الداخلي لإعداد السرعة الحالي من السمة availableFanSpeeds.
currentFanSpeedPercent Number

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

أمثلة

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

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

أوامر الجهاز

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

action.devices.commands.SetFanSpeed

ضبط السرعة

المعلمات

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

ضبط السرعة من خلال الإعدادات

المعلمات النوع الوصف
fanSpeed String

مطلوبة

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

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

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

  • drop the AC fan speed to medium

es-ES

  • cambia la velocidad del ventilador a medio

fr-FR

  • mets la ventilation au maximum

hi-IN

  • बेडरूम में पंखे की गति मीडियम करें

it-IT

  • metti il condizionatore in salotto a velocità media

ja-JP

  • エアコン の風量を 高速 にセット

ko-KR

  • 선풍기 강풍 으로 틀어 줘

nl-NL

  • zet de snelheid van de ventilator op medium

pt-BR

  • definir a velocidade do ventilador para baixa
  • põe a ventoinha no máximo

sv-SE

  • Ställ in fläkten på medel

أخطاء الجهاز

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