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

โครงสร้างลักษณะบ้านอัจฉริยะ

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

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

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

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

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

อุณหภูมิ (เคลวิน) ชื่อสี
2,000แสงเทียน
2500ขาวอบอุ่นพิเศษ
3,000สีขาวนวล สีขาวเช้า สีขาวการอ่าน
4,000คูลไวท์
5000แสงกลางวัน สีขาว
6000ดอกไม้สีขาว
7000เมฆหนา สีขาว มีควันสีขาว
8000ฟ้าครึ้ม
9000ฟ้าท้องฟ้า

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

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

แอตทริบิวต์ Type คำอธิบาย
commandOnlyColorSetting บูลีน

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

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

ประกอบด้วยรายการต่อไปนี้
0 ออบเจ็กต์

การสนับสนุนโมเดลสี

colorModel สตริง

ต้องระบุ

อุปกรณ์รุ่นสีสเปกตรัมทั้งหมดสนับสนุน

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

rgb
hsv
1 ออบเจ็กต์

รองรับอุณหภูมิสี

colorTemperatureRange ออบเจ็กต์

ต้องระบุ

ช่วงอุณหภูมิสีที่รองรับในหน่วยเคลวิน

temperatureMinK จำนวนเต็ม

ต้องระบุ

อุณหภูมิสีต่ําสุดในหน่วยเคลวิน

temperatureMaxK จำนวนเต็ม

ต้องระบุ

อุณหภูมิสีสูงสุดในหน่วยเคลวิน

ตัวอย่าง

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

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

อุปกรณ์ที่รองรับรูปแบบสีสเปคตรัม HSV เท่านั้น

{
  "colorModel": "hsv"
}

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

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

อุปกรณ์ที่รองรับเฉพาะคําสั่งโมเดลสี HSV เท่านั้น

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

อุปกรณ์ STATES

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

รัฐ Type คำอธิบาย
color ออบเจ็กต์

ต้องระบุ

การตั้งค่าสีที่ใช้อยู่ในปัจจุบันในอุปกรณ์

ประกอบด้วยรายการต่อไปนี้
0 ออบเจ็กต์

รองรับอุณหภูมิสี

temperatureK จำนวนเต็ม

ต้องระบุ

ค่าอุณหภูมิในหน่วยเคลวิน

1 ออบเจ็กต์

รองรับสีสเปคตรัม RGB

spectrumRgb จำนวนเต็ม

ต้องระบุ

ค่า RGB ของสเปกตรัมเป็นจํานวนเต็มทศนิยม

2 ออบเจ็กต์

รองรับสีสเปคตรัม HSV

spectrumHsv ออบเจ็กต์

ต้องระบุ

ค่า Spectrum HSV

hue Number

เดี๋ยวก่อนนะ

saturation Number

ความอิ่มตัว

value Number

ค่า

ตัวอย่าง

สีของหลอดไฟคืออะไร (สีอบอุ่น)

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

สีของหลอดไฟคืออะไร (สีม่วงแดง)

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

สีของหลอดไฟคืออะไร (สีม่วงแดง)

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

อุปกรณ์ COMMANDS

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

action.devices.commands.ColorAbsolute

กําหนดค่าสีสัมบูรณ์

พารามิเตอร์

พารามิเตอร์ Type คำอธิบาย
color ออบเจ็กต์

ต้องระบุ

สีที่จะกําหนด

name สตริง

ชื่อสีที่แยกวิเคราะห์จากคําสั่งของผู้ใช้ อาจไม่พร้อมใช้งานเสมอไป (เช่น เมื่อใช้คําสั่งสัมพัทธ์)

ประกอบด้วยรายการต่อไปนี้
0 ออบเจ็กต์

รองรับอุณหภูมิสี

temperature จำนวนเต็ม

ต้องระบุ

ค่าอุณหภูมิในหน่วยเคลวิน โปรดดูรายละเอียดใน RGB, HSV และอุณหภูมิสี

1 ออบเจ็กต์

รองรับสีสเปคตรัม RGB

spectrumRGB จำนวนเต็ม

ต้องระบุ

ค่า RGB ของสเปกตรัมเป็นจํานวนเต็มทศนิยม โปรดดูรายละเอียดใน RGB, HSV และอุณหภูมิสี

2 ออบเจ็กต์

รองรับสีสเปคตรัม HSV

spectrumHSV ออบเจ็กต์

ต้องระบุ

ค่า Spectrum HSV โปรดดูรายละเอียดใน RGB, HSV และอุณหภูมิสี

hue Number

เดี๋ยวก่อนนะ

saturation Number

ความอิ่มตัว

value Number

ค่า

ตัวอย่าง

ทําให้ไฟเป็นสีขาวโทนอุ่น

{
  "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 ที่เลิกใช้งานแล้ว

คำสั่ง รัฐ
temperature temperatureK
spectrumRGB spectrumRgb
spectrumHSV spectrumHsv

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

de-DE

  • Stell die Farbe der Lampe auf blau
  • Stelle die Farbtemperatur auf 3000 Kelvin ein.

en-US

  • can you adjust my lights color to 4000 kelvins
  • set the lights to blue

es-ES

  • pon azul la luz de la cocina
  • pon la luz a 2000 k de temperatura de color

fr-FR

  • Allume la lampe de la chambre à 3500 kelvins .
  • mets les lampes en rose dans la chambre

hi-IN

  • तुम लाइट को ब्लू कर दो
  • लैम्प 2000 केल्विन पर लगाओ।

it-IT

  • Imposta la lampada a 2000 K .
  • metti la luce gialla

ja-JP

  • 照明 の色を にして
  • 照明 の色温度を 5000K にセットして

ko-KR

  • 조명 색깔 흰색 으로 바꿔 줘
  • 주방 전등 색 온도를 5000 켈빈 으로 설정해

nl-NL

  • Zet de keukenlamp op 2000 Kelvin .
  • maak het licht rood

pt-BR

  • Colocar a lâmpada em 2000 K .
  • Define a lâmpada para 2000 K .
  • colocar a luz da sala em azul
  • põe a luz da sala a vermelho

sv-SE

  • Ställ in lampan 2000 Kelvin
  • tänd blått ljus i köket

อุปกรณ์ ERRORS

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