Akıllı ev işlemlerinin nasıl geliştirileceğini öğrenmek için yeni adres olan Google Home Geliştirici Merkezi'ne hoş geldiniz. Not: Actions Console'da işlem oluşturmaya devam edersiniz.
Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Akıllı Ev ColorSettings Trait Ş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üsü olarak gösterir. RGB, varsayılan renk modelidir. Tüm RGB üçlüleri, birleştirilen üçlü örneğin onaltılık değerlerine eşdeğer olan bir on altılık kod olarak temsil edilebilir. Örneğin, "mavi" (0, 0, 255) ve #0000FF'dir. RGB renk alanında herhangi bir değeri kullanabilirsiniz; diğer bir deyişle, RGB(x, y, z) kullanılabilir. Burada x, y, z, [0, 255] aralığındadır (bu değerler dahil).

HSV, renkleri bir ton, doygunluk, değer üçlüsü olarak temsil eder. HSV'deki tüm renk değerleri RGB'ye (veya tersi) dönüştürülebilir. Tonu [0, 360] derece aralığındadır (yaklaşık 0 dereceye denk geldiği için 360 hariç). Doygunluk ve değer [0.0, 1.0] aralığındaki kayan sayılar ile gösterilir.

Renk sıcaklığı, Kelvin cinsinden bazı renkleri negatif olmayan ondalık değerler olarak gösterir. Bu özellik, "soğuk beyaz" veya "anlatımlı 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 değerine sahiptir ve sabit Kelvin özelliği olan 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 ilgili 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 Kapalı
9000Mavi Gökyüzü

Cihaz ÖZELLİKLERİ

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

Özellikler Tür Açıklama
commandOnlyColorSetting Boole

(Varsayılan: false)

Cihazın tek yönlü (true) veya iki yönlü (false) iletişimin kullanılmasını destekleyip desteklemediğini belirtir. Cihaz, bu özellik için bir QUERY amacına veya rapor durumuna yanıt vermiyorsa bu özelliği "true" 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'de 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 durumu

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

Eyaletler Tür Açıklama
color Nesne

Zorunludur.

Cihazda kullanılmakta olan mevcut renk ayarı.

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

Renk sıcaklığı desteği.

temperatureK Integer

Zorunludur.

Kelvin cinsinden sıcaklık.

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şık ne kadar? (Sıcak Beyaz)

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

Işık ne kadar? (Magenta)

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

Işık ne kadar? (Magenta)

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

Cihaz FTC'leri

Bu özelliğe sahip cihazlar, EXECUTE işleminin bir parçası olarak aşağıdaki komutlara yanıt verebilir. EXECUTE niyetlerini 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 Tür Açıklama
color Nesne

Zorunludur.

Ayarlanacak renk.

name Dize

Kullanıcının komutundan ayrıştırılan renk adı; her zaman kullanılamayabilir (yani 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.

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şıkyı sıcak beyaz yapın.

{
  "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, 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 sözler

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.