The '''RandomAudioClipPlayer''' component is able to play a random audio file all the way through from a list of <code>Clips</code> and parent the resulting one shots under a slot.
<!--T:2-->
<!--T:2-->
== Fields ==
== Fields ==
{{Table ComponentFields
{{Table ComponentFields
|MinDistance|Nullable`1|TypeString0=Float?| the distance in meters in the audio's set transform space where the audio's perceived volume stops increasing and stays constant all the way to the center.
|ParentUnder|Slot| The slot to parent the one shot objects under.
|MaxDistance|Nullable`1|TypeString1=Float?| the maximum distance in meters in the audio's set transform space in meters before it cannot be heard.
|MinDistance|'''[[Type:Nullable`1|Nullable`1]]<[[Type:Float|Float]]>'''|TypeAdv1=true| the distance in meters in the audio's set transform space where the audio's perceived volume stops increasing and stays constant all the way to the center.
|RolloffMode|Nullable`1|TypeString2=Nullable<AudioRolloffMode>| An optional [[Type:AudioRolloffMode|AudioRolloffMode]]
|MaxDistance|'''[[Type:Nullable`1|Nullable`1]]<[[Type:Float|Float]]>'''|TypeAdv2=true| the maximum distance in meters in the audio's set transform space in meters before it cannot be heard.
|Clips|SyncList`1|TypeString3=SyncList<ClipData>| The list of [[Type:ClipData|ClipData]] to choose from, randomly with weights.
|RolloffMode|'''[[Type:Nullable`1|Nullable`1]]<[[Type:AudioRolloffMode|AudioRolloffMode]]>'''|TypeAdv3=true| An optional [[Type:AudioRolloffMode|AudioRolloffMode]]
|Clips|{{RootFieldType|SyncList`1|[[Type:ClipData|ClipData]]}}|TypeAdv4=true| The list of [[Type:ClipData|ClipData]] to choose from, randomly with weights.
}}
== Sync Delegates ==
{{Table ComponentTriggers
|Play:[[Type:Action|Action]]|[[Type:Action|Action]]|false| Plays a random audio clip at it's current position
|PlayAtPoint:[[Type:Action`1|Action`1]]<[[Type:Float3|Float3]]>|[[Type:Action`1|Action`1]]<[[Type:Float3|Float3]]>|false| Plays a random audio clip at the provided position.
}}
}}
<!--T:3-->
<!--T:3-->
== Usage ==
== Usage ==
{{stub}}
Attach to a slot and give the component some <code>Clips</code> to play. This component can be trigged via it's [[Sync Delegate|sync delegates]] or by [[Button Events|button events]]
<!--T:4-->
<!--T:4-->
== Examples ==
== Examples ==
{{stub}}
This can be used for boopers, doorbells, or a bike horn.
Random Audio Clip Player component as seen in the Scene Inspector
The RandomAudioClipPlayer component is able to play a random audio file all the way through from a list of Clips and parent the resulting one shots under a slot.
the distance in meters in the audio's set transform space where the audio's perceived volume stops increasing and stays constant all the way to the center.
