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: Setel ke benar (true) jika perangkat memungkinkan rotasi berkelanjutan. Saat diberi kueri relatif, perintah |
commandOnlyRotation |
Boolean |
(Default: 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 |
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 |
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 } }
Error terkait
Terjadi error saat menyetel rotasi perangkat.
Nilai yang didukung:
deviceJammingDetected