ยินดีต้อนรับสู่ Google Home Developer Center แหล่งใหม่เรียนรู้วิธีพัฒนาการดําเนินการในบ้านอัจฉริยะ หมายเหตุ: คุณจะสร้างการดําเนินการต่างๆ ต่อไปในคอนโซลการดําเนินการ
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

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

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

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