Schemat atrybutu rotacji inteligentnego domu

action.devices.traits.Rotation – ta cecha dotyczy urządzeń, które obsługują obracanie.

Rotację można określić w procentach lub stopniach. Jeśli urządzenie obsługuje obrót o określoną liczbę stopni, domyślnym kierunkiem obrotu jest kierunek zgodny z kierunkiem ruchu wskazówek zegara.

ATRYBUTY URZĄDZENIA

Urządzenia z tą cechą mogą zgłaszać te atrybuty w ramach operacji SYNC. Więcej informacji o obsługiwaniu intencji SYNC znajdziesz w artykule Realizacja intencji.

Atrybuty Typ Opis
supportsDegrees Wartość logiczna

Wymagany.

Ustaw na Prawda, jeśli urządzenie pozwala na obrót o stopnie.
supportsPercent Wartość logiczna

Wymagany.

Ustaw na Prawda, jeśli urządzenie zezwala na obracanie o określony procent.
rotationDegreesRange Obiekt

Zakres w stopniach, w którym urządzenie może się obracać.
rotationDegreesMin Number

Wymagany.

Minimalny kąt obrotu w stopniach.
rotationDegreesMax Number

Wymagany.

Maksymalny obrót w stopniach.
supportsContinuousRotation Wartość logiczna

(wartość domyślna: false)

Ustaw na Prawda, jeśli urządzenie umożliwia ciągłe obracanie. W przypadku zapytania względnego polecenie RotateAbsolute powoduje owinięcie obsługiwanego zakresu rotacji.
commandOnlyRotation Wartość logiczna

(wartość domyślna: false)

Wskazuje, czy urządzenie obsługuje komunikację w jednym kierunku (prawda) czy w obu kierunkach (fałsz). Ustaw ten atrybut na „PRAWDA”, jeśli urządzenie nie może odpowiadać na intencję QUERY lub raportować stanu dla tej cechy.

Przykłady

Urządzenie, które obsługuje zarówno obracanie w procentach, jak i w stopniach.

{
  "supportsDegrees": true,
  "supportsPercent": true,
  "rotationDegreesRange": {
    "rotationDegreesMin": 0,
    "rotationDegreesMax": 180
  }
}

Urządzenie obsługujące tylko obracanie w stopniach.

{
  "supportsDegrees": true,
  "supportsPercent": false,
  "rotationDegreesRange": {
    "rotationDegreesMin": 0,
    "rotationDegreesMax": 90
  }
}

Urządzenie obsługujące tylko polecenia ciągłego obracania.

{
  "supportsDegrees": true,
  "supportsPercent": true,
  "rotationDegreesRange": {
    "rotationDegreesMin": 0,
    "rotationDegreesMax": 360
  },
  "supportsContinuousRotation": true,
  "commandOnlyRotation": true
}

STANOWISKO URZĄDZENIA

Elementy z tą cechą mogą raportować te stany w ramach operacji QUERY. Więcej informacji o obsługiwaniu intencji QUERY znajdziesz w artykule Realizacja intencji.

Stany Typ Opis
rotationDegrees Number

Aktualny poziom w rotationDegreesRange, który wskazuje, o ile stopni urządzenie jest obrócony. Ta wartość powinna zawsze być względna do obrotu zgodnie z ruchem wskazówek zegara.
rotationPercent Number

Bieżący poziom, który wskazuje, o ile procent urządzenie jest obecnie obracane. Wartość 0,0 odpowiada zamkniętemu, a 100,0 – otwartemu.
targetRotationPercent Number

Poziom wskazujący odsetek obrotu, do którego urządzenie się przemieści lub do którego się przemieszcza w ramach trwającej zmiany obrotu.

Przykłady

O ile urządzenie jest obrócone? (procenty i stopnie).

{
  "rotationDegrees": 45,
  "rotationPercent": 25
}

O ile urządzenie jest obrócone? (tylko stopnie).

{
  "rotationDegrees": 45
}

O ile urządzenie jest obrócone? (ciągłe).

{
  "rotationDegrees": 270,
  "rotationPercent": 75
}

Urządzenie obraca się w obecnej chwili w kierunku nowej pozycji (procent).

{
  "rotationPercent": 75,
  "targetRotationPercent": 100
}

Polecenia urządzenia

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

action.devices.commands.RotateAbsolute

Ustaw bezwzględne położenie urządzenia.

Parametry

Ładunek zawiera jedną z tych opcji:

Ustaw bezwzględny obrót w stopniach.

Parametry Typ Opis
rotationDegrees Number

Wymagany.

Wartość bezwzględna w stopniach, która określa ostateczne obracanie urządzenia zgodnie z ruchem wskazówek zegara. Wartość musi mieścić się w zakresie atrybutu rotationDegreesRange.

Ustaw bezwzględną rotację w procentach.

Parametry Typ Opis
rotationPercent Number

Wymagany.

Wartość bezwzględna wyrażona w procentach, która określa ostateczne obrócenie urządzenia.

Przykłady

Pochylaj urządzenie, aż wyświetli się 50 procent.

{
  "command": "action.devices.commands.RotateAbsolute",
  "params": {
    "rotationPercent": 50
  }
}

Obróć urządzenie o 15 stopni w lewy kąt (rotationDegrees: 45).

{
  "command": "action.devices.commands.RotateAbsolute",
  "params": {
    "rotationDegrees": 30
  }
}

Obróć urządzenie o 100 stopni w prawo (supportsContinuousRotation: true, rotationDegrees: 270).

{
  "command": "action.devices.commands.RotateAbsolute",
  "params": {
    "rotationDegrees": 10
  }
}

Podczas ustawiania obracania urządzenia wystąpił błąd.

Obsługiwane wartości:

deviceJammingDetected

BŁĘDY urządzenia

Zobacz pełną listę błędów i wyjątków.