Zum Hauptinhalt springen

MetaSounds-Integration

Anforderungen und Einschränkungen​

Versionsanforderung

Diese Integration funktioniert nur mit UE >= 5.3.

Es gibt eine separate Version von Runtime Audio Importer mit MetaSounds-Unterstützung: MetaSound Runtime Audio Importer

Plugin-Konflikt

Wenn Sie das reguläre Runtime Audio Importer-Plugin installiert haben, entfernen Sie es bitte, bevor Sie die MetaSound-Version installieren.

Aktuelle Einschränkungen

Aufgrund von Skalierungsproblemen, die in MetaSounds noch nicht gelöst sind, werden nur Importierte Sound-Wellen unterstützt, ohne ihre abgeleiteten Wellen (z.B. werden Streaming- und Capturable-Sound-Wellen nicht unterstützt).

Bekanntes Problem in UE 5.6

Unreal Engine 5.6 hat einen Assertions-bezogenen Fehler, der zu Abstürzen führen kann, wenn Sound zur Laufzeit in MetaSound im Editor oder in Entwicklungs-Builds importiert wird.

Workarounds:

  • Shipping-Builds: Packen Sie Ihr Projekt mit der Shipping-Konfigurationseinstellung - Abstürze treten nicht auf
  • Benutzerdefinierte Engine-Builds: Wenden Sie den Fix aus diesem Commit an, wenn Sie einen benutzerdefinierten UE 5.6 Engine-Build verwenden
  • Upgrade auf UE 5.7: Dieses Problem wurde in Unreal Engine 5.7 und späteren Versionen behoben

Wenn Sie UE 5.6 für Editor- oder Entwicklungstests verwenden, ziehen Sie die oben genannten Workarounds in Betracht oder führen Sie ein Upgrade auf UE 5.7 durch.

Einrichtungsprozess​

1. MetaSound-Plugin aktivieren​

Zuerst müssen Sie das MetaSound-Plugin für Ihr Projekt aktivieren.

MetaSound-Plugin aktivieren

2. MetaSound-Graph konfigurieren​

Erstellen Sie im MetaSounds-Editor einen neuen Imported Wave-Eingang, der mithilfe des ImportedWaveToWaveAsset-Knotens in einen Wave Asset-Typ umgewandelt werden sollte.

Imported Wave To Wave Asset-Knoten

Nach der Konvertierung können Sie alle dieselben Funktionalitäten nutzen, die für den Wave Asset-Typ verfügbar sind, wie z.B. das Abspielen mit dem Wave Player-Knoten.

MetaSound-Wiedergabebeispiel

Implementierungs-Workflow​

1. Audio importieren und vorbereiten​

Der Workflow zum Importieren von Audiodaten ist derselbe wie der Standard-Runtime Audio Importer-Prozess. Nachdem Ihre Sound-Welle jedoch bereit ist, müssen Sie auch die entsprechende Funktion aufrufen, um die Sound-Welle für die Verwendung durch MetaSounds vorzubereiten.

Prepare Sound Wave For MetaSounds

2. Wave-Parameter setzen​

Sie können dann den Wave-Parameter für die Audio-Komponente Ihres MetaSounds festlegen und ihn bei Bedarf abspielen.

Set Wave Parameter node

Vollständiges Beispiel​

Hier ist ein vollständiges Implementierungsbeispiel:

Blueprint-Implementierung​

Import audio for MetaSounds example

MetaSound-Graph​

Play audio in MetaSounds example

Best Practices​

Bei der Arbeit mit MetaSounds und Runtime Audio Importer:

  1. Bereiten Sie die Sound Wave immer speziell für MetaSound mit der Funktion PrepareSoundWaveForMetaSound vor
  2. Verwenden Sie den ImportedWaveToWaveAsset-Knoten, um zwischen Typen im MetaSound-Graph zu konvertieren
  3. Denken Sie daran, dass derzeit nur importierte Sound Waves unterstützt werden (nicht Streaming oder Capturable)
  4. Bei Abstürzen in UE 5.6, lesen Sie den Abschnitt zu bekannten Problemen oben für Workarounds