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

สคีมาของฟีเจอร์ FanHome FanSpeed Trait

action.devices.traits.FanSpeed - ลักษณะนี้เป็นของอุปกรณ์ที่รองรับการตั้งค่าความเร็วของพัดลม

ความเร็วพัดลม (เช่น การเป่าลมจากอุปกรณ์ในระดับต่างๆ ซึ่งอาจเป็นส่วนหนึ่งของเครื่องปรับอากาศหรือเครื่องทําความร้อน หรือในรถ) อาจรวมถึงการตั้งค่า เช่น ต่ํา ปานกลาง และสูงหรือเปอร์เซ็นต์

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

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

แอตทริบิวต์ ประเภท คำอธิบาย
reversible บูลีน

(ค่าเริ่มต้น: false)

หากตั้งค่าเป็น "จริง" อุปกรณ์นี้รองรับการเป่าพัดลมในทั้ง 2 ทิศทาง และสามารถยอมรับคําสั่งเพื่อย้อนกลับทิศทางของพัดลมได้

commandOnlyFanSpeed บูลีน

(ค่าเริ่มต้น: false)

ระบุว่าอุปกรณ์รองรับการสื่อสารทางเดียว (จริง) หรือแบบ 2 ทาง (เท็จ) ตั้งค่าแอตทริบิวต์นี้เป็น "จริง" หากอุปกรณ์ตอบกลับ Intent ของ QUERY หรือสถานะรายงานสําหรับลักษณะนี้ไม่ได้

มีสิ่งใดสิ่งหนึ่งต่อไปนี้
0 วัตถุ

รองรับการตั้งค่าความเร็ว

availableFanSpeeds วัตถุ

ต้องระบุ

การตั้งค่าความเร็วที่อุปกรณ์รองรับ

speeds อาร์เรย์

ต้องระบุ

รายการการตั้งค่าความเร็ว

[item, ...] วัตถุ

การตั้งค่าความเร็ว

speed_name สตริง

ต้องระบุ

ชื่อภายในของการตั้งค่าความเร็ว อาจไม่เป็นมิตรต่อผู้ใช้ และจะแชร์กับทุกภาษา

speed_values อาร์เรย์

ต้องระบุ

คําพ้องความหมายสําหรับการตั้งค่าความเร็วแต่ละภาษาที่รองรับ

[item, ...] วัตถุ

คําพ้องความหมายสําหรับการตั้งค่าความเร็วในภาษาหนึ่งๆ

speed_synonym อาร์เรย์

ต้องระบุ

คําพ้องความหมายสําหรับการตั้งค่าความเร็วควรมีทั้งรูปเอกพจน์และพหูพจน์ (หากมี) คําพ้องความหมายแรกของรายการจะถือเป็นชื่อ Canonical ของการตั้งค่าความเร็ว

[item, ...] สตริง

คําพ้องความหมาย

lang สตริง

ต้องระบุ

รหัสภาษา (ISO 639-1) ดูภาษาที่รองรับ

ordered บูลีน

ต้องระบุ

หากตั้งค่าเป็น "จริง" ระบบจะใช้ไวยากรณ์เพิ่มเติมเพื่อเพิ่มหรือลดตรรกะ ตามลําดับอาร์เรย์ความเร็ว (เพิ่มขึ้น)

1 วัตถุ

รองรับเปอร์เซ็นต์ความเร็ว

supportsFanSpeedPercent บูลีน

ต้องระบุ

(ค่าเริ่มต้น: false)

หากตั้งค่าเป็น "จริง" อุปกรณ์นี้จะยอมรับคําสั่งให้ปรับความเร็วโดยใช้เปอร์เซ็นต์จาก 0.0 ถึง 100.0

ตัวอย่าง

อุปกรณ์ที่มีการตั้งค่าความเร็ว 2 ระดับ รองรับการปรับทิศทางแบบย้อนกลับและเปอร์เซ็นต์

{
  "availableFanSpeeds": {
    "speeds": [
      {
        "speed_name": "speed_low",
        "speed_values": [
          {
            "speed_synonym": [
              "Low",
              "Slow"
            ],
            "lang": "en"
          }
        ]
      },
      {
        "speed_name": "speed_high",
        "speed_values": [
          {
            "speed_synonym": [
              "High",
              "Fast"
            ],
            "lang": "en"
          }
        ]
      }
    ],
    "ordered": true
  },
  "reversible": true,
  "supportsFanSpeedPercent": true
}

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

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

รัฐ ประเภท คำอธิบาย
currentFanSpeedSetting สตริง

ชื่อนี้จะแสดงชื่อภายในของการตั้งค่าความเร็วปัจจุบันจากแอตทริบิวต์ availableFanSpeeds

currentFanSpeedPercent Number

ระบุความเร็วพัดลมปัจจุบันตามเปอร์เซ็นต์ ต้องระบุหากตั้งค่าแอตทริบิวต์ supportsFanSpeedPercent เป็น true

ตัวอย่าง

พัดลมในห้องนั่งเล่นมีความเร็วเท่าใด

{
  "currentFanSpeedSetting": "speed_low",
  "currentFanSpeedPercent": 10
}