สคีมาฟีเจอร์การหมุนบ้านอัจฉริยะ

action.devices.traits.Rotation - ลักษณะนี้เป็นของอุปกรณ์ที่รองรับการหมุน

คุณระบุการหมุนเป็นเปอร์เซ็นต์หรือองศาได้ และหากอุปกรณ์รองรับการหมุนเป็นองศา ทิศทางเริ่มต้นของการหมุนจะเป็นตามเข็มนาฬิกา

แอตทริบิวต์ของอุปกรณ์

อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจรายงานแอตทริบิวต์ต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ SYNC หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ SYNC โปรดดูการดําเนินการ Intent

Attributes	ประเภท	คำอธิบาย
supportsDegrees	บูลีน	ต้องระบุ ตั้งค่าเป็น true ถ้าอุปกรณ์อนุญาตการหมุนตามองศา
supportsPercent	บูลีน	ต้องระบุ ตั้งค่าเป็นจริงหากอุปกรณ์อนุญาตให้หมุนได้เป็นเปอร์เซ็นต์
rotationDegreesRange	ออบเจ็กต์	แสดงช่วงเป็นองศาที่อุปกรณ์หมุนได้
rotationDegreesMin	Number	ต้องระบุ การหมุนขั้นต่ําเป็นองศา
rotationDegreesMax	Number	ต้องระบุ การหมุนสูงสุดระดับองศา
supportsContinuousRotation	บูลีน	(ค่าเริ่มต้น: false) ตั้งค่าเป็น "จริง" หากอุปกรณ์อนุญาตการหมุนอย่างต่อเนื่อง เมื่อได้รับการค้นหาที่เกี่ยวข้อง คําสั่ง RotateAbsolute จะล้อมรอบช่วงการหมุนที่รองรับ
commandOnlyRotation	บูลีน	(ค่าเริ่มต้น: false) ระบุว่าอุปกรณ์รองรับการสื่อสารแบบทางเดียว (จริง) หรือแบบ 2 ทาง (เท็จ) ตั้งค่าแอตทริบิวต์นี้เป็น "จริง" หากอุปกรณ์ไม่สามารถตอบสนองต่อความตั้งใจหรือสถานะรายงานสําหรับลักษณะเฉพาะนี้ได้

ตัวอย่าง

อุปกรณ์ที่รองรับทั้งการหมุนเป็นเปอร์เซ็นต์และองศา

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

อุปกรณ์ที่รองรับการหมุนเป็นองศาเท่านั้น

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

อุปกรณ์ที่รองรับเฉพาะคําสั่งหมุนอย่างต่อเนื่อง

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

อุปกรณ์ STATES

เอนทิตีที่มีลักษณะนี้อาจรายงานสถานะต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ QUERY หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ QUERY โปรดดูการดําเนินการ Intent

รัฐ	ประเภท	คำอธิบาย
rotationDegrees	Number	ระดับปัจจุบันภายใน rotationDegreesRange ซึ่งระบุระดับที่หมุนอุปกรณ์ ค่านี้ควรสัมพันธ์กับการหมุนตามเข็มนาฬิกาเสมอ
rotationPercent	Number	ระดับปัจจุบันที่ระบุเปอร์เซ็นต์การหมุนอุปกรณ์ในขณะนี้ 0.0 หมายถึงปิดและ 100.0 เพื่อเปิด

ตัวอย่าง

อุปกรณ์นี้หมุนมากเพียงใด (เปอร์เซ็นต์และองศา)

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

อุปกรณ์นี้หมุนมากเพียงใด (เฉพาะองศา)

{
  "rotationDegrees": 45
}

อุปกรณ์นี้หมุนมากเพียงใด (ต่อเนื่อง)

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

อุปกรณ์ COMMANDS

อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจตอบสนองต่อคําสั่งต่อไปนี้ในฐานะส่วนหนึ่งของการดําเนินการ EXECUTE หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ EXECUTE โปรดดูการดําเนินการ Intent

action.devices.commands.RotateAbsolute

ตั้งค่าการหมุนสัมบูรณ์ของอุปกรณ์

พารามิเตอร์

เพย์โหลดมีดังต่อไปนี้

ตั้งค่าการหมุนสัมบูรณ์เป็นองศา

พารามิเตอร์	ประเภท	คำอธิบาย
rotationDegrees	Number	ต้องระบุ ค่าสัมบูรณ์ในหน่วยองศาที่ระบุการหมุนอุปกรณ์ครั้งสุดท้ายตามเข็มนาฬิกา ค่าต้องอยู่ภายในแอตทริบิวต์ rotationDegreesRange

ตั้งค่าการหมุนสัมบูรณ์เป็นเปอร์เซ็นต์

พารามิเตอร์	ประเภท	คำอธิบาย
rotationPercent	Number	ต้องระบุ ค่าสัมบูรณ์เป็นเปอร์เซ็นต์ที่ระบุการหมุนครั้งล่าสุดของอุปกรณ์

ตัวอย่าง

เอียงอุปกรณ์ให้ได้ 50 เปอร์เซ็นต์

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

หมุนอุปกรณ์ทวนเข็มนาฬิกา 15 องศา (rotationDegrees: 45)

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

หมุนอุปกรณ์ตามเข็มนาฬิกา 100 องศา (supportsContinuousRotation: true, rotationDegrees: 270)

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

ข้อผิดพลาดที่เกี่ยวข้อง

เกิดข้อผิดพลาดในการตั้งค่าการหมุนอุปกรณ์

ค่าที่รองรับ

deviceJammingDetected

อุปกรณ์ ERRORS

ดูรายการข้อผิดพลาดและข้อยกเว้นทั้งหมด