Pular para o conteúdo principal

Integração com MetaSounds

Requisitos e Limitações​

Requisito de Versão

Esta integração funciona apenas no UE >= 5.3.

Existe uma versão separada do Runtime Audio Importer com suporte a MetaSounds incluído: MetaSound Runtime Audio Importer

Conflito de Plugin

Se você tiver o plugin regular Runtime Audio Importer instalado, remova-o antes de instalar a versão MetaSound.

Limitações Atuais

Devido a problemas de escalonamento que ainda não foram resolvidos no MetaSounds, apenas as ondas sonoras Imported são suportadas, sem suas ondas derivadas (por exemplo, ondas sonoras Streaming e Capturable não são suportadas).

Problema Conhecido no UE 5.6

O Unreal Engine 5.6 tem um bug relacionado a asserções que pode causar travamentos ao importar som em tempo de execução para o MetaSound no editor ou em builds de desenvolvimento.

Soluções Alternativas:

  • Builds de Shipping: Empacote seu projeto com a configuração Shipping - os travamentos não ocorrerão
  • Builds de motor personalizado: Aplique a correção deste commit se estiver usando uma build de motor UE 5.6 personalizada
  • Atualize para o UE 5.7: Este problema foi resolvido no Unreal Engine 5.7 e versões posteriores

Se você estiver usando o UE 5.6 para testes no editor ou em desenvolvimento, considere as soluções alternativas acima ou atualize para o UE 5.7.

Processo de Configuração​

1. Habilitar Plugin MetaSound​

Primeiro, você precisa habilitar o plugin MetaSound para seu projeto.

Habilitar plugin MetaSound

2. Configurar Grafo MetaSound​

No editor MetaSounds, crie uma nova entrada Imported Wave, que deve ser convertida para o tipo Wave Asset usando o nó ImportedWaveToWaveAsset.

Nó Imported Wave To Wave Asset

Após a conversão, você pode usar todas as mesmas funcionalidades que estão disponíveis para o tipo Wave Asset, como reproduzi-lo usando o nó Wave Player.

Exemplo de reprodução MetaSound

Fluxo de Trabalho de Implementação​

1. Importar e Preparar Áudio​

O fluxo de trabalho para importar dados de áudio é o mesmo do processo padrão do Runtime Audio Importer. No entanto, após sua onda sonora estar pronta, você também deve chamar a função apropriada para preparar a onda sonora para uso pelo MetaSounds.

Preparar Sound Wave Para MetaSounds

2. Definir Parâmetro Wave​

Você pode então definir o parâmetro de onda para o componente de áudio do seu MetaSound e reproduzi-lo conforme necessário.

Nó Set Wave Parameter

Exemplo Completo​

Aqui está um exemplo de implementação completo:

Implementação em Blueprint​

Exemplo de importação de áudio para MetaSounds

Grafo do MetaSound​

Exemplo de reprodução de áudio em MetaSounds

Melhores Práticas​

Ao trabalhar com MetaSounds e Runtime Audio Importer:

  1. Sempre prepare a onda sonora especificamente para MetaSound usando a função PrepareSoundWaveForMetaSound
  2. Use o nó ImportedWaveToWaveAsset para converter entre tipos no grafo do MetaSound
  3. Lembre-se de que atualmente apenas ondas sonoras importadas são suportadas (não Streaming ou Capturable)
  4. Se estiver enfrentando travamentos no UE 5.6, consulte a seção de problema conhecido acima para soluções alternativas