CRIWARE Unity Plugin Manual  Last Updated: 2024-07-12
CRI Atom Unity Timeline Extension

How to use Timeline Expansion

Creating a track

cri4u_samples_criatom_adv06_new_track.png
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].

cri4u_samples_criatom_adv06_set_binding.png
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

cri4u_samples_criatom_adv06_timeline_track_inspector.png
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

cri4u_samples_criatom_adv06_new_clip.png
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

cri4u_samples_criatom_adv06_inspector.png
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

cri4u_samples_criatom_adv06_set_timeline_window.png
  • 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.
atom4u_extension_timeline_window_lock.png

   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.