歡迎使用 Google Home 開發人員中心,探索全新功能,瞭解如何開發智慧住宅動作。注意:請繼續在「動作」控制台中建立動作。
透過集合功能整理內容 你可以依據偏好儲存及分類內容。

智慧型住宅亮度特性結構定義

action.devices.traits.Brightness - 此屬性涵蓋如何控制裝置的亮度。

裝置屬性

具有此特性的裝置可能會在 SYNC 作業中回報下列屬性。如要進一步瞭解如何處理 SYNC 意圖,請參閱意圖執行要求一文。

屬性 類型 說明
commandOnlyBrightness 布林

(預設:false)

指出裝置是否支援單向 (true) 或雙向 (false) 通訊。如果裝置無法回應此特徵的 QUERY 意圖或報告狀態,請將此屬性設為 true。

範例

支援亮度指令、狀態查詢和回報的裝置。

{}

僅支援亮度指令的裝置。

{
  "commandOnlyBrightness": true
}

裝置狀態:STATE

具有此特性的裝置可能會在 QUERY 作業中回報下列狀態。如要進一步瞭解如何處理 QUERY 意圖,請參閱意圖執行要求一文。

類型 說明
brightness 整數

裝置目前的亮度等級。

範例

我的燈光亮度為何?

{
  "brightness": 65
}

裝置指令

具有此特性的裝置可能會在 EXECUTE 作業中回應下列指令。如要進一步瞭解如何處理 EXECUTE 意圖,請參閱意圖執行要求一文。

action.devices.commands.BrightnessAbsolute

調整裝置的絕對亮度。

參數

參數 類型 說明
brightness 整數

必填。

新的絕對亮度百分比。

範例

將亮度調整為 65% 的亮度。

{
  "command": "action.devices.commands.BrightnessAbsolute",
  "params": {
    "brightness": 65
  }
}

action.devices.commands.BrightnessRelative

調整裝置的相對亮度。

這個指令需要下列屬性:
{
  "commandOnlyBrightness": true
}

參數

酬載包含下列其中一個值:

相對調整項百分比。

參數 類型 說明
brightnessRelativePercent 整數

必填。

要調整的確切亮度百分比。

權重相對調整。

參數 類型 說明
brightnessRelativeWeight 整數

必填。

這代表亮度變化的模稜兩可。從小量到大量,此參數會縮放為整數 0 到 5,其中符號表示方向。

範例

將我的燈光調亮 20%。

{
  "command": "action.devices.commands.BrightnessRelative",
  "params": {
    "brightnessRelativePercent": 20
  }
}

調暗燈光。

{
  "command": "action.devices.commands.BrightnessRelative",
  "params": {
    "brightnessRelativeWeight": -1
  }
}

話語範例

de-DE

  • Bitte mach das Licht ein bisschen dunkler
  • Bitte stell das Flurlicht auf ein Drittel
  • Die Küche ein wenig heller stellen
  • Erhöhe die Helligkeit
  • Erhöhe die Helligkeit um 20%
  • Helligkeit der Leselampe auf 5 %
  • Helligkeit im Wohnzimmer auf 10% stellen
  • Mach das Licht bitte 20 % dunkler
  • Mach das Licht bitte 20 % heller
  • Mach das Licht sehr hell
  • Mach das Schlafzimmer ein bisschen dunkler
  • Mach das Wohnzimmer dunkler
  • Stell das Licht auf 50 % ein.
  • Stelle das Licht bitte auf maximale Helligkeit
  • Stelle die Beleuchtung heller
  • Verringere die Helligkeit der Beleuchtung
  • Verringere die Helligkeit in der Küche um 20%

en-US

  • brighten light at 10%
  • brighten lights by 20%
  • brighten the kitchen slightly
  • brighten the kitchen to 50
  • brighten the lights up
  • dim down the lights
  • dim lights a little more
  • dim lights by 20%
  • increase brightness in living room by 100%
  • make it darker in the living room
  • make the bedroom brighter
  • make the lights a little bit brighter
  • make the living room a little bit dimmer
  • reduce brightness in the living room by 50%
  • set the light to maximum
  • turn brightness on light to maximum

es-ES

  • pon las luces a la mitad

fr-FR

  • Mets la lumière sur 20 % .
  • Règle la luminosité du salon au maximum .
  • allume la lampe à 20 % de luminosité
  • allume la lumière du salon au maximum
  • assombris la cuisine de 20 %
  • augmente l'éclairage de 20 %
  • augmente l'éclairage de la cuisine
  • augmente la luminosité de 10 % dans le salon
  • augmente la luminosité de la chambre
  • augmente un peu l'éclairage
  • augmente un peu la luminosité de la chambre
  • baisse les lumières
  • baisse les lumières de 20 %
  • baisse un peu la lumière du salon
  • luminosité de la chambre à 20 %
  • moins de luminosité dans le salon

