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

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

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

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

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

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

ตัวอย่าง

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

{
  "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
}

สถานะอุปกรณ์

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

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

ตัวอย่าง

อุปกรณ์หมุนอยู่เท่าไร (เปอร์เซ็นต์และองศา)

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

อุปกรณ์หมุนอยู่เท่าไร (เฉพาะองศา)

{
  "rotationDegrees": 45
}

อุปกรณ์หมุนอยู่เท่าไร (ต่อเนื่อง)

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

คําสั่งของอุปกรณ์

อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจตอบสนองต่อคําสั่งต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ 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

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