Skema Fitur Rotasi Smart Home

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

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

ATRIBUT Perangkat

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

Atribut	Jenis	Deskripsi
supportsDegrees	Boolean	Wajib. Tetapkan ke true jika perangkat memungkinkan rotasi berdasarkan derajat.
supportsPercent	Boolean	Wajib. Tetapkan ke true jika perangkat memungkinkan rotasi berdasarkan persen
rotationDegreesRange	Objek	Merepresentasikan 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 memungkinkan rotasi berkelanjutan. Jika diberikan kueri relatif, perintah RotateAbsolute akan mengelilingi 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 fitur 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

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

Negara bagian	Jenis	Deskripsi
rotationDegrees	Number	Level saat ini dalam rotationDegreesRange yang menunjukkan berapa derajat perangkat diputar. Nilai ini harus selalu relatif terhadap rotasi searah jarum jam.
rotationPercent	Number	Level saat ini yang menunjukkan persentase perangkat yang sedang diputar. 0,0 sesuai dengan tertutup dan 100,0 untuk membuka.

Contoh

Berapa banyak perangkat yang diputar? (persen dan derajat).

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

Berapa banyak perangkat yang diputar? (hanya derajat).

{
  "rotationDegrees": 45
}

Berapa banyak perangkat yang diputar? (berkelanjutan).

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

COMMAND Perangkat

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

Menetapkan rotasi absolut perangkat.

Parameter

Payload berisi salah satu dari hal berikut:

Tetapkan rotasi absolut dalam derajat.

Parameter	Jenis	Deskripsi
rotationDegrees	Number	Wajib. Nilai mutlak, dalam derajat, yang menentukan rotasi akhir searah jarum jam dari perangkat. Nilai harus berada dalam atribut rotationDegreesRange.

Tetapkan 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 sebesar 15 derajat berlawanan arah jarum jam (rotationDegrees: 45).

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

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

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

Error terkait

Terjadi kesalahan saat menyetel rotasi perangkat.

Nilai yang didukung:

deviceJammingDetected

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.