Passa al contenuto principale

Integrazione MetaSounds

Requisiti e Limitazioni​

Requisito di Versione

Questa integrazione funziona solo su UE >= 5.3.

Esiste una versione separata di Runtime Audio Importer con supporto MetaSounds inclusa: MetaSound Runtime Audio Importer

Conflitto di Plugin

Se hai il plugin regolare Runtime Audio Importer installato, rimuovilo prima di installare la versione MetaSound.

Limitazioni Attuali

A causa di problemi di scalabilità non ancora risolti in MetaSounds, sono supportate solo le onde sonore Importate, senza le loro onde derivate (ad esempio, le onde sonore Streaming e Capturable non sono supportate).

Problema Noto UE 5.6

Unreal Engine 5.6 ha un bug relativo alle asserzioni che può causare crash quando si importa audio a runtime in MetaSound nell'editor o nelle build di sviluppo.

Soluzioni alternative:

  • Build Shipping: Compila il tuo progetto con l'impostazione di configurazione Shipping - i crash non si verificheranno
  • Build engine personalizzate: Applica la correzione da questo commit se stai utilizzando una build engine UE 5.6 personalizzata
  • Aggiorna a UE 5.7: Questo problema è stato risolto in Unreal Engine 5.7 e versioni successive

Se stai utilizzando UE 5.6 per test in editor o sviluppo, considera le soluzioni alternative sopra indicate o aggiorna a UE 5.7.

Processo di Configurazione​

1. Abilita Plugin MetaSound​

Per prima cosa, devi abilitare il plugin MetaSound per il tuo progetto.

Abilita plugin MetaSound

2. Configura Grafico MetaSound​

Nell'editor MetaSounds, crea un nuovo input Imported Wave, che dovrebbe essere convertito in un tipo Wave Asset utilizzando il nodo ImportedWaveToWaveAsset.

Nodo Imported Wave To Wave Asset

Dopo la conversione, puoi utilizzare tutte le stesse funzionalità disponibili per il tipo Wave Asset, come riprodurlo utilizzando il nodo Wave Player.

Esempio riproduzione MetaSound

Flusso di Lavoro di Implementazione​

1. Importa e Prepara l'Audio​

Il flusso di lavoro per importare i dati audio è lo stesso del processo standard di Runtime Audio Importer. Tuttavia, dopo che la tua onda sonora è pronta, devi anche chiamare la funzione appropriata per preparare l'onda sonora per l'uso da parte di MetaSounds.

Prepara Sound Wave Per MetaSounds

2. Imposta Parametro Wave​

Puoi quindi impostare il parametro wave per il componente audio del tuo MetaSound e riprodurlo secondo necessità.

Nodo Set Wave Parameter

Esempio Completo​

Ecco un esempio di implementazione completo:

Implementazione in Blueprint​

Esempio di importazione audio per MetaSounds

Grafico MetaSound​

Esempio di riproduzione audio in MetaSounds

Best Practices​

Quando lavori con MetaSounds e Runtime Audio Importer:

  1. Prepara sempre la sound wave specificamente per MetaSound utilizzando la funzione PrepareSoundWaveForMetaSound
  2. Usa il nodo ImportedWaveToWaveAsset per convertire tra i tipi nel grafico MetaSound
  3. Ricorda che attualmente sono supportate solo le sound wave Importate (non Streaming o Capturable)
  4. Se si verificano crash in UE 5.6, fai riferimento alla sezione dei problemi noti sopra per le soluzioni alternative