به Google Home Developer Center، مقصد جدیدی برای یادگیری نحوه توسعه اقدامات خانه هوشمند خوش آمدید. توجه: به ساخت کنش‌ها در کنسول Actions ادامه خواهید داد.
با مجموعه‌ها، منظم بمانید ذخیره و دسته‌بندی محتوا براساس اولویت‌های شما.

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

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 کاملاً باز است.

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

ایالت ها تایپ کنید شرح
openState آرایه

ضروری.

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

[ item, ... ] هدف - شی

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

openPercent عدد

ضروری.

درصد باز شدن یک دستگاه را نشان می دهد که 0 بسته و 100 کاملاً باز است.

openDirection رشته

ضروری.

جهتی که دستگاه در آن باز می شود.

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

UP
DOWN
LEFT
RIGHT
IN
OUT

مثال ها

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

{
  "openPercent": 100
}

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

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

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

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

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

ضروری.

مقدار می تواند هر کد خطایی برای این ویژگی باشد، به عنوان مثال، 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
  • Istdie 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

  • Arethe blinds in the kitchen open
  • Close the blinds 25% in my room
  • Close the door more
  • Just close the front door
  • open the blinds in my room
  • open the blinds to 25%
  • open the door by 25%

es-ES

  • 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á abiertala puerta
  • quiero que subas la persiana al 25%
  • sube un 20% las persianas

fr-FR

  • baisse les stores de 10%
  • est-ce quela 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%
  • è apertala 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
  • isde voordeur open
  • 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
  • ärytterdörren öppen?
  • öppna persiennerna med 25%

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

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

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

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 کاملاً باز است.

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

ایالت ها تایپ کنید شرح
openState آرایه

ضروری.

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

[ item, ... ] هدف - شی

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

openPercent عدد

ضروری.

درصد باز شدن یک دستگاه را نشان می دهد که 0 بسته و 100 کاملاً باز است.

openDirection رشته

ضروری.

جهتی که دستگاه در آن باز می شود.

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

UP
DOWN
LEFT
RIGHT
IN
OUT

مثال ها

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

{
  "openPercent": 100
}

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

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

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

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

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

ضروری.

مقدار می تواند هر کد خطایی برای این ویژگی باشد، به عنوان مثال، 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
  • Istdie 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

  • Arethe blinds in the kitchen open
  • Close the blinds 25% in my room
  • Close the door more
  • Just close the front door
  • open the blinds in my room
  • open the blinds to 25%
  • open the door by 25%

es-ES

  • 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á abiertala puerta
  • quiero que subas la persiana al 25%
  • sube un 20% las persianas

fr-FR

  • baisse les stores de 10%
  • est-ce quela 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%
  • è apertala 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
  • isde voordeur open
  • 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
  • ärytterdörren öppen?
  • öppna persiennerna med 25%

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

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

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

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 کاملاً باز است.

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

ایالت ها تایپ کنید شرح
openState آرایه

ضروری.

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

[ item, ... ] هدف - شی

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

openPercent عدد

ضروری.

درصد باز شدن یک دستگاه را نشان می دهد که 0 بسته و 100 کاملاً باز است.

openDirection رشته

ضروری.

جهتی که دستگاه در آن باز می شود.

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

UP
DOWN
LEFT
RIGHT
IN
OUT

مثال ها

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

{
  "openPercent": 100
}

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

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

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

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

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

ضروری.

مقدار می تواند هر کد خطایی برای این ویژگی باشد، به عنوان مثال، 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
  • Istdie 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

  • Arethe blinds in the kitchen open
  • Close the blinds 25% in my room
  • Close the door more
  • Just close the front door
  • open the blinds in my room
  • open the blinds to 25%
  • open the door by 25%

es-ES

  • 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á abiertala puerta
  • quiero que subas la persiana al 25%
  • sube un 20% las persianas

fr-FR

  • baisse les stores de 10%
  • est-ce quela 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%
  • è apertala 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
  • isde voordeur open
  • 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
  • ärytterdörren öppen?
  • öppna persiennerna med 25%

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

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