Skip to main content
Version: 8.3
View as Markdown

Vision - Sound Player

Component Palette Icon:

Description​

The Sound Player component is an invisible component that facilitates audio playback in the client. Each Sound Player component has one sound clip associated with it, and will play that clip on demand. There is a built in triggering system, as well as facilities to loop the sound while the trigger is set. The sound clip needs to be a *.wav file. The clip becomes embedded within the window that the sound player is on. Clients do not need access to a shared *.wav file.

Properties​

NameDescriptionProperty TypeScriptingCategory
Loop CountIf Loop Mode is Loop N Times, this value represents N.int.loopCountBehavior
Loop ModeThe Loop Mode determines how many times the sound is played when triggered.int.loopModeBehavior
Mouseover TextThe text that is displayed in the tooltip which pops up on mouseover of this component.String.toolTipTextCommon
MuteIf true, the clip will be muted during playback.boolean.muteBehavior
NameThe name of this component.String.nameCommon
Play ModeDetermines when the sound is played:
  • On Trigger: Plays the sound automatically when the Trigger property is set to true. Use a binding on the Trigger property to further specify trigger conditions.
  • Manual: Plays the sound upon manual interaction. A script is required to configure when the audio plays and stops. See the Vision - Sound Player Scripting Functions page for more information.
int.playModeBehavior
QualityThe data quality code for any Tag bindings on this component.QualityCode.qualityData
Sound DataThe clip that this component will play.byte[].soundDataData
TriggerThe clip will be played when the trigger is true, if Play Mode is On Trigger.boolean.triggerData
VolumeThe volume to use for playback (from 0.0 to 1.0).double.volumeBehavior

Scripting​

See the Vision - Sound Player Scripting Functions page for the associated Component and Extension Functions available for this component.

Event Handlers​

Event handlers allow you to run a script based off specific triggers. See the full list of available event handlers on the Component Events page.

Customizers​