สคีมาลักษณะการทำงาน ColorSetting ของสมาร์ทโฮม

action.devices.traits.ColorSetting - ลักษณะการทำงานนี้ใช้กับอุปกรณ์ เช่น หลอดไฟอัจฉริยะที่เปลี่ยนสีหรืออุณหภูมิสีได้

RGB, HSV และอุณหภูมิสี

RGB แสดงสีเป็น 3 ค่า (แดง เขียว น้ำเงิน) RGB เป็นรูปแบบสีเริ่มต้น คุณสามารถแสดง 3 ค่า RGB เป็นรหัสสีแบบเลขฐาน 16 ซึ่งเทียบเท่ากับค่าเลขฐาน 16 ของ 3 ค่าที่นำมาต่อกัน เช่น "สีน้ำเงิน" คือ (0, 0, 255) และ #0000FF คุณสามารถใช้ค่าใดก็ได้ภายในพื้นที่สี RGB นั่นคือ RGB(x, y, z) โดยที่ x, y, z อยู่ในช่วง [0, 255] รวมค่าปลายทั้งสองข้าง

HSV แสดงสีเป็น 3 ค่า (โทนสี ความอิ่มตัว ค่า) คุณสามารถแปลงค่าสีใน HSV เป็น RGB และในทางกลับกันได้ โทนสีมีช่วงตั้งแต่ [0, 360) องศา (ไม่รวม 360 เนื่องจากจะวนกลับไปที่ 0 องศา) ความอิ่มตัวและค่าจะแสดงเป็นเลขทศนิยมในช่วง [0.0, 1.0]

อุณหภูมิสี แสดง สีบางสี เป็นค่าทศนิยมที่ไม่เป็นลบในหน่วยเคลวิน แอตทริบิวต์นี้อธิบายไฟ "สีขาว" หรือ "สีโทนอุ่น" โดยใช้ชื่อสี เช่น "สีขาวโทนเย็น" หรือ "สีเดย์ไลท์โทนขมุกขมัว" โดยปกติแล้วหลอดไฟอัจฉริยะที่รองรับอุณหภูมิสีจะมีช่วงตั้งแต่ [2000, 9000] เคลวิน ซึ่งสอดคล้องกับหลอดไฟทั่วไปที่มีค่าเคลวินคงที่ อุณหภูมิสีเป็นสเกลเชิงเส้นและเป็นส่วนย่อยของรูปแบบสี RGB/HSV แบบเต็มสเปกตรัม ดูตัวอย่างอุณหภูมิและชื่อสีที่เกี่ยวข้องได้ใน ตารางด้านล่าง

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

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

ตัวอย่าง

อุปกรณ์ที่รองรับทั้งรูปแบบสีแบบสเปกตรัม RGB และอุณหภูมิสี

{
  "colorModel": "rgb",
  "colorTemperatureRange": {
    "temperatureMinK": 2000,
    "temperatureMaxK": 9000
  }
}

อุปกรณ์ที่รองรับเฉพาะรูปแบบสีแบบสเปกตรัม HSV

{
  "colorModel": "hsv"
}

อุปกรณ์ที่รองรับเฉพาะอุณหภูมิสี

{
  "colorTemperatureRange": {
    "temperatureMinK": 2000,
    "temperatureMaxK": 9000
  }
}

อุปกรณ์ที่รองรับเฉพาะคำสั่งรูปแบบสี HSV

{
  "colorModel": "hsv",
  "commandOnlyColorSetting": true
}

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

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

ตัวอย่าง

สีของแสงคืออะไร (ขาวอุ่น)

{
  "color": {
    "temperatureK": 3000
  }
}

สีของแสงคืออะไร (Magenta)

{
  "color": {
    "spectrumRgb": 16711935
  }
}

สีของแสงคืออะไร (Magenta)

{
  "color": {
    "spectrumHsv": {
      "hue": 300,
      "saturation": 1,
      "value": 1
    }
  }
}

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

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

action.devices.commands.ColorAbsolute

ตั้งค่าสีแบบสัมบูรณ์

พารามิเตอร์

ตัวอย่าง

เปลี่ยนสีไฟเป็นสีขาวโทนอุ่น

{
  "command": "action.devices.commands.ColorAbsolute",
  "params": {
    "color": {
      "name": "Warm White",
      "temperature": 3000
    }
  }
}

เปลี่ยนสีไฟเป็นสีม่วงแดง

{
  "command": "action.devices.commands.ColorAbsolute",
  "params": {
    "color": {
      "name": "Magenta",
      "spectrumRGB": 16711935
    }
  }
}

เปลี่ยนสีไฟเป็นสีม่วงแดง

{
  "command": "action.devices.commands.ColorAbsolute",
  "params": {
    "color": {
      "name": "Magenta",
      "spectrumHSV": {
        "hue": 300,
        "saturation": 1,
        "value": 1
      }
    }
  }
}

โปรดทราบว่าชื่อพารามิเตอร์จะแตกต่างกันเล็กน้อยระหว่างพารามิเตอร์คำสั่งและพารามิเตอร์สถานะ ซึ่งจะช่วยหลีกเลี่ยง การชนกันกับพารามิเตอร์สถานะสำหรับลักษณะการทำงาน ColorSpectrum และ ColorTemperature ที่เลิกใช้งานแล้ว

ตัวอย่างคำพูด

ข้อผิดพลาดของอุปกรณ์