Akıllı ev işlemlerinin nasıl geliştirileceğini öğrenebileceğiniz yeni adres olan Google Home Geliştirici Merkezi'ne hoş geldiniz. Not: Actions Console'da işlem derlemeye devam edersiniz.

Bu sayfa, Cloud Translation API ile çevrilmiştir.

Akıllı Ev Renk Ayarı Özellik Şeması

action.devices.traits.ColorSetting: Bu özellik, renk veya renk sıcaklığını değiştirebilen akıllı ışıklar gibi cihazlar için geçerlidir.

RGB, HSV ve renk sıcaklığı

RGB, renkleri (kırmızı, yeşil, mavi) bir üçlü olarak temsil eder. RGB, varsayılan renk modelidir. Herhangi bir RGB üçlü kodu, birleştirilmiş üçlüün on altılı değerlerine eşdeğer bir onaltılık kod olarak temsil edilebilir. Örneğin, "mavi" (0, 0, 255) ve #0000FF'dir. RGB renk alanı içindeki herhangi bir değeri kullanabilirsiniz. Diğer bir deyişle, RGB(x; y; z); burada x, y, z [0, 255] aralığındadır (bu değerler dahil).

HSV, renkleri (ton, doygunluk, değer) üçlü kodu olarak temsil eder. HSV'deki herhangi bir renk değeri RGB'ye ve bunun tersi de yapılabilir. Ton [0, 360) derece aralığındadır (0 dereceye kadar sarmalandığı için 360 derece hariç). Doygunluk ve değer, [0,0, 1,0] aralığındaki kayan noktalı öğelerle temsil edilir.

Renk sıcaklığı, bazı renkleri Kelvin cinsinden negatif olmayan ondalık değerler olarak temsil eder. Bu özellik, "soğuk beyaz" veya "bulutsuz gün ışığı" gibi renk adlarıyla "beyaz" veya "sıcak" ışıkları tanımlar. Renk sıcaklığını destekleyen akıllı ışıklar genellikle [2000, 9000] Kelvin aralığındadır. Bu değer, sabit Kelvin'e sahip geleneksel ışıklara karşılık gelir. Renk sıcaklığı, RGB/HSV tam spektrumlu renk modellerinin bir alt kümesi olan doğrusal bir ölçektir. Bazı örnek sıcaklıkları ve bunlara karşılık gelen renk adlarını aşağıdaki tabloda görebilirsiniz.

Sıcaklık (Kelvin)	Renk Adı
2.000	Mum Işığı
2500	Ultra Sıcak Beyaz
3.000	Yumuşak Beyaz, Sabah Beyazı, Okuma Beyazı
4.000	Soğuk Beyaz
5.000	Gün Işığı, Beyaz
6.000	Çiçek Beyazı
7000	Bulutlu Gün Işığı, Beyaz Duman
8000	Mavi Bulutlu
9000	Mavi Gökyüzü

Cihaz ATTRIBUTES

Bu özelliğe sahip cihazlar, SYNC işleminin bir parçası olarak aşağıdaki özellikleri bildirebilir. SYNC amaçlarını işleme hakkında daha fazla bilgi edinmek için Amaç karşılama bölümüne bakın.

Özellikler	Type	Açıklama
`commandOnlyColorSetting`	Boole	(Varsayılan: `false`) Cihazın tek yönlü (doğru) veya iki yönlü (yanlış) iletişimin kullanılmasını destekleyip desteklemediğini gösterir. Cihaz bu özellik için bir QUERY amacına veya Rapor Durumuna yanıt veremiyorsa bu özelliği true olarak ayarlayın.
Aşağıdaki öğelerin herhangi birini içerir:
`0`	Nesne	Renk modeli desteği.
`colorModel`	String	Zorunludur. Cihaz tarafından desteklenen tam spektrum renk modeli. Desteklenen değerler: `rgb` `hsv`
`1`	Nesne	Renk sıcaklığı desteği.
`colorTemperatureRange`	Nesne	Zorunludur. Kelvin cinsinden desteklenen renk sıcaklığı aralığı.
`temperatureMinK`	Integer	Zorunludur. Kelvin cinsinden desteklenen minimum renk sıcaklığı.
`temperatureMaxK`	Integer	Zorunludur. Kelvin cinsinden desteklenen maksimum renk sıcaklığı.

