طرحواره ویژگی OpenClose خانه هوشمند

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

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

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

ویژگی‌ها نوع توضیحات
discreteOnlyOpenClose بولی

(پیش‌فرض: false )

وقتی روی true تنظیم شود، نشان می‌دهد که دستگاه یا باید کاملاً باز یا کاملاً بسته باشد (یعنی از مقادیر بین ۰٪ تا ۱۰۰٪ پشتیبانی نمی‌کند).

openDirection آرایه

فهرست جهت‌های پشتیبانی‌شده‌ای که دستگاه می‌تواند در آن‌ها باز یا بسته شود. اگر دستگاه از باز و بسته شدن در بیش از یک جهت پشتیبانی می‌کند، این ویژگی را اضافه کنید.

[ item, ... ] رشته

جهت پشتیبانی شده

مقادیر پشتیبانی شده:

UP
DOWN
LEFT
RIGHT
IN
OUT
commandOnlyOpenClose بولی

(پیش‌فرض: false )

نشان می‌دهد که آیا دستگاه از ارتباط یک‌طرفه (true) یا دوطرفه (false) پشتیبانی می‌کند یا خیر. اگر دستگاه نمی‌تواند به یک درخواست پرس‌وجو (QUERY intent) یا گزارش وضعیت (Report State) برای این ویژگی پاسخ دهد، این ویژگی را روی true تنظیم کنید.

queryOnlyOpenClose بولی

(پیش‌فرض: false )

نشان می‌دهد که آیا دستگاه فقط می‌تواند برای اطلاعات وضعیت مورد پرسش قرار گیرد و قابل کنترل نیست. حسگرهایی که فقط می‌توانند وضعیت باز را گزارش دهند، باید این فیلد را روی true تنظیم کنند.

مثال‌ها

دستگاه باز و بسته کردن ساده.

{
  "discreteOnlyOpenClose": true
}

دستگاه از بالا به پایین، از پایین به بالا. می‌تواند در هر دو جهت باز شود.

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

دستگاهی که فقط با فرمان کار می‌کند.

{
  "commandOnlyOpenClose": false
}

وضعیت دستگاه

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

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

باز و بسته شدن تک جهته

ایالت‌ها نوع توضیحات
openPercent شماره

الزامی است.

درصد باز بودن دستگاه را نشان می‌دهد، که در آن ۰ به معنای بسته بودن و ۱۰۰ به معنای باز بودن کامل است.

مقدار باید بین 0 تا 100 باشد.

targetOpenPercent شماره

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

مقدار باید بین 0 تا 100 باشد.

باز و بسته شدن چند جهته

ایالت‌ها نوع توضیحات
openState آرایه

الزامی است.

فهرست ایالت‌ها برای هر جهت باز پشتیبانی‌شده.

[ item, ... ] شیء

وضعیت فعلی برای جهت باز داده شده.

openPercent شماره

الزامی است.

درصد باز بودن دستگاه را نشان می‌دهد، که در آن ۰ به معنای بسته بودن و ۱۰۰ به معنای باز بودن کامل است.

مقدار باید بین 0 تا 100 باشد.

targetOpenPercent شماره

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

مقدار باید بین 0 تا 100 باشد.

openDirection رشته

الزامی است.

جهتی که دستگاه باز می‌شود.

مقادیر پشتیبانی شده:

UP
DOWN
LEFT
RIGHT
IN
OUT

مثال‌ها

دستگاه باز و بسته کردن ساده.

{
  "openPercent": 100
}

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

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

دستگاه را به میزان ۳۰٪ در جهت پایین و ۵۰٪ در جهت بالا باز کنید.

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

دستگاه را به میزان ۳۰٪ در جهت پایین و ۵۰٪ در جهت بالا باز کنید، و در حال حاضر این مقدار به ۸۰٪ در جهت بالا می‌رسد.

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

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

دستگاه‌هایی که این ویژگی را دارند، می‌توانند به دستورات زیر به عنوان بخشی از عملیات EXECUTE پاسخ دهند. برای کسب اطلاعات بیشتر در مورد مدیریت اهداف EXECUTE ، به بخش «تحقق اهداف» مراجعه کنید.

action.devices.commands.OpenClose

وضعیت باز و بسته بودن دستگاه را تنظیم کنید.

پارامترها

پارامترها نوع توضیحات
openPercent شماره

الزامی است.

درصد باز بودن دستگاه را نشان می‌دهد، که در آن ۰ به معنای بسته بودن و ۱۰۰ به معنای باز بودن کامل است.

مقدار باید بین 0 تا 100 باشد.

openDirection رشته

جهت باز شدن. فقط در صورتی نمایش داده می‌شود که دستگاه از چندین جهت پشتیبانی کند، همانطور که در ویژگی openDirection نشان داده شده است، و یک جهت توسط کاربر مشخص شده باشد.

مقادیر پشتیبانی شده:

UP
DOWN
LEFT
RIGHT
IN
OUT
followUpToken رشته

توکن ارائه شده توسط گوگل برای پاسخ‌های بعدی.

مثال‌ها

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

{
  "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 رشته

الزامی است.

مقدار می‌تواند هر کد خطایی برای این trait باشد، برای مثال، 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

وضعیت باز و بسته شدن دستگاه را نسبت به وضعیت فعلی تنظیم می‌کند. این دستور فقط در صورتی در دسترس است که discreteOnlyOpenClose روی false تنظیم شده باشد.

این دستور به ویژگی‌های زیر نیاز دارد: 
{
  "discreteOnlyOpenClose": false
}

پارامترها

پارامترها نوع توضیحات
openRelativePercent شماره

الزامی است.

درصد دقیق برای تغییر حالت باز و بسته شدن. دستورات نسبی مبهم به یک پارامتر درصد دقیق تبدیل می‌شوند (برای مثال، "پرده‌ها را کمی بیشتر باز کنید" در مقابل "پرده‌ها را 5٪ باز کنید").

مقدار باید بین -100 و 100 باشد.

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
  }
}

دستگاه را ۵۰٪ بیشتر، به سمت پایین باز کنید. 

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": 50,
    "openDirection": "DOWN"
  }
}

خطایی در تنظیم وضعیت باز و بسته شدن دستگاه رخ داده است.

مقادیر پشتیبانی شده:

lockedState
deviceJammingDetected

نمونه گفته‌ها

د-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%

انگلیسی-آمریکایی

  • 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

ای‌اس-ای‌اس

  • abre la ventana del salón
  • cerrar persianas del dormitorio un 20%
  • cierra la cortina del salón
  • cierra mucho más 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
  • les stores ferme
  • ferme un peu les stores
  • les stores ouvre
  • ouvre les stores de la chambre de 25%
  • les stores 25% ouvre à

سلام-ورودی

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

فناوری اطلاعات

  • 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

جا-جی پی

  • 25%にブラインドを開けて
  • 25% ブラインドを閉めてください
  • 25% ブラインド開けて
  • ブラインド閉めて
  • ブラインド開けて
  • 少しブラインドを閉じて
  • 玄関のドアは開いてますか

کو-کی‌آر

  • 문 살짝만 닫아 줘
  • 블라인드 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 50% open voor

پی تی-بی آر

  • 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%
  • as cortinas abre
  • 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
  • آیا ytterdörren افتاده är öppen?
  • öppna persiennerna med 25%

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

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