# Smart Home Brightness Trait Schema

`action.devices.traits.Brightness` - This trait covers how to control the brightness of a device.

> [!NOTE]
> **Note:** Devices implementing the [`Brightness`](https://developers.home.google.com/cloud-to-cloud/traits/brightness) trait now support emulated "sleep" and "wake" effect. To learn more, see [Light effects emulation](https://developers.home.google.com/cloud-to-cloud/traits/lighteffects#emulation).

## Device ATTRIBUTES

Devices with this trait may report the following
attributes as part of the [`SYNC`](https://developers.home.google.com/cloud-to-cloud/intents/sync) operation. To learn
more about handling `SYNC` intents, see
[Intent fulfillment](https://developers.home.google.com/cloud-to-cloud/integration/sync).

| Attributes | Type | Description |
|---|---|---|
| `commandOnlyBrightness` | *Boolean* | (Default: `false`) Indicates if the device supports using one-way (true) or two-way (false) communication. Set this attribute to true if the device cannot respond to a QUERY intent or Report State for this trait. |

#### Examples

*Device that supports for brightness commands, states query and reporting.*

```
{}
```

*Device that only support for brightness commands.*

```
{
  "commandOnlyBrightness": true
}
```

## Device STATES

Entities with this trait may report the following
states as part of the [`QUERY`](https://developers.home.google.com/cloud-to-cloud/intents/query) operation. To learn
more about handling `QUERY` intents, see
[Intent fulfillment](https://developers.home.google.com/cloud-to-cloud/integration/query-execute).

| States | Type | Description |
|---|---|---|
| `brightness` | *Integer* | Current brightness level of the device. Value must be between `0` and `100`. |

#### Examples

*What is the brightness level of my light?*

```
{
  "brightness": 65
}
```

## Device COMMANDS

Devices with this trait may respond to the following
commands as part of the [`EXECUTE`](https://developers.home.google.com/cloud-to-cloud/intents/execute) operation. To learn
more about handling `EXECUTE` intents, see
[Intent fulfillment](https://developers.home.google.com/cloud-to-cloud/integration/query-execute#handle_execute_intents).

### `action.devices.commands.BrightnessAbsolute`

Adjust device absolute brightness.

#### Parameters

| Parameters | Type | Description |
|---|---|---|
| `brightness` | *Integer* | **Required.** New absolute brightness percentage. Value must be between `0` and `100`. |

#### Examples

*Adjust my light to 65% brightness.*

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

### `action.devices.commands.BrightnessRelative`

Adjust device relative brightness.
This command requires the following attributes:

```
{
  "commandOnlyBrightness": true
}
```

#### Parameters

The payload contains one of the following:

#### Percentage relative adjustment.

| Parameters | Type | Description |
|---|---|---|
| `brightnessRelativePercent` | *Integer* | **Required.** The exact percentage of brightness to change. Value must be between `0` and `100`. |

#### Weight relative adjustment.

| Parameters | Type | Description |
|---|---|---|
| `brightnessRelativeWeight` | *Integer* | **Required.** This indicates the ambiguous amount of the brightness change. From small amount to large amount, this param will be scaled to integer 0 to 5, with the sign to indicate direction. Value must be between `-5` and `5`. |

#### Examples

*Brighten my light by 20%.*

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

*Dim my light a little.*

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

## Sample utterances

> [!NOTE]
> This is a sample of the utterances supported by this device trait, make sure to also review other [supported languages](https://developers.home.google.com/cloud-to-cloud/traits#supported-languages).

### 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%*
- Wie hell ist *das Badlicht* ?

### 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%*
- how bright are *my lights*
- 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*
- quelle est l'intensité de *la lumière*

### 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*
- qual è la luminosità *in bagno* ?
- rischiara il salotto
- scurisci il bagno del *20%*
- voglio abbassare *le luci*

### ja-JP

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

### ko-KR

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

### nl-NL

- dim *de lampen*
- dim *de lampen* *een beetje*
- hoe helder is *de verlichting* ?
- 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*
- mostrar o nível de brilho da *luz da cozinha*
- 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
- hur ljust lyser *lampan i köket* ?
- 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* på *minsta värdet*

## Device ERRORS

See the full list of [errors and exceptions](https://developers.home.google.com/cloud-to-cloud/intents/errors-exceptions).