name | :: string | Name has to be unique across all layers. |
Name has to be unique across all layers. | ||
variants | :: array[Sound] | Cannot be empty. [...] |
Cannot be empty. [...] | ||
composition_mode | :: VariableAmbientSoundCompositionMode | |
control_layer optional | :: string | Name of a layer which controls this layer, a layer cannot control itself. [...] |
Name of a layer which controls this layer, a layer cannot control itself. [...] | ||
control_layer_sample_mapping optional | :: array[array[uint8]] | Defines a mapping between controlling layer's samples and this (controlled) layer's samples. [...] |
Defines a mapping between controlling layer's samples and this (controlled) layer's samples. [...] | ||
has_start_sample optional | :: bool | If |
If | ||
has_end_sample optional | :: bool | If |
If | ||
number_of_sublayers optional | :: uint8 | If greater than one, samples are composed in overlapping sub-layers, offset from each other. [...] |
If greater than one, samples are composed in overlapping sub-layers, offset from each other. [...] | ||
sublayer_starting_offset optional | :: RandomRange or ProbabilityTable | Specifies starting offset of the second sub-layer. [...] |
Specifies starting offset of the second sub-layer. [...] | ||
sublayer_offset optional | :: RandomRange or ProbabilityTable | Specifies offset between two sub-layers' samples. [...] |
Specifies offset between two sub-layers' samples. [...] | ||
sample_length optional | :: RandomRange | Explicitly defines sample lengths. [...] |
Explicitly defines sample lengths. [...] |
composition_mode | :: VariableAmbientSoundCompositionMode | |
name | :: string | Name has to be unique across all layers. |
Name has to be unique across all layers. | ||
variants | :: array[Sound] | Cannot be empty. [...] |
Cannot be empty. [...] | ||
control_layer optional | :: string | Name of a layer which controls this layer, a layer cannot control itself. [...] |
Name of a layer which controls this layer, a layer cannot control itself. [...] | ||
control_layer_sample_mapping optional | :: array[array[uint8]] | Defines a mapping between controlling layer's samples and this (controlled) layer's samples. [...] |
Defines a mapping between controlling layer's samples and this (controlled) layer's samples. [...] | ||
has_end_sample optional | :: bool | If |
If | ||
has_start_sample optional | :: bool | If |
If | ||
number_of_sublayers optional | :: uint8 | If greater than one, samples are composed in overlapping sub-layers, offset from each other. [...] |
If greater than one, samples are composed in overlapping sub-layers, offset from each other. [...] | ||
sample_length optional | :: RandomRange | Explicitly defines sample lengths. [...] |
Explicitly defines sample lengths. [...] | ||
sublayer_offset optional | :: RandomRange or ProbabilityTable | Specifies offset between two sub-layers' samples. [...] |
Specifies offset between two sub-layers' samples. [...] | ||
sublayer_starting_offset optional | :: RandomRange or ProbabilityTable | Specifies starting offset of the second sub-layer. [...] |
Specifies starting offset of the second sub-layer. [...] |
Name has to be unique across all layers.
Cannot be empty.
Samples within a layer are the Sound::variations.
Number of samples must be the same across all variants.
Samples cannot have variable volume and all samples must have the same default volume.
Name of a layer which controls this layer, a layer cannot control itself.
Only loaded, and mandatory if composition_mode
is "layer-controlled"
.
Defines a mapping between controlling layer's samples and this (controlled) layer's samples. The number of items in the mapping must be the same as the number of samples in the controlling layer. Item in the mapping with index N defines which samples of this layer can play when the sample N is playing in the controlling layer.
Only loaded, and mandatory if composition_mode
is "layer-controlled"
.
Default: false
If true
, the first of Sound::variations is played at the start of a sequence. The start sample counts towards the VariableAmbientSoundLayerStateProperties::sequence_length
Default: false
If true
, the last of Sound::variations is played at the end of a sequence (if the sequence is long enough). The end sample counts towards the VariableAmbientSoundLayerStateProperties::sequence_length.
Default: 1
If greater than one, samples are composed in overlapping sub-layers, offset from each other.
If greater than one, one of sublayer_starting_offset
or sublayer_offset
must be defined. Both cannot be defined together.
Cannot be defined for layers with "shuffled"
composition_mode
.
Cannot be zero.
Specifies starting offset of the second sub-layer.
Only loaded if number_of_sublayers
is greater than one.
Cannot be defined together with sublayer_offset
.
The minimum of RandomRange variant cannot be zero.
Specifies offset between two sub-layers' samples.
This implicitly dictates the sample lengths as two sub-layer offsets.
Only loaded if number_of_sublayers
is greater than one.
Cannot be defined together with sublayer_starting_offset
.
The minimum of RandomRange variant cannot be zero.
Explicitly defines sample lengths. The whole sample is played when this is not specified.
Cannot be defined together with sublayer_offset
.
The minimum cannot be zero.