مخطط سمة سرعة المراوح في المنزل المزوّد بأجهزة ذكية

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

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

سمات الجهاز

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

السمات	Type	الوصف
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، يُرجى الاطّلاع على تنفيذ النية.

الولايات	Type	الوصف
currentFanSpeedSetting	String	يمثّل هذا الاسم الاسم الداخلي لإعداد السرعة الحالي من السمة availableFanSpeeds.
currentFanSpeedPercent	Number	يشير إلى سرعة المروحة الحالية بالنسبة المئوية. مطلوبة في حال ضبط السمة supportsFanSpeedPercent على true

أمثلة

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

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

مفاتيح الجهاز

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

action.devices.commands.SetFanSpeed

ضبط السرعة

المَعلمات

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

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

المَعلمات	Type	الوصف
fanSpeed	String	يجب ملء هذا الحقل. إعدادات السرعة المطلوبة للمروحة.

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

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

المَعلمات

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

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

المَعلمات	Type	الوصف
fanSpeedRelativeWeight	عدد صحيح	يجب ملء هذا الحقل. تشير هذه القيمة إلى المقدار النسبي لتغيير السرعة. تشير القيمة المطلقة إلى المبلغ الذي تم قياسه بينما تشير العلامة الرقمية إلى اتجاه التغيير.

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

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

المَعلمات

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

أمثلة

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

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