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: Tetapkan ke true jika perangkat memungkinkan rotasi berkelanjutan. Jika diberikan kueri relatif, perintah |
commandOnlyRotation |
Boolean |
(Default: 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 |
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 |
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