مخطّط سمات Openclose Smart Home
action.devices.traits.OpenClose
: تنتمي هذه السمة إلى الأجهزة التي تتيح الفتح والإغلاق، وفي بعض الحالات يتم فتحها أو إغلاقها جزئيًا أو من المحتمل أن تكون في أكثر من اتجاه واحد.
الجهاز ATTRIBUTES
ويمكن للأجهزة التي تتضمّن هذه السمة الإبلاغ عن السمات التالية كجزء من عملية SYNC
. لمزيد من المعلومات حول التعامل مع إجراءات SYNC
، يُرجى الاطّلاع على تنفيذ الإجراء.
السمات | النوع | الوصف |
---|---|---|
discreteOnlyOpenClose |
منطقي |
(القيمة التلقائية: وعند ضبطها على "صحيح"، يشير ذلك إلى أن الجهاز يجب أن يكون مفتوحًا بالكامل أو مغلقًا بالكامل (أي أنه لا يتيح قيمًا تتراوح بين 0% و100%). |
openDirection |
المصفوفة |
قائمة بالاتجاهات المتوافقة التي يمكن للجهاز من خلالها فتح أو إغلاق. يجب تضمين هذه السمة إذا كان الجهاز يتيح الفتح والإغلاق في أكثر من اتجاه واحد. |
[item, ...] |
سلسلة |
الاتجاه المعتمد. القيم المسموح بها:
|
commandOnlyOpenClose |
منطقي |
(القيمة التلقائية: تشير إلى ما إذا كان الجهاز يتيح استخدام اتصال أحادي الاتجاه (صحيح) أو ثنائي الاتجاه (خطأ). اضبط هذه السمة على "صحيح" إذا تعذّر على الجهاز الرد على طلب QUERY أو حالة التقرير لهذه السمة. |
queryOnlyOpenClose |
منطقي |
(القيمة التلقائية: يشير هذا الإعداد إلى ما إذا كان من الممكن طلب الجهاز للحصول على معلومات الحالة فقط ولا يمكن التحكّم فيه. يجب أن تضبط أجهزة الاستشعار التي يمكنها فقط الإبلاغ عن حالة الفتح هذا الحقل على "صحيح". |
أمثلة
جهاز بسيط ومفتوح.
{ "discreteOnlyOpenClose": true }
من أعلى لأسفل. ويمكن فتحه في أيّ من الاتجاهين.
{ "openDirection": [ "UP", "DOWN" ] }
الجهاز المخصّص للأوامر فقط:
{ "commandOnlyOpenClose": false }
حالة الجهاز STATES
قد تعرض الكيانات التي تضم هذه السمة الحالات التالية كجزء من عملية QUERY
. لمزيد من المعلومات حول التعامل مع إجراءات QUERY
، يُرجى الاطّلاع على تنفيذ الإجراء.
تحتوي الحمولة على واحد مما يلي:
اتجاه واحد مفتوح
الولايات | النوع | الوصف |
---|---|---|
openPercent |
Number |
مطلوبة. يشير إلى النسبة المئوية التي تم فتح الجهاز بها، حيث تم إغلاق 0 وفتح 100. |
إغلاق الاتجاه المتعدد
الولايات | النوع | الوصف |
---|---|---|
openState |
المصفوفة |
مطلوبة. قائمة بالحالات لكل اتجاه مفتوح متاح. |
[item, ...] |
العنصر |
الحالة الحالية للاتجاه المفتوح المحدد. |
openPercent |
Number |
مطلوبة. يشير إلى النسبة المئوية التي تم فتح الجهاز بها، حيث تم إغلاق 0 وفتح 100. |
openDirection |
سلسلة |
مطلوبة. الاتجاه الذي يتم فيه فتح الجهاز. القيم المسموح بها:
|
أمثلة
جهاز بسيط ومفتوح.
{ "openPercent": 100 }
افتح الجهاز بمقدار 30% في الاتجاه لأسفل، وبنسبة 50% في الاتجاه لأعلى.
{ "openState": [ { "openPercent": 30, "openDirection": "DOWN" }, { "openPercent": 50, "openDirection": "UP" } ] }
مفاتيح COMMAND
قد تستجيب الأجهزة التي تتضمّن هذه السمة للأوامر
التالية كجزء من عملية EXECUTE
. لمزيد من المعلومات حول التعامل مع إجراءات EXECUTE
، يُرجى الاطّلاع على تنفيذ الإجراء.
action.devices.commands.OpenClose
اضبط حالة إغلاق الجهاز.
المعلَمات
المعلَمات | النوع | الوصف |
---|---|---|
openPercent |
Number |
مطلوبة. يشير إلى النسبة المئوية التي تم فتح الجهاز بها، حيث تم إغلاق 0 وفتح 100. |
openDirection |
سلسلة |
الاتجاه المراد فتحه. لا تتوفّر هذه السمة إلا إذا كان الجهاز يتيح استخدام اتجاهات متعدّدة، كما هو موضّح في السمة القيم المسموح بها:
|
followUpToken |
سلسلة |
رمز مميز تقدمه Google للرد على المتابعة. |
أمثلة
افتح الجهاز.
{ "command": "action.devices.commands.OpenClose", "params": { "openPercent": 100, "followUpToken": "123" } }
افتح الجهاز للأسفل بنسبة 50%.
{ "command": "action.devices.commands.OpenClose", "params": { "openPercent": 50, "openDirection": "DOWN", "followUpToken": "456" } }
الأخطاء ذات الصلة
حدث خطأ أثناء تعيين حالة الإغلاق المفتوح للجهاز.
القيم المسموح بها:
lockedState
deviceJammingDetected
ردود المتابعة
قد تعرض الأجهزة التي تتضمّن هذه السمة حمولة الاستجابة التالية في إطار عملية EXECUTE
. لمزيد من المعلومات حول تنفيذ ردود المتابعة، يُرجى الاطّلاع على إشعارات الإجراءات المنزلية الذكية.
تحتوي الحمولة على واحد مما يلي:
تم الإجراء بنجاح
الحقول | النوع | الوصف |
---|---|---|
followUpToken |
سلسلة |
مطلوبة. تم تقديم الرمز المميز في طلب EXECUTE الأصلي. |
status |
سلسلة |
مطلوبة. نتيجة الطلب. القيم المسموح بها:
|
openPercent |
Number |
مطلوبة. يشير إلى النسبة المئوية التي تم فتح الجهاز بها حيث تم إغلاق 0 وفتح 100. |
تعذّر الإجراء
الحقول | النوع | الوصف |
---|---|---|
followUpToken |
سلسلة |
مطلوبة. تم تقديم الرمز المميز في طلب EXECUTE الأصلي. |
status |
سلسلة |
مطلوبة. نتيجة الطلب. القيم المسموح بها:
|
errorCode |
سلسلة |
مطلوبة. يمكن أن تكون القيمة أي رمز خطأ لهذه السمة، مثل |
أمثلة
افتح باب المرآب. (الردّ لمتابعة حالة النجاح)
{ "OpenClose": { "priority": 0, "followUpResponse": { "openPercent": 100, "status": "SUCCESS", "followUpToken": "1234" } } }
افتح باب المرآب. (استجابة لمتابعة حالة الفشل)
{ "OpenClose": { "priority": 0, "followUpResponse": { "errorCode": "lockedState", "status": "FAILURE", "followUpToken": "1234" } } }
action.devices.commands.OpenCloseRelative
اضبط حالة الإغلاق المفتوح للجهاز بالنسبة إلى الحالة الحالية. لا يتوفر هذا الأمر إلا في حال ضبط commandOnlyOpenClose
على false
.
{ "commandOnlyOpenClose": false }
المعلَمات
المعلَمات | النوع | الوصف |
---|---|---|
openRelativePercent |
Number |
مطلوبة. النسبة المئوية الدقيقة لتغيير حالة الإغلاق المفتوح. سيتم تحويل الأوامر النسبية الغامضة إلى معلمة النسبة المئوية الدقيقة (على سبيل المثال، "فتح الستائر أكثر قليلاً" في مقابل "فتح الستائر بنسبة 5%"). |
openDirection |
سلسلة |
الاتجاه المراد فتحه. لا تتوفّر هذه السمة إلا إذا كان الجهاز يتيح استخدام اتجاهات متعدّدة، كما هو موضّح في السمة القيم المسموح بها:
|
أمثلة
فتح الجهاز أكثر قليلاً
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": 5 } }
إغلاق الجهاز بنسبة% 10
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": -10 } }
افتح الجهاز بنسبة% 50 أكثر أو للأسفل.
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": 50, "openDirection": "DOWN" } }
الأخطاء ذات الصلة
حدث خطأ أثناء تعيين حالة الإغلاق المفتوح للجهاز.
القيم المسموح بها:
lockedState
deviceJammingDetected
نماذج من الألفاظ
de-DE
-
Bitte öffne
die Jalousien auf30% -
Fensterläden um25 % schliessen -
Ist
die Jalousie zu? -
Mach
den Rollladen zu -
Mach
die Rollos auf -
schließe
die Rollläden ein bisschen mehr -
Öffne
die Jalousien um25%
en-US
-
Are
the blinds in the kitchen open -
Close
the blinds 25% inmy room -
Close
the door more -
Just close
the front door -
open
the blinds in my room -
open
the blinds to25% -
open
the door by25%
es-ES
-
abre
la ventana del salón -
cerrar
persianas del dormitorio un20% -
cierra
la cortina del salón -
cierra
mucho másla ventana -
está abierta
la puerta -
quiero que subas
la persiana al25% -
sube un
20% las persianas
fr-FR
-
baisse
les stores de10% -
est-ce que
la porte d'entrée est ouverte -
ferme
les stores -
ferme
un peu les stores -
ouvre
les stores -
ouvre
les stores de la chambre de25% -
ouvre
les stores à25%
hi-IN
-
कृपया
25% पर्दे को खुला रखो -
क्या मैंने
सामने वाला दरवाजा खुला छोड दिया? -
पर्दे को25% बंद करोगे -
पर्दे खोलो -
ब्लाइंड 25% खुले पर सेट कर दीजिए -
ब्लाइंड कोथोड़ा और बंद कर दिजिए -
ब्लाइंड बंद करें
it-IT
-
abbassa
un po' di piùle tapparelle -
apri
la serranda -
apri
la tapparella al30% -
apri
le serrande del30% -
chiudi
le serrande -
chiudi
le tende del25% -
è aperta
la porta d'ingresso
ja-JP
-
25% にブラインド を開けて -
25% ブラインド を閉めてください -
25% ブラインド 開けて -
ブラインド 閉めて -
ブラインド 開けて -
少し ブラインド を閉じて -
玄関のドア は開いてますか
ko-KR
-
문 살짝만 닫아 줘 -
블라인드 25% 열어 줘 -
블라인드 25% 까지 열어 줘 -
블라인드 30프로 닫아 -
블라인드 닫아 줘 -
블라인드 열어 줘 -
안방 문 열렸어
nl-NL
-
doe
de gordijnen 25% open -
doe
de jaloezieën voor25% dicht -
doe
het raam ietsje meer dicht -
is
de voordeur open -
open
de gordijnen -
sluit
het gordijn -
zet
de luxaflex voor50% open
pt-BR
-
Abrir
janela 50% -
As cortinas estão abertas? -
Fecha
a persiana toda -
Fechar
a janela 10% -
a cortina do quarto está aberta? -
abra
a persiana até30% -
abre
as cortinas -
abre
as cortinas a50% -
abrir
as cortinas -
abrir
as cortinas na sala em30% -
fecha
a persiana por favor -
fecha
um bocado a janela -
fechar
as cortinas em25% -
fechar
um pouco maisas cortinas
sv-SE
-
Dra
upp persiennerna -
Dra
upp
persiennerna till25% -
stäng
persiennen i mitt rum 25% -
stäng
persiennerna -
är
ytterdörren öppen? -
öppna
persiennerna med25%