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

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
  • آیا die Jalousie zu Ist 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 25% by open

es-ES

  • abre la ventana del salón
  • cerrar persianas del dormitorio un 20%
  • cierra la cortina del salón
  • cierra más 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
  • abre as cortinas a 50%
  • abrir as cortinas
  • abrir as cortinas na sala em 30%
  • 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%

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

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