Schemat cechy LockUnlock dla inteligentnego domu

action.devices.traits.LockUnlock – ta cecha należy do wszystkich urządzeń, które obsługują blokowanie i odblokowywanie oraz raportowanie stanu zablokowania.

ATRYBUTY urządzenia

Brak.

STANY urządzenia

Jednostki z tą cechą mogą zgłaszać te stany w ramach operacji QUERY. Więcej informacji o obsłudze intencji QUERY znajdziesz w artykule Realizacja intencji.

Przykłady

Urządzenie zablokowane

{
  "isLocked": true
}

Urządzenie zablokowane

{
  "isJammed": true
}

POLECENIA urządzenia

Urządzenia z tą cechą mogą odpowiadać na te polecenia w ramach operacji EXECUTE. Więcej informacji o obsłudze intencji EXECUTE znajdziesz w artykule Realizacja intencji.

action.devices.commands.LockUnlock

Blokuje lub odblokowuje urządzenie.

Parametry

Przykłady

Zamknij drzwi wejściowe.

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

Otwórz drzwi wejściowe.

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

Powiązane błędy

Podczas blokowania lub odblokowywania urządzenia wystąpił błąd.

Obsługiwane wartości:

remoteSetDisabled

deviceJammingDetected

notSupported

alreadyLocked

alreadyUnlocked

Odpowiedzi uzupełniające

Urządzenia z tą cechą mogą zwracać ten ładunek odpowiedzi uzupełniającej w ramach operacji EXECUTE. Więcej informacji o implementowaniu odpowiedzi uzupełniających znajdziesz w artykule Powiadomienia w przypadku działań inteligentnego domu.

Ładunek zawiera jedną z tych wartości:

Sukces: zablokowane

Niepowodzenie

Przykłady

Zamknij drzwi wejściowe. (odpowiedź uzupełniająca w przypadku powodzenia)

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

Otwórz drzwi wejściowe. (odpowiedź uzupełniająca w przypadku powodzenia)

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

Zamknij drzwi wejściowe. (odpowiedź uzupełniająca w przypadku niepowodzenia)

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

Przykładowe wypowiedzi

BŁĘDY urządzenia