🚧

Deprecated

This component is deprecated. It is not available in the latest VRChat SDK, and is either non-functional, or will no longer receive updates. It may be removed at a later date.

Use Udon Player Audio instead.

This component is used to alter a player's voice and avatar sound spatialization parameters when they enter a region. This can be used to have performers on stage project their voice further than default, or likewise, have the audience voices not carry as much. This component can also be used to change the limits for avatar-based VRC_SpatialAudioSources within the region-- you can allow higher limits, lower the limits, or even turn off avatar audio entirely in your world.

This component is used in conjunction with a Unity Trigger collider. Any collider shape may be used. In order for the VRC_PlayerAudioOverride to work, you must create a new collider! You can use any type of collider, but Box is likely the most common use case. This collider must have Is Trigger checked!

📘

Use Default Layer

You should always use the Default layer for VRC_PlayerAudioOverride.

If you want the Override to affect the entire scene, enable the Global checkbox.

When a user enters the Trigger Collider, the given spatial parameters are applied. When a user leaves the trigger, the default spatial parameters are restored. This change is immediate.

Unity Editor Interface

When you add this component to a GameObject, it will have default settings loaded. No Collider will be defined in the Region property field. In order for the VRC_PlayerAudioOverride to work, you must create a new collider, and assign it to the Region property. You can use any type of collider, but Box is likely the most common use case. This collider must have Is Trigger checked!

🚧

Don't forget to enable Is Trigger!

Any collider used for VRC_PlayerAudioOverride must use the Is Trigger option on the Collider, or else it will be treated as a physics collider.

As an example, a Box Collider will have a gizmo with walls to indicate its bounds. Clicking "Edit Collider" in the Collider component will allow you to adjust the dimensions of the Override Region in the 3D view. You can also adjust the Center and Dimensions of the Box Collider component directly in the Inspector. When a player is within those bounds, they will be affected by the Override.

Notably, you can use any collider shape for VRC_PlayerAudioOverride, like a Sphere Collider or even a Mesh Collider. Add the collider to the GameObject, set Is Trigger to True, and you're good to go!

Voice Falloff Mechanics

All units are in meters. Falloff of audio intensity is roughly inverse-square, with some adjustments.

For more details specific to avatar audio sources, please see the documentation for VRC_SpatialAudioSource.

VRChat Voice Falloff Curve Adjustments

VRChat voice uses an inverse-square curve that has been slightly compressed and boosted.

This voice falloff approximates real-world behavior (ignoring occlusion, reverb, etc) and will allow users to naturally pick voices out of a crowd, while preventing issues such as close-range clipping and unexpected drops.

In addition, there is a low-pass filter on voice once you start to get closer to your Voice Far range. This is intended to turn distant conversation into "crowd-noise", and helps with improving the ability to understand many voices in crowded areas and instances. The low-pass filter begins affecting voice at 1/2 of the Voice Far value.

Component Properties

🚧

Dynamic Adjustment via Animations

Adjusting these properties via animations during runtime is not supported. These values are set at initialization.

🚧

Low "Far" Ranges

Having your Voice Far set very low (less than 20m) will result in sharp drop-offs. You probably shouldn't do that-- but if you do, keep that in mind.

❗️

Disabling / Enabling GameObject or Component

If a VRC_PlayerAudioOverride region is enabled/disabled while someone is standing in its area of influence, you may experience undocumented behavior. This is because Unity does not fire a OnTriggerExit callback if you are within a collider when it is disabled.

In short, do not attempt to toggle on / toggle off the GameObject or Components involved with VRC_PlayerAudioOverride while someone is within its area of influence.

If you instead choose to move the collider (say, into the floor) via an animation, it should work fine. Obviously, this won't work with Global regions, but in this case you can instead override with regions.

PlayerAudioOverride Default Values

Values listed are the defaults for player voice when no VRC_PlayerAudioOverride is in effect, or when you create a new component. These values are subject to change.

† To reiterate, these are limits, not boosts.

Notes

• All player voice gets an addition 6db boost relative to other sounds. This is on top of any Gain you apply with the VRC_PlayerAudioOverride.
• Don't overlap regions with the same priority. That will result in spooky undocumented behavior.