Skema Karakter Rotasi Smart Home

action.devices.traits.Rotation - Sifat ini milik perangkat yang mendukung rotasi.

Rotasi dapat ditentukan dalam persen atau derajat dan jika perangkat mendukung rotasi dengan derajat, arah rotasi {i>default<i} adalah searah jarum jam.

ATTRIBUTES Perangkat

Perangkat dengan karakteristik ini mungkin melaporkan hal berikut sebagai bagian dari operasi SYNC. Untuk mempelajari selengkapnya tentang menangani intent SYNC, lihat Pemenuhan intent.

Atribut Jenis Deskripsi
supportsDegrees Boolean

Wajib.

Setel ke true jika perangkat mengizinkan rotasi menurut derajat.
supportsPercent Boolean

Wajib.

Setel ke true jika perangkat mengizinkan rotasi berdasarkan persen
rotationDegreesRange Objek

Menunjukkan rentang dalam derajat yang dapat diputar oleh perangkat.
rotationDegreesMin Number

Wajib.

Rotasi minimum dalam derajat.
rotationDegreesMax Number

Wajib.

Rotasi maksimum dalam derajat.
supportsContinuousRotation Boolean

(Default: false)

Tetapkan ke true jika perangkat mengizinkan rotasi berkelanjutan. Saat diberi kueri relatif, perintah RotateAbsolute akan menggabungkan rentang rotasi yang didukung.
commandOnlyRotation Boolean

(Default: false)

Menunjukkan apakah perangkat mendukung penggunaan komunikasi satu arah (benar) atau dua arah (salah). Tetapkan atribut ini ke true jika perangkat tidak dapat merespons intent QUERY atau Status Laporan untuk karakteristik ini.

Contoh

Perangkat yang mendukung rotasi dalam persen dan derajat.

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

Perangkat yang hanya mendukung rotasi dalam derajat.

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

Perangkat yang hanya mendukung perintah rotasi berkelanjutan.

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

NEGARA Perangkat

Entitas dengan karakteristik ini dapat melaporkan hal berikut status sebagai bagian dari operasi QUERY. Untuk mempelajari selengkapnya tentang menangani intent QUERY, lihat Pemenuhan intent.

Negara bagian Jenis Deskripsi
rotationDegrees Number

Tingkat saat ini dalam rotationDegreesRange yang menunjukkan derajat rotasi perangkat. Nilai ini harus selalu relatif terhadap rotasi searah jarum jam.
rotationPercent Number

Level saat ini yang menunjukkan persentase perangkat diputar saat ini. 0,0 sama dengan tertutup dan 100,0 untuk terbuka.
targetRotationPercent Number

Level yang menunjukkan persentase rotasi tempat perangkat akan pergi atau dipindahkan sebagai hasil dari perubahan rotasi yang sedang berlangsung.

Contoh

Berapa kali perangkat diputar? (persen dan derajat).

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

Berapa kali perangkat diputar? (hanya derajat).

{
  "rotationDegrees": 45
}

Berapa kali perangkat diputar? (berkelanjutan).

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

Perangkat yang sedang diputar ke posisi baru (persen).

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

Perangkat COMMANDS

Perangkat dengan karakteristik ini dapat merespons hal berikut sebagai bagian dari operasi EXECUTE. Untuk mempelajari selengkapnya tentang menangani intent EXECUTE, lihat Pemenuhan intent.

action.devices.commands.RotateAbsolute

Menetapkan rotasi absolut perangkat.

Parameter

Payload berisi salah satu hal berikut:

Tetapkan rotasi absolut dalam derajat.

Parameter Jenis Deskripsi
rotationDegrees Number

Wajib.

Nilai absolut, dalam derajat, yang menentukan rotasi terakhir searah jarum jam pada perangkat. Nilai harus berada dalam atribut rotationDegreesRange.

Menetapkan rotasi absolut dalam persentase.

Parameter Jenis Deskripsi
rotationPercent Number

Wajib.

Nilai absolut, dalam persentase, yang menentukan rotasi akhir perangkat.

Contoh

Miringkan perangkat hingga 50 persen.

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

Putar perangkat 15 derajat berlawanan arah jarum jam (rotationDegrees: 45).

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

Putar perangkat 100 derajat searah jarum jam (supportsContinuousRotation: true, rotationDegrees: 270).

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

Terjadi error saat menetapkan rotasi perangkat.

Nilai yang didukung:

deviceJammingDetected

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.