Skema Trait Rotasi Smart Home

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

Rotasi dapat ditentukan dalam persen atau derajat, dan jika perangkat mendukung rotasi menurut derajat, arah default rotasi adalah searah jarum jam.

ATTRIBUTE Perangkat

Perangkat dengan ciri ini dapat melaporkan atribut berikut sebagai bagian dari operasi SYNC. Untuk mempelajari penanganan intent SYNC lebih lanjut, lihat Fulfillment intent.

Atribut Type Deskripsi
supportsDegrees Boolean

Wajib.

Setel ke benar (true) jika perangkat memungkinkan rotasi berdasarkan derajat.

supportsPercent Boolean

Wajib.

Tetapkan ke benar (true) jika perangkat memungkinkan rotasi berdasarkan persen

rotationDegreesRange Objek

Merepresentasikan rentang dalam derajat yang dapat diputar perangkat.

rotationDegreesMin Number

Wajib.

Rotasi minimum dalam derajat.

rotationDegreesMax Number

Wajib.

Rotasi maksimum dalam derajat.

supportsContinuousRotation Boolean

(Default: false)

Setel ke benar (true) jika perangkat memungkinkan rotasi berkelanjutan. Saat diberi kueri relatif, perintah RotateAbsolute akan mencakup rentang rotasi yang didukung.

commandOnlyRotation Boolean

(Default: false)

Menunjukkan apakah perangkat mendukung penggunaan komunikasi satu arah (benar) atau dua arah (salah). Setel atribut ini ke benar (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
}

STATUS Perangkat

Entitas dengan karakteristik ini dapat melaporkan status berikut sebagai bagian dari operasi QUERY. Untuk mempelajari penanganan intent QUERY lebih lanjut, lihat Fulfillment intent.

Status Type Deskripsi
rotationDegrees Number

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

rotationPercent Number

Tingkat saat ini yang menunjukkan persentase perangkat sedang diputar. 0,0 berarti tertutup dan 100,0 berarti terbuka.

Contoh

Berapa banyak perangkat diputar? (persen dan derajat).

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

Berapa banyak perangkat diputar? (hanya derajat).

{
  "rotationDegrees": 45
}

Berapa banyak perangkat diputar? (bersambung).

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

Perangkat COMMAND

Perangkat dengan karakteristik ini dapat merespons perintah berikut sebagai bagian dari operasi EXECUTE. Untuk mempelajari penanganan intent EXECUTE lebih lanjut, lihat Fulfillment intent.

action.devices.commands.RotateAbsolute

Menyetel rotasi absolut perangkat.

Parameter

Payload berisi salah satu hal berikut:

Tetapkan rotasi absolut dalam derajat.

Parameter Type Deskripsi
rotationDegrees Number

Wajib.

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

Tetapkan rotasi absolut dalam persentase.

Parameter Type Deskripsi
rotationPercent Number

Wajib.

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

Contoh

Miringkan perangkat ke 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 menyetel rotasi perangkat.

Nilai yang didukung:

deviceJammingDetected

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.