hi-IN

  • 20% अँधेरा हॉल में
  • 65% किचन में अँधेरा कर दो
  • किचन की रोशनी थोड़ी कम करिए
  • किचन की रोशनी बढ़ाना
  • किचन में 20% उजाला बढ़ा दो
  • बाथरूम में उजाला घटा दो
  • बाथरूम में थोड़ा अँधेरा कर दोगे
  • बेडरूम को प्रकाशमान करो
  • बेडरूम में खूब रोशनी करिए
  • मुझे स्टडी लैंप की ब्राइटनेस इसकी आधी चाहिए
  • रोशनी मिनिमम पर सेट कर दो
  • रोशनी घटाओ 20% किचन की
  • रोशनी बढ़ाना हल्की सी
  • लाइट 20% कम कर दो
  • लाइट 20% पर कर दो
  • लाइट को 5% ब्राइट करो
  • लाइट डिम करो

it-IT

  • Alza del 30% le luci per favore
  • abbassa le luci del 30%
  • fai più buio in cucina
  • illumina 50% cucina
  • illumina il salotto un po'
  • illumina la cucina a 50
  • imposta la luminosità delle luci al 20%
  • imposta le luci sul minimo
  • metti la luce più forte
  • metti le luci al 40%
  • metti le luci alla luminosità minima
  • oscura leggermente il salotto
  • puoi abbassare un po' la luce
  • rischiara il salotto
  • scurisci il bagno del 20%
  • voglio abbassare le luci

ja-JP

  • キッチン の明るさを 50% に上げて
  • キッチン の明るさを もう少し 落として下さい
  • キッチン もう少し 明るくして
  • キッチン を明るくして
  • デスクの照明 最大限 にして
  • ライト の明るさを 少し 上げて
  • 台所 20% 明るくしてほしい
  • 子供部屋 を暗くして下さい
  • 寝室の照明 の明るさをあげて
  • 寝室 10% 暗くしてください
  • 照明 の明るさを下げて
  • 照明 の明るさを 5% 下げて
  • 照明 20% 明るくしてください
  • 照明 50% まで明るくして
  • 照明 少し 暗くして下さい

ko-KR

  • 거실 조금만 더 어둡게 해 줘
  • 공부방 밝기 40% 로 설정 해 줘
  • 욕실 더 밝게 해
  • 조명 5% 더 올려 줘
  • 조명 낮춰 줘
  • 조명 더 밝게 켜 줘
  • 조명 밝기 30% 로 바꿔 줘
  • 조명 조금만 더 밝게
  • 조명 최대 로 설정
  • 조명 10% 로 해줘
  • 조명 최대 밝기로 설정해볼래
  • 주방 을 좀 어둡게 해줘
  • 침실 등 밝기를 약간 더 낮춰줘
  • 침실 밝기를 20% 줄여 줘
  • 침실 밝기를 조금만 더 높여봐
  • 침실 20프로 더 밝게 해줘
  • 현관 조명 10% 낮춰줘

nl-NL

  • dim de lampen
  • dim de lampen een beetje
  • laat de lampen branden op 30%
  • laat de lampen zo fel mogelijk branden
  • maak de keuken wat helderder
  • maak de slaapkamer lichter
  • maak de woonkamer 10% lichter
  • maak het licht feller
  • maak het licht wat feller
  • stel de lamp in op het minimum
  • verlicht de woonkamer met 10%

pt-BR

  • Aumentar a luz do quarto em 10% .
  • abaixe um pouco a luz
  • ajustar luz do quarto em 20%
  • alterar luminosidade do quarto para o máximo
  • aumentar um pouco a luz do quarto
  • clarear a cozinha nos 20%
  • clarear a sala em 10%
  • colocar a luz de leitura no máximo
  • colocar a luz em 10%
  • deixar a sala mais clara
  • deixe as luzes mais brilhantes
  • diminua a claridade da sala
  • diminuir a luz em 10%
  • escurecer um pouco a cozinha
  • ilumina um pouco a sala de estar
  • quero a sala 25% mais escura
  • reduzir a luz do quarto

sv-SE

  • dimma 20% i köket
  • dimma ljuset med 20%
  • dimma ned ljuset i hallen
  • dimma ner sovrummet till 10 %
  • gör det ljusare i hallen
  • gör det mycket mörkare i köket
  • gör det mörkare i badrummet
  • gör köket mycket ljusare
  • höj ljuset på lampan
  • höj ljuset på lamporna lite
  • höj ljuset på lamporna med 20 %
  • justera ljuset på lampan till 10 %
  • justera ljusstyrkan på lampan halvvägs
  • sänk ljuset på lamporna lite
  • sätt ljuset minsta värdet

裝置錯誤:ERRORS

請參閱錯誤和例外狀況的完整清單。