UniVoice is a voice chat/VoIP solution for Unity.
Some features of UniVoice:
-
👥 Group voice chat. Multiple peers can join a chatroom and exchange audio.
-
⚙ Peer specific settings. Don't want to listen to a peer? Mute them. Don't want someone listening to you? Deafen them.
-
🎨 Customize your audio input, output and networking layers.
-
🌐 Configurable Network:
- UniVoice is networking agnostic. Implement the
IAudioClientandIAudioServerinterfaces using the networking plugin of your choice to have it send audio data over any networking solution. - Built-in support for:
- Mirror networking. Note that only Client and Server modes are currently supported. Host mode is not.
- UniVoice is networking agnostic. Implement the
-
🎤 Configurable Audio Input:
- UniVoice is audio input agnostic. You can change the source of outgoing audio by implementing the
IAudioInputinterface. - Built-in support for:
- Capturing Mic audio as device input.
- UniVoice is audio input agnostic. You can change the source of outgoing audio by implementing the
-
🔊 Configurable Audio Output:
- UniVoice is audio output agnostic. You can divert incoming audio to anywhere you want by implementing the
IAudioOutputinterface. - Built-in support for:
- Playing incoming audio using Unity AudioSource.
- UniVoice is audio output agnostic. You can divert incoming audio to anywhere you want by implementing the
-
✏️ Audio Filters:
- Modify outgoing and incoming audio by implementing the
IAudioFilterinterface. - Built-in support for:
- Opus (Concentus) encoding & decoding.
- RNNoise based noise removal.
- Gaussian blurring for minor denoising.
- Modify outgoing and incoming audio by implementing the
-
Ensure you have the NPM registry in the manifest.json file of your Unity project with the following scopes:
"scopedRegistries": [
{
"name": "npmjs",
"url": "https://registry.npmjs.org",
"scopes": [
"com.npmjs",
"com.adrenak.univoice",
"com.adrenak.brw",
"com.adrenak.unimic",
"com.adrenak.concentus-unity"
]
}
}
Then add com.adrenak.univoice:x.y.z to the dependencies in your manifest.json file (where x.y.z is the version you wish to install). The list of versions is available on the UniVoice NPM page.
- API reference is available here: http://www.vatsalambastha.com/univoice
- UniVoice blog: https://blog.vatsalambastha.com/search/label/univoice
- Discord server: https://discord.gg/Un6Y2sQqqe
UniVoice isn't currently very drag-and-drop/low-code. The best way to integrate is to have some code perform a one time setup when your app starts and provides access to relevant objects that you can use throughout the rest of the apps runtime.
An example of this is the UniVoiceMirrorSetupSample.cs file that gives you access to an AudioServer that you can use in your server code and a ClientSession that you can use in your client code. For more see the "Samples" section below.
This repository contains two samples:
UniVoiceMirrorSetupSample.csis a drag and drop component, a simple integration sample script. You can add it to your Mirror NetworkManager to get voice chat to work. No code required, it's as simple as that! It'll work as long as you have setup your project properly. For more instructions see the top of theUniVoiceMirrorSetupSample.csfile.- A sample scene that shows the other clients in a UI as well as allows you to mute yourself/them. This sample is also Mirror based.
UniVoice currently only supports Mirror out of the box. All the samples rely on Mirror networking to work. Follow the instructions in the "Activating non-packaged dependencies" section below for enabling Mirror in your project before trying it out. Also note that the Host mode is not supported, your server should be in Server mode only.
com.adrenak.brw for reading and writing messages for communication. See MirrorServer.cs and MirrorClient.cs where they're used.
com.adrenak.unimic for easily capturing audio from any connected mic devices. See UniMicInput.cs for usage. Also used for streaming audio playback. See StreamedAudioSourceOutput.cs for usage.
com.adrenak.concentus-unity for Opus encoding and decoding. See ConcentusEncodeFilter.cs and ConcentusDecodeFilter.cs for usage
UniVoice includes and installs the dependencies mentioned above along with itself. The following implementations are available out of the box when you install it:
- Opus encoding/decoding filter (via Contentus-Unity)
- GaussianAudioBlur filter (plain C#, no dependencies used)
- Mic audio capture input (via UniMic)
- AudioSource based playback output (via UniMic)
But the following implementations are based on dependencies that you have to install and enable via compilation symbols as they are not UniVoice dependencies and don't get installed along with UniVoice. This is because they are either third party modules or based on native libraries (not plain C#) that can pose build issues.
- Mirror network:
- To enable, ensure the Mirror package is in your project and add
UNIVOICE_NETWORK_MIRRORto activate it
- To enable, ensure the Mirror package is in your project and add
- RNNoise Noise removal filter:
- To enable, ensure the RNNoise4Unity package is in your project and add
UNIVOICE_FILTER_RNNOISE4UNITYto activate it
- To enable, ensure the RNNoise4Unity package is in your project and add
This project is under the MIT license.
Community contributions are welcome.
The developer can be reached at the following links: