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

مخطط سمة SmartLock LockLock

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

سمات الجهاز

بلا عري

حالات الجهاز

قد تُبلِغ الكيانات التي تحمل هذه السمة عن الحالات التالية كجزء من عملية QUERY. للاطّلاع على مزيد من المعلومات حول التعامل مع عناصر intent في QUERY، يُرجى الاطّلاع على تنفيذ النية بالشراء.

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

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

isJammed منطقي

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

أمثلة

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

{
  "isLocked": true
}

الجهاز عالِق

{
  "isJammed": true
}

حوالات الجهاز

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

action.devices.commands.LockUnlock

يمكنك قفل الجهاز أو فتح قفله.

المعلّمات

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

مطلوب:

تكون القيمة صحيحة عندما يكون الأمر مُقفَلاً، ويتم ضبط القيمة على "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. ولمزيد من المعلومات حول تنفيذ استجابات المتابعة، يُرجى الاطّلاع على إشعارات الإجراءات المنزلية الذكية.

تحتوي الحمولة على أحد العناصر التالية:

نجاح: تم القفل

الحقول Type الوصف
followUpToken سلسلة

مطلوب:

الرمز المميّز المقدَّم في طلب EXECUTE الأصلي

status سلسلة

مطلوب:

نتيجة الطلب

القيم المسموح بها

SUCCESS
isLocked منطقي

مطلوب:

تحدِّد هذه السياسة ما إذا كان الجهاز مقفلاً.

تعذّر الإجراء

الحقول Type الوصف
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

أخطاء الجهاز

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