Aller au contenu principal

Intégration MetaSounds

Exigences et limitations​

Exigence de version

Cette intégration fonctionne uniquement sur UE >= 5.3.

Il existe une version distincte de Runtime Audio Importer avec prise en charge MetaSounds incluse : MetaSound Runtime Audio Importer

Conflit de plugin

Si vous avez le plugin Runtime Audio Importer régulier installé, veuillez le supprimer avant d'installer la version MetaSound.

Limitations actuelles

En raison de problèmes de mise à l'échelle qui ne sont pas encore résolus dans MetaSounds, seules les ondes sonores Imported sont prises en charge, sans leurs ondes dérivées (par exemple, les ondes sonores Streaming et Capturable ne sont pas prises en charge).

Problème connu UE 5.6

Unreal Engine 5.6 a un bug lié aux assertions qui peut provoquer des plantages lors de l'importation de son à l'exécution dans MetaSound dans l'éditeur ou les builds de développement.

Solutions de contournement :

  • Builds Shipping : Compilez votre projet avec le paramètre de configuration Shipping - les plantages ne se produiront pas
  • Builds de moteur personnalisées : Appliquez le correctif de cette validation si vous utilisez une build de moteur UE 5.6 personnalisée
  • Mise à niveau vers UE 5.7 : Ce problème a été résolu dans Unreal Engine 5.7 et les versions ultérieures

Si vous utilisez UE 5.6 pour les tests en éditeur ou en développement, envisagez les solutions de contournement ci-dessus ou passez à UE 5.7.

Processus de configuration​

1. Activer le plugin MetaSound​

Tout d'abord, vous devez activer le plugin MetaSound pour votre projet.

Activer le plugin MetaSound

2. Configurer le graphe MetaSound​

Dans l'éditeur MetaSounds, créez une nouvelle entrée Imported Wave, qui doit être convertie en type Wave Asset en utilisant le nœud ImportedWaveToWaveAsset.

Nœud Imported Wave To Wave Asset

Après conversion, vous pouvez utiliser toutes les mêmes fonctionnalités disponibles pour le type Wave Asset, telles que la lecture en utilisant le nœud Wave Player.

Exemple de lecture MetaSound

Flux de travail d'implémentation​

1. Importer et préparer l'audio​

Le flux de travail pour importer des données audio est le même que le processus standard de Runtime Audio Importer. Cependant, après que votre onde sonore est prête, vous devez également appeler la fonction appropriée pour préparer l'onde sonore à être utilisée par MetaSounds.

Préparer l'onde sonore pour MetaSounds

2. Définir le paramètre Wave​

Vous pouvez ensuite définir le paramètre wave pour le composant audio de votre MetaSound et le lire selon les besoins.

Nœud Set Wave Parameter

Exemple Complet​

Voici un exemple d'implémentation complet :

Implémentation Blueprint​

Exemple d'importation audio pour MetaSounds

Graphe MetaSound​

Exemple de lecture audio dans MetaSounds

Bonnes Pratiques​

Lorsque vous travaillez avec MetaSounds et Runtime Audio Importer :

  1. Préparez toujours la sound wave spécifiquement pour MetaSound en utilisant la fonction PrepareSoundWaveForMetaSound
  2. Utilisez le nœud ImportedWaveToWaveAsset pour convertir entre les types dans le graphe MetaSound
  3. Rappelez-vous que seules les sound waves importées sont actuellement prises en charge (pas Streaming ou Capturable)
  4. Si vous rencontrez des plantages dans UE 5.6, reportez-vous à la section des problèmes connus ci-dessus pour les solutions de contournement