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

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

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

ATTRIBUTES للجهاز

يمكن أن تُبلغ الأجهزة التي تتضمّن هذه السمة عن ما يلي: كجزء من عملية 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
}

CommandS للجهاز

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