Skip to content

Configuration: Audio Manager

Justin Aquadro edited this page Jan 14, 2023 · 1 revision

The Audio Manager is a required component of the TXL video players responsible for managing the video player's audio sources. A TXL video player can only be associated with a single audio manager. The audio manager is where default settings such as master volume are configured, along with specifying one or more available audio profiles called Audio Channel Groups. When more than one group is specified, an option is available to switch between them in world.

Default Options

The audio manager sets default options for volume and mute. Master Volume sets the default volume of the video player and will be reflected on any of its volume sliders. Input Volume should be left at 1 and generally ignored. It has a special purpose related to the sync audio manager setting, but this is currently unimplemented in the 2.0 version.

AudioLink

Because the TXL video players support an arbitrary number of video sources, AudioLink needs to be actively managed to set the currently active audio source. Linking AudioLink is simple: press the button Link AudioLink to this manager to automatically find AudioLink in the scene, if it exists. You will be warned if more than one TXL video player is linked to AudioLink at the same time, as they have the potential to conflict with each other.

Audio Channel Groups

A list of one or more audio profiles available for the video player. See below for more information on setting up audio profiles. Any time a profile is added, removed, or modified in any way, the video player must be updated to set that configuration for each available video source. Pressing Update Audio Components at any time will perform the update. Since this operation auto-generates resources in another part of the video player, the generated resources should not be modified by hand.

The inspector will attempt to detect if the profile settings are out of sync with the audio resources generated for the player, and warn you if that's the case.

Audio Profiles

The audio profiles, or Audio Channel Groups, are collections of objects that serve as a template for audio sources. VideoTXL comes with several audio profile prefabs under Texel/Video/AudioGroups.

  • Default: The default profile configured on the video player prefabs. Contains a single 2D audio source for unity and AVPro, and an Audio Fade Zone to simulate volume falloff.
  • Global: The same as the default profile, but without the fade zone.
  • Stereo: A single spatialized audio source for Unity and separate left and right spatialized audio sources for AVPro. This setup is similar to the default audio setup for U# Video.
  • ARC: A 5.1 surround sound audio setup for use with Elevative's ARC DSP. Has additional support to configure audio source positioning.

Use the above prefabs as a reference for creating unique audio profiles when needed. Complex audio setups with more than one audio source require AVPro to take advantage of, but every profile supports specifying an audio source for when Unity video sources are used.

Audio Channel

Each object in an audio profile containing and audio source will also have an Audio Channel script on it. This script offers some options for further controlling the audio source, such as a volume scale, whether it's controlled by a fade zone, or what track it represents. It's okay to have multiple channels for the same track.

Audio Source

Configure audio sources as you would want them to be used in the video player. The audio sources in the channel group will not be used directly, but their settings will be copied onto the audio sources associated with each video source in the player.

Any time settings are changed on the audio source or audio channel components, remember to go back and run Update Audio Components on the audio manager.