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.

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

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

RGB, HSV ve renk sıcaklığı

RGB, renkleri (kırmızı, yeşil, mavi) üçlü olarak gösterir. RGB, varsayılan renk modelidir. Herhangi bir RGB üçlüsü, birleştirilen üçlü değeri için onaltılık değerlere eşdeğer bir onaltılık kod olarak temsil edilebilir. Örneğin, "mavi" (0, 0, 255) ve #0000FF'tir. RGB renk alanı içinde herhangi bir değeri kullanabilirsiniz (ör. RGB(x, y, z). Burada x, y, z, [0, 255] aralığındadır (dahil).

HSV, renkleri bir ton, doygunluk, değer üçlüsü olarak temsil eder. HSV'deki tüm renk değerleri RGB'ye dönüştürülür ve bunun tersi de geçerlidir. Ton [0, 360] derece aralığındadır (yaklaşık 0 dereceye yuvarlandığı için 360 hariç). Doygunluk ve değer [0.0, 1.0] aralığındaki kayan öğelerle temsil edilir.

Renk sıcaklığı, bazı renkleri Kelvin cinsinden negatif olmayan ondalık değerler olarak gösterir. Bu özellik, "soğuk beyaz" veya "üstü kapalı gün ışığı" gibi renk adlarıyla "beyaz" veya "ılık" ışıkları tanımlar. Renk sıcaklığını destekleyen akıllı ışıklar genellikle [2000, 9000] Kelvin aralığına sahiptir ve sabit Kelvin kullanılan geleneksel ışıklara karşılık gelir. Renk sıcaklığı doğrusal bir ölçek ve RGB/HSV tam spektrumlu renk modellerinin bir alt kümesidir. Bazı örnek sıcaklıklar ve karşılık gelen renk adları için aşağıdaki tabloya bakın.

Sıcaklık (Kelvin) Renk Adı
2.000Mum Işığı
2500Ultra Sıcak Beyaz
3.000Yumuşak Beyaz, Sabah Beyazı, Okuma Beyazı
4.000Soğuk Beyaz
5.000Gün Işığı, Beyaz
6.000Çiçek Beyazı
7000Bulutlu Gün Işığı, Beyaz Duman
8000Mavi Bulutlu
9000Mavi 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 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şimi destekleyip desteklemediğini belirtir. Cihaz, bu özellik için bir QUERY amacına veya Rapor Durumuna yanıt veremezse bu özelliği doğru olarak ayarlayın.

Aşağıdaki öğelerden herhangi birini içerir:
0 Nesne

Renk modeli desteği.

colorModel Dize

Zorunludur.

Cihaz tarafından desteklenen tam spektrumlu 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 spektrumlu 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 STATUS

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

Eyaletler Type Açıklama
color Nesne

Zorunludur.

Cihazda şu anda kullanılan 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 spektrumu desteği.

spectrumRgb Integer

Zorunludur.

RGB değerini ondalık sayı olarak seçin.

2 Nesne

Renkli HSV spektrum desteği.

spectrumHsv Nesne

Zorunludur.

Spectrum HSV değeri.

hue Number

Ton.

saturation Number

Doygunluk.

value Number

Değer.

Örnekler

Işık ne? (Sıcak Beyaz)

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

Işık ne? (Eflatun)

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

Işık ne? (Eflatun)

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

Cihaz Komisyonları

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 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 Dize

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ığı başlıklı makaleye bakın.

1 Nesne

Renk RGB spektrumu desteği.

spectrumRGB Integer

Zorunludur.

RGB değerini ondalık sayı olarak seçin. Ayrıntılar için RGB, HSV ve renk sıcaklığı başlıklı makaleye bakın.

2 Nesne

Renkli HSV spektrum desteği.

spectrumHSV Nesne

Zorunludur.

Spectrum HSV değeri. Ayrıntılar için RGB, HSV ve renk sıcaklığı başlıklı makaleye bakın.

hue Number

Ton.

saturation Number

Doygunluk.

value Number

Değer.

Örnekler

Işıkları beyaz sıcak yap.

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

Açık eflatun yapın.

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

Açık eflatun yapın.

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

Parametre adlarının komut ve durum parametreleri arasında biraz farklı olduğunu unutmayın. Bu durum, kullanımdan kaldırılan ColorSpectrum ve ColorTemperature özellikleri için 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 2000 Kelvin
  • tänd blått ljus i köket

Cihaz HATALARI

Hataların ve istisnaların tam listesini inceleyin.