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

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 medel

أخطاء الجهاز

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