طرحواره صفت باز بستن خانه هوشمند

action.devices.traits.OpenClose - این ویژگی متعلق به دستگاه هایی است که از باز و بسته شدن و در برخی موارد باز و بسته شدن جزئی یا بالقوه در بیش از یک جهت پشتیبانی می کنند.

ویژگی های دستگاه

دستگاه های دارای این ویژگی ممکن است ویژگی های زیر را به عنوان بخشی از عملیات SYNC گزارش کنند. برای کسب اطلاعات بیشتر در مورد مدیریت مقاصد SYNC ، به تحقق هدف مراجعه کنید.

ویژگی های	تایپ کنید	شرح
discreteOnlyOpenClose	بولی	(پیش‌فرض: false ) هنگامی که روی true تنظیم می شود، نشان می دهد که دستگاه باید کاملاً باز یا کاملاً بسته باشد (یعنی مقادیر بین 0٪ و 100٪ را پشتیبانی نمی کند).
openDirection	آرایه	فهرست جهت‌های پشتیبانی‌شده که در آن دستگاه می‌تواند باز یا بسته شود. اگر دستگاه از باز و بسته شدن در بیش از یک جهت پشتیبانی می کند، این ویژگی را وارد کنید.
[ item, ... ]	رشته	جهت پشتیبانی شده مقادیر پشتیبانی شده: UP DOWN LEFT RIGHT IN OUT
commandOnlyOpenClose	بولی	(پیش‌فرض: false ) نشان می دهد که آیا دستگاه از ارتباط یک طرفه (درست) یا دو طرفه (کاذب) پشتیبانی می کند. اگر دستگاه نمی تواند به یک هدف QUERY یا وضعیت گزارش برای این ویژگی پاسخ دهد، این ویژگی را روی true تنظیم کنید.
queryOnlyOpenClose	بولی	(پیش‌فرض: false ) نشان می دهد که آیا دستگاه فقط برای اطلاعات وضعیت قابل جستجو است و نمی توان آن را کنترل کرد. حسگرهایی که فقط می توانند وضعیت باز را گزارش کنند باید این فیلد را روی true تنظیم کنند.

مثال ها

دستگاه باز و بسته ساده

{
  "discreteOnlyOpenClose": true
}

دستگاه از بالا به پایین از پایین به بالا. قابل باز شدن در هر جهت

{
  "openDirection": [
    "UP",
    "DOWN"
  ]
}

دستگاه فقط فرمان

{
  "commandOnlyOpenClose": false
}

وضعیت دستگاه

موجودیت های دارای این ویژگی ممکن است وضعیت های زیر را به عنوان بخشی از عملیات QUERY گزارش کنند. برای کسب اطلاعات بیشتر در مورد مدیریت مقاصد QUERY ، به تحقق هدف مراجعه کنید.

محموله شامل یکی از موارد زیر است:

یک جهت باز-بستن

ایالت ها	تایپ کنید	شرح
openPercent	عدد	ضروری. درصد باز شدن یک دستگاه را نشان می دهد که 0 بسته و 100 کاملاً باز است.
targetOpenPercent	عدد	سطح نشان دهنده درصد باز بودن جایی است که دستگاه در نتیجه تغییر مداوم موقعیت به کجا می رود یا در حال حرکت است.

چند جهت باز-بستن

ایالت ها	تایپ کنید	شرح
openState	آرایه	ضروری. فهرست ایالت ها برای هر جهت باز پشتیبانی شده.
[ item, ... ]	هدف - شی	وضعیت فعلی برای جهت باز داده شده.
openPercent	عدد	ضروری. درصد باز شدن یک دستگاه را نشان می دهد که 0 بسته و 100 کاملاً باز است.
targetOpenPercent	عدد	سطح نشان دهنده درصد باز بودن جایی است که دستگاه در نتیجه تغییر مداوم موقعیت به کجا می رود یا در حال حرکت است.
openDirection	رشته	ضروری. جهتی که دستگاه در آن باز می شود. مقادیر پشتیبانی شده: UP DOWN LEFT RIGHT IN OUT

مثال ها

دستگاه باز و بسته ساده

{
  "openPercent": 100
}

دستگاه باز و بسته ساده در حال حاضر به موقعیت جدیدی باز می شود.

{
  "openPercent": 50,
  "targetOpenPercent": 100
}

دستگاه را 30 درصد در جهت پایین و 50 درصد در جهت بالا باز کنید.

{
  "openState": [
    {
      "openPercent": 30,
      "openDirection": "DOWN"
    },
    {
      "openPercent": 50,
      "openDirection": "UP"
    }
  ]
}

دستگاه را 30 درصد در جهت پایین و 50 درصد در جهت بالا باز کنید، در حال حاضر به سمت 80 درصد در جهت بالا حرکت می کند.