Örnekler

Hem RGB spektrum renk modelini hem de renk sıcaklığını destekleyen cihaz.

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

Yalnızca HSV spektrum renk modelini destekleyen cihaz.

{
  "colorModel": "hsv"
}

Yalnızca renk sıcaklığını destekleyen cihaz.

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

Yalnızca HSV renk modeli komutlarını destekleyen cihaz.

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

Cihaz STATES

Bu özelliğe sahip varlıklar, QUERY işleminin bir parçası olarak aşağıdaki durumları bildirebilir. QUERY amaçlarını işleme hakkında daha fazla bilgi edinmek için Amaç karşılama bölümüne bakın.

Eyaletler	Type	Açıklama
`color`	Nesne	Zorunludur. Cihazda kullanılmakta olan geçerli renk ayarı.
Aşağıdaki öğelerden birini içerir:
`0`	Nesne	Renk sıcaklığı desteği.
`temperatureK`	Integer	Zorunludur. Kelvin cinsinden sıcaklık değeri.
`1`	Nesne	Renk RGB spektrum desteği.
`spectrumRgb`	Integer	Zorunludur. Ondalık tam sayı olarak spektrum RGB değeri.
`2`	Nesne	Renkli HSV spektrum desteği.
`spectrumHsv`	Nesne	Zorunludur. Spektrum HSV değeri.
`hue`	Number	Ton.
`saturation`	Number	Doygunluk.
`value`	Number	Değer.

Örnekler

Işığın rengi nedir? (Sıcak Beyaz)

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

Işığın rengi nedir? (Eflatun)

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

Işığın rengi nedir? (Eflatun)

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

Not: ColorSetting özelliği için Rapor Durumu'nu kullanırken RGB durumunu spectrumRGB ve HSV durumunu spectrumHsv olarak belirttiğinizden emin olun. (Eyalet adlarında büyük-küçük harf kullanımına dikkat etmeniz gerekir.)

Cihaz COMMANDS

Bu özelliğe sahip cihazlar, EXECUTE işleminin bir parçası olarak aşağıdaki komutlara yanıt verebilir. EXECUTE amaçlarını işleme hakkında daha fazla bilgi edinmek için Amaç karşılama bölümüne bakın.

`action.devices.commands.ColorAbsolute`

Mutlak renk değerini ayarlayın.

Parametreler

Parametreler	Type	Açıklama
`color`	Nesne	Zorunludur. Ayarlanacak renk.
`name`	String	Kullanıcının komutundan ayrıştırılan renk adı; her zaman kullanılamayabilir (ör. göreli komutlar kullanılırken).
Aşağıdaki öğelerden birini içerir:
`0`	Nesne	Renk sıcaklığı desteği.
`temperature`	Integer	Zorunludur. Kelvin cinsinden sıcaklık değeri. Ayrıntılar için RGB, HSV ve renk sıcaklığı konusuna bakın.
`1`	Nesne	Renk RGB spektrum desteği.
`spectrumRGB`	Integer	Zorunludur. Ondalık tam sayı olarak spektrum RGB değeri. Ayrıntılar için RGB, HSV ve renk sıcaklığı konusuna bakın.
`2`	Nesne	Renkli HSV spektrum desteği.
`spectrumHSV`	Nesne	Zorunludur. Spektrum HSV değeri. Ayrıntılar için RGB, HSV ve renk sıcaklığı konusuna bakın.
`hue`	Number	Ton.
`saturation`	Number	Doygunluk.
`value`	Number	Değer.

Örnekler

Işığı sıcak beyaz yap.

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

Işığı macenta yap.

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

Işığı macenta yap.

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

Komut ve durum parametreleri arasında parametre adlarının biraz farklı olduğuna dikkat edin. Bu, kullanımdan kaldırılan ColorSpectrum ve ColorTemperature özelliklerinin durum parametreleriyle çakışmaları önler.

Komut	Eyalet
`temperature`	`temperatureK`
`spectrumRGB`	`spectrumRgb`
`spectrumHSV`	`spectrumHsv`

Örnek ifadeler

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 på 2000 Kelvin
tänd blått ljus i köket

Cihaz ERRORS

Hataların ve istisnaların tam listesine bakın.