CRIWARE Unity Plugin Manual
Last Updated: 2024-07-12
CRI Atom Unity Timeline Extension
How to use Timeline Expansion
Creating a track
You can create a new Atom track by right-clicking on the blank area of Timeline and clicking [Add] button-> [CriTimeline.Atom] -> [Cri Atom Track].
For Timeline assets that are already set in the PlayableDirector component, you can bind the CriAtomSource component for playback to the Cri Atom track.
All clips on this track will play through this CriAtomSource.
It is also possible to bind the same CriAtomSource to multiple tracks.
Inspector options for each track
The following options can be found in the inspector of each track.
Aisac Control: the name of the AISAC Control which can be controlled by the track's curve
Stop On Wrapping: For a looped track, whether to stop the audio playback from the previous loop when starting a new loop
Stop At Graph End: Whether to stop the audio playback of this track when the Timeline is stopped
Apply Playable Speed: Whether to apply the playback speed specified for Playable to the audio
Check Position Within Clip: Whether the playback position of the audio is changed alongside the playback position in the Clip
*If the timeUpdateMode of PlayableDirector for playback is "Manual", please uncheck this.
Show Mono Waveform: Whether to display the waveform of the first channel of each clip on this audio track (waveforms of all channels will be displayed if false)
Creating a clip
You can add a new clip to the track by right-clicking on the blank area of the Atom track -> [Add Cri Atom Clip].
Multiple clips can be stacked.
Inspector options for each clip
The following options can be found in each clip's inspector.
Upper half:
Clip position / length
Fade in / Fade out length
Blend (fade in / out) change curve
The speed factor does not work at this time.
Lower half:
Specify the CueSheet or the Cue that the clip plays
Stop Without Release: Set whether to enable release when stopping due to clip end
Muted: Whether to mute the clip
Ignore Blend: Whether to ignore clip blend settings
Loop Within Clip: Whether to perform loop playback within the clip
Stop At Clip End: Whether to stop playing at the end of the clip
Set volume, pitch, AISAC control values
The change of these three values can be controlled in the Timeline curve view described below
The name of the AISAC control can be set in the track inspector screen
Timeline window edit items
Clip position / length
(Unity 2019 or later, adjust the clip edge while holding down the Ctrl key) Fade in / out length
Set key points for volume, pitch and AISAC value change in curve view
Unity2018: Turn the record button on to place key points, turn it off to apply the settings, click the curve view button that appears at this point to check and edit the change curve
Unity2019: Press the Curve View button to display the Curve View, select a variable, double click on the curve and place a key point
About preview playback in Edit mode
Even under Unity's Edit mode, you can preview and play the audio of a CRI Atom Clip in the Timeline window.
It also supports scrub playback while dragging, 3D positioning of sound sources, and multi-listeners.
The behavior when playing a multi-listener preview depends on whether the GameObject selected in the editor inspector has a CriAtomListener component:
If there is no selected CriAtomListener: Each CriAtomSource plays the audio to the closest CriAtomListener. This is the same as the default behavior in Play mode and real machine runtime.
If there is a selected CriAtomListener: The audio of all CriAtomSources will sound on the selected CriAtomListener.
The ActiveListenerOnEnable setting of CriAtomListener is not applied during preview playback, so if you want to preview an exclusive CriAtomListener, select the GameObject of CriAtomListener and play the Timeline as described above.
When you select the GameObject of CriAtomListener, the focus of the Timeline window is removed and playback stops, but you can maintain the playback state by using the lock button of the Timeline window.
THIS SERVICE MAY CONTAIN TRANSLATIONS POWERED BY GOOGLE. GOOGLE DISCLAIMS ALL WARRANTIES RELATED TO THE TRANSLATIONS, EXPRESS OR IMPLIED, INCLUDING ANY WARRANTIES OF ACCURACY, RELIABILITY, AND ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.