UniVoice

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.

  • ⚙ Fine control over audio data flow.

    • Don't want to listen to a peer? Mute them. Don't want someone listening to you? Deafen them.
    • Group players using tags and control audio flow between them. For example:
      • "red", "blue" and "spectator" tags for two teams playing against each other.
        • Red and Blue teams can only hear each other
        • Spectators can hear everyone
      • clients with "contestant", "judge" and "audience" tags for a virtual talent show.
        • Contestant can be heard by everyone, but don't hear anyone else (for focus)
        • Judges can talk to and hear each other for discussions. They can hear the contestant. But not the audience (for less noise)
        • Audience can hear and talk to each other. They can hear the performer. But they cannot hear the judges.

  • 🎨 Customize your audio input, output and networking layers.

    • 🌐 Configurable Network:

      • UniVoice is networking agnostic. Implement the IAudioClient and IAudioServer interfaces using the networking plugin of your choice to have it send audio data over any networking solution.
      • Built-in support for:
        • Mirror networking

    • 🎤 Configurable Audio Input:

      • UniVoice is audio input agnostic. You can change the source of outgoing audio by implementing the IAudioInput interface.
      • Built-in support for:
        • Capturing Mic audio as device input.

    • 🔊 Configurable Audio Output:

      • UniVoice is audio output agnostic. You can divert incoming audio to anywhere you want by implementing the IAudioOutput interface.
      • Built-in support for:
        • Playing incoming audio using Unity AudioSource.

    • ✏️ Audio Filters:

      • Modify outgoing and incoming audio by implementing the IAudioFilter interface.
      • Built-in support for:
        • Opus (Concentus) encoding & decoding.
        • RNNoise based noise removal.
        • Gaussian blurring for minor denoising.

Installation

⚠️ OpenUPM may not have up to date releases. Install using NPM registry instead 👇

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.

Integration

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.

Samples

This repository contains two samples:

  • UniVoiceMirrorSetupSample.cs is 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 the UniVoiceMirrorSetupSample.cs file.
  • 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.

Dependencies

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

Activating non-packaged dependencies

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_MIRROR to activate it
  • RNNoise Noise removal filter:
    • To enable, ensure the RNNoise4Unity package is in your project and add UNIVOICE_FILTER_RNNOISE4UNITY to activate it

License and Support

This project is under the MIT license.

Community contributions are welcome.

Contact

The developer can be reached at the following links:

Website
LinkedIn
GitHub
Twitter
Discord: adrenak#1934