# ColorControlTrait.MoveToSaturationCommand.Request

# ColorControlTrait.MoveToSaturationCommand.Request


```
class ColorControlTrait.MoveToSaturationCommand.Request : ClusterStruct
```

<br />

*** ** * ** ***

The request payload for the MoveToSaturation command.

## Summary

| ### Nested types |
|---|
| `@https://developers.home.google.com/reference/kotlin/com/google/home/annotation/HomeExperimentalGenericApi enum https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/ColorControlTrait.MoveToSaturationCommand.Request.CommandFields : https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-enum/index.html, https://developers.home.google.com/reference/kotlin/com/google/home/Field` Descriptor enum for this command's request fields. |

| ### Public constructors |
|---|
| `https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/ColorControlTrait.MoveToSaturationCommand.Request#Request(kotlin.UByte,kotlin.UShort,com.google.home.matter.standard.ColorControlTrait.OptionsBitmap,com.google.home.matter.standard.ColorControlTrait.OptionsBitmap)( saturation: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-u-byte/index.html, transitionTime: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-u-short/index.html, optionsMask: https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/ColorControlTrait.OptionsBitmap, optionsOverride: https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/ColorControlTrait.OptionsBitmap )` Creates a request payload for the MoveToSaturation command. |

| ### Public functions |
|---|---|
| `open https://developers.home.google.com/reference/kotlin/com/google/home/StructDescriptor` | `@https://developers.home.google.com/reference/kotlin/com/google/home/annotation/HomeExperimentalGenericApi https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/ColorControlTrait.MoveToSaturationCommand.Request#getDescriptor()()` Returns the descriptor for the struct. |
| `open https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html?` | `@https://developers.home.google.com/reference/kotlin/com/google/home/annotation/HomeExperimentalGenericApi https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/ColorControlTrait.MoveToSaturationCommand.Request#getFieldValueById(kotlin.UInt)(tagId: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-u-int/index.html)` Returns the value of the field for the given tag ID. |

| ### Public properties |
|---|---|
| `https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/ColorControlTrait.OptionsBitmap` | `https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/ColorControlTrait.MoveToSaturationCommand.Request#optionsMask()` Determines which bits in the `https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/ColorControlTrait.Attributes#options()` attribute should be overridden by `optionsOverride`. |
| `https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/ColorControlTrait.OptionsBitmap` | `https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/ColorControlTrait.MoveToSaturationCommand.Request#optionsOverride()` If the corresponding bit in `optionsMask` is set to `1`, the bit set here overrides the corresponding bit in `https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/ColorControlTrait.Attributes#options()` attribute. |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-u-byte/index.html` | `https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/ColorControlTrait.MoveToSaturationCommand.Request#saturation()` The saturation to be moved to. |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-u-short/index.html` | `https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/ColorControlTrait.MoveToSaturationCommand.Request#transitionTime()` The time (in 0.1 seconds) taken to move the device to the new saturation. |

## Public constructors

### Request

```
Request(
    saturation: UByte,
    transitionTime: UShort,
    optionsMask: ColorControlTrait.OptionsBitmap = OptionsBitmap(),
    optionsOverride: ColorControlTrait.OptionsBitmap = OptionsBitmap()
)
```

Creates a request payload for the MoveToSaturation command.

## Public functions

### getDescriptor

```
@HomeExperimentalGenericApi
open fun getDescriptor(): StructDescriptor
```

Returns the descriptor for the struct.

### getFieldValueById

```
@HomeExperimentalGenericApi
open fun getFieldValueById(tagId: UInt): Any?
```

Returns the value of the field for the given tag ID.

## Public properties

### optionsMask

```
val optionsMask: ColorControlTrait.OptionsBitmap
```

Determines which bits in the `https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/ColorControlTrait.Attributes#options()` attribute should be overridden by `optionsOverride`.

### optionsOverride

```
val optionsOverride: ColorControlTrait.OptionsBitmap
```

If the corresponding bit in `optionsMask` is set to `1`, the bit set here overrides the corresponding bit in `https://developers.home.google.com/reference/kotlin/com/google/home/matter/standard/ColorControlTrait.Attributes#options()` attribute.

### saturation

```
val saturation: UByte
```

The saturation to be moved to. The valid range of values is `0` to `254`.

### transitionTime

```
val transitionTime: UShort
```

The time (in 0.1 seconds) taken to move the device to the new saturation.