[CriAtom] Category

Description of the sample

Overview

This sample plays background music automatically. When the buttons on the screen are clicked on, sound effects and narration are played.
When narration is played, the volume of the background music is turned down automatically. Once the narration is over, the volume of the background music is restored.
The BGM and SE sliders are used to adjust the volumes of the background music and the sound effects respectively.

Scene information

Middleware	CRI ADX (CRI Atom)
Sample	Basic sample
Location	/CRIWARE/SDK/unity/samples/UnityProject/Assets/Scenes/criatom/basic/
Scene file	Scene_05_Category.unity

Description of the program

This sample demonstrates the usage of a category to control multiple sounds at once.

Categories can be assigned to each cue.
If you change the playback parameters of a category, you can change all the sounds that belong to that category at once, even if many sounds are being played.
For example, you can create categories for background music, sound effects and voice lines.
Then you can turn down the volumes of the background music and sound effects categories so that the voice lines stand out (ducking).

REACT (ducking)

Ducking can be entirely configured on the data side in CRI Atom Craft by using REACT.
No programmer's involvement is required.
Note that the value returned by the CriAtom.GetCategoryVolume function is not affected by ducking (REACT).

Setting the volume of a category

To set the volume of a category, use its name as defined in CRI Atom Craft.

/* Restore the category volumes before moving to another scene. */
CriAtom.SetCategoryVolume("BGM", 1.0f);
CriAtom.SetCategoryVolume("SE", 1.0f);