Entwickeln

Meta XR Audio SDK-Plugin für Unity – Anforderungen und Einrichtung

Aktualisiert: 18.02.2025

Übersicht

Meta XR Audio ist ein Plugin für Unity, mit dem du Punktquellen- und Raumklang in 3D relativ zur Kopfposition räumlich verorten kannst. Außerdem bietet es ein grundlegendes Raumakustikmodell für frühe Reflexionen und Hall.

Eine ausführliche Erläuterung der Audio-Raumverortung und des Virtual-Reality-Audios findest du im Leitfaden Einführung in Virtual-Reality-Audio. Wenn du noch keine Erfahrung mit der Handhabung von Audio in Unity hast, sieh dir den Unity Audio-Leitfaden⁠ an.

Voraussetzungen

Bevor du mit diesem Tutorial fortfährst, solltest du die unter Einrichten von Unity für die XR-Entwicklung beschriebene Einrichtung ausführen, um ein Projekt mit den nötigen Abhängigkeiten zu erstellen.

Meta XR Audio SDK installieren

Wenn du FMOD oder Wwise für Audio in deiner Unity-Apps verwenden möchtest, solltest du das Meta XR Audio SDK-Plugin für Unity nicht installieren. Installiere stattdessen das entsprechende Plugin-Paket von FMOD oder Wwise.

Methode 1: Download über den Unity Asset Store

Das Meta XR Audio SDK Unity-Paket ist im Unity Asset Store⁠ verfügbar. Installiere das Paket wie jedes andere Paket aus dem Asset Store:

Rufe in einem Webbrowser das Meta XR Audio SDK⁠ auf.

Hinweis: Wenn du keine Unity-ID hast, musst du eine erstellen und dich anmelden. Weitere Informationen findest du in der Unity-Dokumentation⁠.

Klicke auf Add to My Assets.

Melde dich mit der gleichen Unity-ID beim Unity Hub an und öffne dein Projekt im Unity-Editor.

Wähle im Unity Package Manager My Assets > Meta XR Audio SDK aus.

Klicke auf Install.

Methode 2: Download über das Meta Horizon Developer Center

Gehe zu Meta XR Audio SDK (UPM) und klicke auf Download from Meta.

Klicke auf das Downloadsymbol, lies dir die Lizenzvereinbarung durch und klicke auf Agree (Zustimmen), wenn du damit fertig bist. Dein Browser lädt nun einen com.meta.xr.sdk.audio-Tarball herunter.

Öffne dein Projekt im Unity-Editor und wähle Window > Package Manager aus.

Klicke im Package Manager auf + > Add package from tarball und öffne den heruntergeladenen Tarball.

Weitere Informationen zum Unity Package Manager findest du in der Dokumentation zu Unity⁠.

Installation der Beispiele (optional)

Nachdem du das Plugin über eine der oben genannten Methoden installiert hast, kannst du die Beispielszenen importieren, um loszulegen und dein Setup zu überprüfen. Navigiere dazu zum Paketeintrag im Package Manager. Klicke auf Meta XR Audio SDK Package > Samples > Import um neue Szenen und Assets zum Unity-Projektordner hinzuzufügen. Nach dem Import werden die Beispielinhalte unter dem folgenden Pfad in deinem Projekt angezeigt: Assets > Samples > Meta XR Audio SDK > Version > Examples Scenes. Lade die Szenen in den Ordner und mache dich damit vertraut. Die Szenen sind nur für Tests im Wiedergabemodus mit den üblichen WASD-Tasten und Maussteuerung gedacht.

Unity-Projekteinrichtung

Stelle deine Engine für die Raumverortung auf Meta ein, damit alle nativen Audioquellen durch das Spatializer-Plugin von Meta geleitet werden.

Navigiere zu Edit (Bearbeiten) > Project Settings (Projekteinstellungen) > Audio, um das Dialogfeld Audio zu öffnen.

Vergewissere dich im Dialogfeld Audio dass Meta XR Audio als Spatializer-Plugin und Ambisonics Decoder-Plugin ausgewählt ist. Weitere Informationen findest du unter Ambisonic-Audio in Unity wiedergeben.

Stelle den Standard-Lautsprechermodus auf Stereo ein.

Setze die DSP-Puffergröße auf Best latency (Beste Latenz), um die minimal unterstützte Puffergröße für die Plattform einzurichten und die allgemeine Audiolatenz zu reduzieren.