{
  "openState": [
    {
      "openPercent": 30,
      "openDirection": "DOWN"
    },
    {
      "openPercent": 50,
      "targetOpenPercent": 80,
      "openDirection": "UP"
    }
  ]
}

دستورات دستگاه

دستگاه های دارای این ویژگی ممکن است به دستورات زیر به عنوان بخشی از عملیات EXECUTE پاسخ دهند. برای کسب اطلاعات بیشتر در مورد مدیریت EXECUTE intent ها، به اجرای Intent مراجعه کنید.

action.devices.commands.OpenClose

حالت باز و بسته شدن دستگاه را تنظیم کنید.

مولفه های

مولفه های	تایپ کنید	شرح
openPercent	عدد	ضروری. درصد باز شدن یک دستگاه را نشان می دهد که 0 بسته و 100 کاملاً باز است.
openDirection	رشته	جهتی که در آن باز شود. فقط در صورتی ارائه می شود که دستگاه از چندین جهت پشتیبانی می کند، همانطور که با ویژگی openDirection نشان داده شده است، و یک جهت توسط کاربر مشخص شده باشد. مقادیر پشتیبانی شده: UP DOWN LEFT RIGHT IN OUT
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	رشته	ضروری. نتیجه درخواست. مقادیر پشتیبانی شده: SUCCESS
openPercent	عدد	ضروری. درصد باز شدن یک دستگاه در جایی که 0 بسته و 100 کاملاً باز است را نشان می دهد.

شکست

زمینه های	تایپ کنید	شرح
followUpToken	رشته	ضروری. رمز ارائه شده در درخواست اصلی EXECUTE.
status	رشته	ضروری. نتیجه درخواست. مقادیر پشتیبانی شده: FAILURE
errorCode	رشته	ضروری. مقدار می تواند هر کد خطایی برای این ویژگی باشد، به عنوان مثال، lockedState .

مثال ها

درب گاراژ را باز کنید. (پاسخ پیگیری برای مورد موفقیت)

{
  "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	عدد	ضروری. درصد دقیق تغییر حالت باز-بستن. دستورات نسبی مبهم به یک پارامتر درصد دقیق تبدیل می شوند (به عنوان مثال، "کمی بیشتر پرده ها را باز کنید" در مقابل "پرده ها را 5٪ باز کنید").
openDirection	رشته	جهتی که در آن باز شود. فقط در صورتی ارائه می شود که دستگاه از چندین جهت پشتیبانی می کند، همانطور که با ویژگی openDirection نشان داده شده است، و یک جهت توسط کاربر مشخص شده باشد. مقادیر پشتیبانی شده: UP DOWN LEFT RIGHT IN OUT

مثال ها

دستگاه را کمی بیشتر باز کنید

{
  "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 auf 30%
• Fensterläden um 25 % schliessen
• Ist die Jalousie zu?
• Mach den Rollladen zu
• Mach die Rollos auf
• schließe die Rollläden ein bisschen mehr
• Öffne die Jalousien um 25%

en-US

• Are the blinds in the kitchen open هستند؟
• the blinds Close 25% in my room
• the door more Close
• Just close the front door ببندید
• the blinds in my room open
• the blinds to 25% open
• the door by 25% open

es-ES

• abre la ventana del salón
• cerrar persianas del dormitorio un 20%
• cierra la cortina del salón
• سیرا más cierra mucho la ventana
• está abierta la puerta
• quiero que subas la persiana al 25%
• sube un 20% las persianas

fr-FR

• les stores baisse de 10%
• 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 de 25%
• فروشگاه های ouvre les stores à 25%

سلام ورود

• 25% कृपया पर्दे को खुला रखो
• क्या मैंने सामने वाला दरवाजा खुला छोड दिया?
• पर्दे को 25% बंद करोगे
• पर्दे खोलो
• ब्लाइंड 25% खुले पर सेट कर दीजिए
• ब्लाइंड को थोड़ा और बंद कर दिजिए
• ब्लाइंड बंद करें

it-IT

• abbassa un po' di più le tapparelle
• apri la serranda
• apri la tapparella al 30%
• apri le serrande del 30%
• chiudi le serrande
• chiudi le tende del 25%
• è 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 voor 25% dicht
• doe het raam ietsje meer dicht
• de voordeur open is
• open de gordijnen
• sluit het gordijn
• zet de luxaflex voor 50% 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
• as cortinas abre a 50%
• abrir as cortinas
• abrir as cortinas na sala 30% em
• fecha a persiana por favor
• fecha um bocado a janela
• fechar as cortinas em 25%
• fechar um pouco mais as cortinas

sv-SE

• Dra upp persiennerna
• Dra upp persiennerna till 25%
• stäng persiennen i mitt rum 25%
• stäng persiennerna
• är ytterdörren öppen?
• öppna persiennerna med 25%

خطاهای دستگاه

لیست کامل خطاها و استثناها را ببینید.