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

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

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

سمات الجهاز

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

السمات	النوع	الوصف
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 intents، اطّلِع على تلبية النية.

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

أمثلة

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

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

أوامر الجهاز

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

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