Skip to content

Installation

Downloads and prerequisites

Install Unity Hub.

  • Launch the Unity Hub and create a new project. This will prompt you to install a Unity editor if you have not already done so.

Adding RoomAcoustiC++ to a Unity project

Copy the RoomAcoustiCpp-Unity folder into the Assets directory of your Unity project.

  • Download the latest version of RoomAcoustiCpp-Unity from the release section, or clone the repository with the following command: 
    # Navigate to the Unity project Assets directory 
cd Assets

# Clone the repository
git clone https://github.com/jmannall/RoomAcoustiCpp-Unity.git

Branch compatibility

Check you are using the correct branch of the GitHub repository.

Two branches are included in the repository: Unity6 and Unity2023orEarlier to preserve backwards compatibility. The differences between the branches are minimal, with Unity materials and scenes being the primary differences. The Unity6 branch is for Unity 6 and later. The Unity2023orEarlier branch should be used with Unity 2023 or older.

  • For new projects Unity6 is recommended.

Copy StreamingAssets

Copy the StreamingAssets folder from the RoomAcoustiCpp-Unity directory into the Assets directory of your Unity project.

Additional steps for Unity 2023 or older

The demo scene uses the new Unity Input System. If you are using a Unity 2023 or older you will need to install it through the Unity package manager: installation guide.

External content distributed together with this software

A KEMAR head HRTF is provided https://publications.rwth-aachen.de/record/807373.

It has been processed to match the expected file format for the 3DTI Toolkit. The ITDs were extracted1 using the following MATLAB code:

function [leftMinPhase, rightMinPhase, leftDelay, rightDelay] = ConvertToMinimumPhase(left, right, fs)
    fc = 3e3;
    threshold = db2mag(-30);

    leftLPF = lowpass(left,fc,fs);
    rightLPF = lowpass(right,fc,fs);

    leftOffset = max(leftLPF) * threshold;
    rightOffset = max(rightLPF) * threshold;

    leftDelay = find(leftLPF > leftOffset, 1, "first") - 1;
    rightDelay = find(rightLPF > rightOffset, 1, "first") - 1;

    [~, leftMinPhase] = rceps(left);
    [~, rightMinPhase] = rceps(right);
end

Audio files "EBU_FemaleSpeech", "EBU_MaleSpeech" and "EBU_PopMusic" are from the EBU Sound Quality Assessment Material (SQAM) CD https://tech.ebu.ch/publications/sqamcd.

  1. Andreopoulou A, et al. "Identification of perceptually relevant methods of inter-aural time difference estimation." J. Acoust. Soc. Am., 142:588-598, 2017 ↩