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

طرح ویژگی قفل بازگشایی خانه هوشمند

action.devices.traits.LockUnlock - این ویژگی به هر دستگاهی تعلق دارد که از قفل و باز کردن قفل و/یا گزارش وضعیت قفل پشتیبانی می کند.

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

هیچ یک.

وضعیت دستگاه

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

ایالت ها تایپ کنید شرح
isLocked بولی

آیا دستگاه در حال حاضر قفل است یا خیر.

isJammed بولی

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

مثال ها

دستگاهی که قفل شده است

{
  "isLocked": true
}

دستگاهی که گیر کرده است

{
  "isJammed": true
}

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

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

action.devices.commands.LockUnlock

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

مولفه های

مولفه های تایپ کنید شرح
lock بولی

ضروری.

درست زمانی که فرمان قفل کردن است، نادرست برای باز کردن قفل.

followUpToken رشته

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

مثال ها

درب ورودی را قفل کنید.

{
  "command": "action.devices.commands.LockUnlock",
  "params": {
    "lock": true,
    "followUpToken": "123"
  }
}

قفل درب ورودی را باز کنید.

{
  "command": "action.devices.commands.LockUnlock",
  "params": {
    "lock": false,
    "followUpToken": "567"
  }
}

هنگام قفل کردن یا باز کردن قفل دستگاه خطایی روی داد.

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

remoteSetDisabled
deviceJammingDetected
notSupported
alreadyLocked
alreadyUnlocked

پاسخ های بعدی

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

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

موفقیت: قفل شده است

زمینه های تایپ کنید شرح
followUpToken رشته

ضروری.

رمز ارائه شده در درخواست اصلی EXECUTE.

status رشته

ضروری.

نتیجه درخواست.

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

SUCCESS
isLocked بولی

ضروری.

نشان می دهد که آیا دستگاه قفل است یا خیر.

شکست

زمینه های تایپ کنید شرح
followUpToken رشته

ضروری.

رمز ارائه شده در درخواست اصلی EXECUTE.

status رشته

ضروری.

نتیجه درخواست.

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

FAILURE
errorCode رشته

ضروری.

مقدار می تواند هر کد خطایی برای این ویژگی باشد، به عنوان مثال، deviceJammingDetected .

مثال ها

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

{
  "LockUnlock": {
    "priority": 0,
    "followUpResponse": {
      "status": "SUCCESS",
      "isLocked": true,
      "followUpToken": "1234"
    }
  }
}

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

{
  "LockUnlock": {
    "priority": 0,
    "followUpResponse": {
      "status": "SUCCESS",
      "isLocked": false,
      "followUpToken": "1234"
    }
  }
}

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

{
  "LockUnlock": {
    "priority": 0,
    "followUpResponse": {
      "status": "FAILURE",
      "errorCode": "deviceJammingDetected",
      "followUpToken": "1234"
    }
  }
}

نمونه گفته ها

de-DE

  • Bitte Eingangstür abschließen
  • Bitte schließ die Eingangstür auf

en-US

  • lock my doors
  • unlock study room

es-ES

  • cierra la puerta con llave
  • quitar el cerrojo de la puerta de entrad a

fr-FR

  • déverrouille la porte d'entrée
  • verrouille la porte d'entrée

سلام ورود

  • फ़्रंट डोर अनलॉक करो
  • सामने के दरवाजे को लॉक करो

it-IT

  • apri la porta d'ingresso
  • puoi chiudere la porta d'ingresso a chiave

ja-JP

  • 玄関のドアを施錠して
  • 玄関開錠して

ko-KR

  • 도어락 잠가 줘
  • 현관 도어락 열어 줄래

nl-NL

  • Ontgrendel de voordeur
  • doe de voordeur op slot

pt-BR

  • Tranca a porta do quarto .
  • destranca a porta da cozinha
  • destrancar a porta da frente
  • trancar a porta da frente

sv-SE

  • lås upp ytterdörren
  • lås ytterdörren

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

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