مخطّط سمة سرعة المروحة في المنزل الذكي

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

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

سمات الجهاز

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

السمات النوع الوصف
reversible صحيح/خطأ

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

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

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

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

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

يجب ملء هذا الحقل.

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

يجب ملء هذا الحقل.

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

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

مطلوبة

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

يجب ملء هذا الحقل.

المرادفات لإعداد السرعة بكل لغة من اللغات المتوافقة
[item, ...] العنصر

مرادف لإعداد السرعة بلغة معيّنة.
speed_synonym مصفوفة

مطلوبة

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

مرادف.
lang String

مطلوبة

رمز اللغة (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
}

حالات الجهاز

يمكن أن تُبلغ الكيانات التي تتضمّن هذه السمة عن الحالات التالية كجزء من عملية 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: سبق أن تم ضبط الجهاز على الحد الأدنى للسرعة.