مخطط سمة Smart Home LockUnlock

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

سمات الجهاز

بلا عُري

حالات الجهاز

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

الولايات	النوع	الوصف
isLocked	قيمة منطقية	تُستخدَم لتحديد ما إذا كان الجهاز مقفلاً حاليًا.
isJammed	قيمة منطقية	تُستخدَم لتحديد ما إذا كان الجهاز محظورًا حاليًا وبالتالي لا يمكن تحديد حالته المقفلة.

أمثلة

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

{
  "isLocked": true
}

الجهاز العالق

{
  "isJammed": true
}

أوامر الجهاز

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

action.devices.commands.LockUnlock

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

المعلمات

المعلمات	النوع	الوصف
lock	قيمة منطقية	مطلوبة تكون القيمة "صحيح" عند قفل الجهاز، و"خطأ" عند إلغاء قفله.
followUpToken	String	رمز مميز تقدّمه 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	String	مطلوبة الرمز المميّز المقدَّم في طلب EXECUTE الأصلي
status	String	مطلوبة نتيجة الطلب القيم المسموح بها: SUCCESS
isLocked	قيمة منطقية	مطلوبة تشير إلى ما إذا كان الجهاز مقفلاً.

تعذّر إتمام العملية

الحقول	النوع	الوصف
followUpToken	String	مطلوبة الرمز المميّز المقدَّم في طلب EXECUTE الأصلي
status	String	مطلوبة نتيجة الطلب القيم المسموح بها: FAILURE
errorCode	String	مطلوبة يمكن أن تكون القيمة أي رمز خطأ لهذه السمة، مثل 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

أخطاء الجهاز

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