مرحبًا بك في "مركز مطوّري برامج Google Home"، وجهتك الجديدة لتعلّم كيفية تطوير إجراءات منزلية ذكية. ملاحظة: ستواصل إنشاء الإجراءات في وحدة تحكم الإجراءات.
تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

مخطط ميزة Smart Lock Lock في Smart Home

action.devices.traits.LockUnlock: تنتمي هذه السمة إلى أي أجهزة تتيح القفل و/أو فتح القفل و/أو الإبلاغ عن حالة القفل.

الجهاز ATTRIBUTES

بلا عري

حالة الجهاز STATES

ويمكن للأجهزة التي تتضمّن هذه السمة الإبلاغ عن الحالات التالية كجزء من عملية QUERY. لمزيد من المعلومات حول التعامل مع إجراءات QUERY، يُرجى الاطّلاع على تنفيذ الإجراء.

الولايات النوع الوصف
isLocked منطقي

ما إذا كان الجهاز مقفولاً حاليًا.

isJammed منطقي

ما إذا كان الجهاز عالقًا حاليًا وبالتالي لا يمكن تحديد حالة القفل.

أمثلة

الجهاز المُقفَل

{
  "isLocked": true
}

الجهاز عالِق

{
  "isJammed": true
}

مفاتيح COMMAND

قد تستجيب الأجهزة التي تتضمّن هذه السمة للأوامر التالية كجزء من عملية EXECUTE. لمزيد من المعلومات حول التعامل مع إجراءات EXECUTE، يُرجى الاطّلاع على تنفيذ الإجراء.

action.devices.commands.LockUnlock

قفل الجهاز أو فتح قفله

المَعلمات

المَعلمات النوع الوصف
lock منطقي

مطلوبة.

يتم ضبط "True" عندما يكون الأمر على القفل، وعلى "false" لإلغاء التأمين.

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

hi-IN

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

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

أخطاء الجهاز

يمكنك الاطلاع على القائمة الكاملة للأخطاء والاستثناءات.