Pular para o conteúdo principal

Configuração Específica da Plataforma

Este guia aborda requisitos de configuração e configurações específicas da plataforma para o plugin Runtime Text To Speech.

Falhas no Android e iOS​

Em alguns casos no Android e iOS, falhas podem ocorrer durante a execução (como durante testes no TestFlight). Isso é causado pelos requisitos de alocação de memória da biblioteca ONNX Runtime subjacente, que entram em conflito com os alocadores padrão do Unreal Engine nessas plataformas.

Para resolver isso, você precisa forçar o alocador ANSI no arquivo Target.cs do seu projeto:

Para Unreal Engine 5.5 e anteriores:

  • Seu projeto deve usar um motor construído a partir do código-fonte (não um binário pré-compilado)
  • Adicione a seguinte linha ao seu arquivo Target.cs:
GlobalDefinitions.Add("FORCE_ANSI_ALLOCATOR=1");

Para Unreal Engine 5.6 e posterior:

  • Funciona com builds do motor compilados a partir do código-fonte e pré-compilados
  • Adicione as duas linhas a seguir ao seu arquivo Target.cs:
bOverrideBuildEnvironment = true;
StaticAllocator = StaticAllocatorType.Ansi;

Isso força o Unreal Engine a usar o alocador ANSI no Android e iOS, correspondendo ao alocador usado pelo ONNX Runtime.

Configuração para Mac / Linux (UE 5.6+)​

Conflito do Plugin NNERuntimeORT

Se você estiver usando Unreal Engine 5.6 ou posterior nas plataformas Mac ou Linux, encontrará um conflito de plugin que impede que os modelos realistas funcionem corretamente.

O Problema​

A partir do UE 5.6, o motor inclui o plugin NNERuntimeORT, que entra em conflito com os modelos realistas do plugin Runtime MetaHuman Lip Sync nas plataformas Mac e Linux. Esse conflito impede que a funcionalidade de sincronização labial realista seja inicializada corretamente.

Solução​

Para resolver esse conflito, você precisa modificar o arquivo de configuração do plugin:

  1. Navegue até a pasta de instalação do seu Unreal Engine
  2. Vá para Engine/Plugins/Marketplace/
  3. Encontre a pasta do plugin RuntimeTextToSpeech
  4. Abra o arquivo RuntimeTextToSpeech.uplugin em um editor de texto
  5. Remova a seguinte seção inteiramente:
,
  "Plugins": [
    {
      "Name": "NNERuntimeORT",
      "Enabled": true
    }
  ]

Notas Importantes​

  • Esta modificação afeta apenas as plataformas Mac e Linux. Usuários do Windows não precisam fazer essa alteração.
  • Esta correção é necessária apenas para o UE 5.6 e versões posteriores. Versões anteriores do motor não são afetadas.
  • Você pode precisar repetir este processo se atualizar o plugin, pois as atualizações restaurarão o arquivo de configuração original.