مخطط سمة FanSpeed في الأجهزة الذكية

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

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

سمات الجهاز

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

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

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

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

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

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

إتاحة إعدادات السرعة
availableFanSpeeds Object

مطلوبة

إعدادات السرعة التي يتيحها الجهاز
speeds Array

مطلوبة

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

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

مطلوبة

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

مطلوبة

مرادفات إعداد السرعة بكل اللغات المتاحة
[item, ...] Object

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

مطلوبة

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

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

مطلوبة

رمز اللغة (ISO 639-1) الاطّلاع على اللغات المتاحة.
ordered Boolean

مطلوبة

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

إتاحة النسبة المئوية للسرعة
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

يجب أن تكون القيمة بين 0 و100.

أمثلة

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

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

أوامر الجهاز

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

action.devices.commands.SetFanSpeed

ضبط السرعة

المعلمات

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

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

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

مطلوبة

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

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

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

مطلوبة

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

يجب أن تكون القيمة بين 0 و100.

أمثلة

اضبط المروحة على السرعة القصوى.

{
  "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 Integer

مطلوبة

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

يجب أن تكون القيمة بين -5 و5.

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

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

مطلوبة

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

يجب أن تكون القيمة بين -100 و100.

أمثلة

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

{
  "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: تم ضبط الجهاز على السرعة الأدنى.