مخطط سمة سرعة المراوح في المنزل المزوّد بأجهزة ذكية
action.devices.traits.FanSpeed
: تنتمي هذه السمة إلى الأجهزة التي تتيح ضبط سرعة المروحة.
سمات الجهاز
قد تُبلغ الأجهزة التي تتضمّن هذه السمة عن السمات التالية كجزء من عملية SYNC
. لمزيد من المعلومات عن التعامل مع أغراض SYNC
، يُرجى الاطّلاع على تنفيذ النية.
السمات | Type | الوصف |
---|---|---|
reversible |
منطقية |
(القيمة التلقائية: وفي حال ضبطها على "صحيح"، يتيح هذا الجهاز تشغيل المروحة في كلا الاتجاهين ويمكنه قبول أمر عكس اتجاه المروحة. |
commandOnlyFanSpeed |
منطقية |
(القيمة التلقائية: يشير إلى ما إذا كان الجهاز يتيح استخدام الاتصال أحادي الاتجاه (صحيح) أو اتصال ثنائي الاتجاه (خطأ). اضبُط هذه السمة على "صحيح" إذا لم يتمكن الجهاز من الاستجابة للغرض من QUERY أو "حالة التقرير" لهذه السمة. |
يحتوي على أي من العناصر التالية: | ||
0
|
كائن |
إتاحة إعدادات السرعة |
availableFanSpeeds |
كائن |
يجب ملء هذا الحقل. إعدادات السرعة التي يوفّرها الجهاز |
speeds |
صفيف |
يجب ملء هذا الحقل. قائمة إعدادات السرعة |
[item, ...] |
كائن |
إعداد السرعة |
speed_name |
String |
يجب ملء هذا الحقل. الاسم الداخلي لإعداد السرعة. قد يكون هذا المحتوى غير سهل الاستخدام، وستتم مشاركته على جميع اللغات. |
speed_values |
صفيف |
يجب ملء هذا الحقل. مرادفات لإعدادات السرعة في كل لغة متاحة. |
[item, ...] |
كائن |
مرادف لإعدادات السرعة بلغة معيّنة. |
speed_synonym |
صفيف |
يجب ملء هذا الحقل. يجب أن تتضمّن مرادفات إعداد السرعة صيغتَي المفرد والجمع، إذا كان ذلك منطبقًا. سيكون المرادف الأول في القائمة هو الاسم المتعارف عليه لإعداد السرعة. |
[item, ...] |
String |
المرادفات |
lang |
String |
يجب ملء هذا الحقل. رمز اللغة (ISO 639-1). اطّلِع على اللغات المتاحة. |
ordered |
منطقية |
يجب ملء هذا الحقل. في حال ضبطها على "صحيح"، سيتم تطبيق قواعد نحوية إضافية لمنطق الزيادة أو الانخفاض، بترتيب (رفع) مصفوفة السرعات. |
1
|
كائن |
دعم النسبة المئوية للسرعة. |
supportsFanSpeedPercent |
منطقية |
يجب ملء هذا الحقل. (القيمة التلقائية: وفي حال ضبطها على "صحيح"، سيقبل هذا الجهاز أوامر ضبط السرعة باستخدام نسبة مئوية من 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 |
يمثّل هذا الاسم الاسم الداخلي لإعداد السرعة الحالي من السمة |
currentFanSpeedPercent |
Number |
يشير إلى سرعة المروحة الحالية بالنسبة المئوية. مطلوبة في حال ضبط السمة |
أمثلة
ما هي سرعة المراوح في غرفة المعيشة؟
{ "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
: سبق ضبط الجهاز على الحد الأدنى للسرعة.