Aller au contenu principal

Configuration spécifique à la plateforme

Ce guide couvre les exigences de configuration spécifiques à la plateforme et les configurations pour le plugin Runtime Text To Speech.

Plantages Android et iOS​

Dans certains cas sur Android et iOS, des plantages peuvent survenir pendant l'exécution (comme lors des tests TestFlight). Cela est causé par les exigences d'allocation mémoire de la bibliothèque ONNX Runtime sous-jacente qui entrent en conflit avec les allocateurs par défaut d'Unreal Engine sur ces plateformes.

Pour résoudre ce problème, vous devez forcer l'allocateur ANSI dans le fichier Target.cs de votre projet :

Pour Unreal Engine 5.5 et versions antérieures :

  • Votre projet doit utiliser un moteur construit à partir des sources (pas un binaire pré-compilé)
  • Ajoutez la ligne suivante à votre fichier Target.cs :
GlobalDefinitions.Add("FORCE_ANSI_ALLOCATOR=1");

Pour Unreal Engine 5.6 et versions ultérieures :

  • Fonctionne avec les builds du moteur compilés à partir des sources et les builds pré-compilés
  • Ajoutez les deux lignes suivantes à votre fichier Target.cs :
bOverrideBuildEnvironment = true;
StaticAllocator = StaticAllocatorType.Ansi;

Ceci force Unreal Engine à utiliser l'allocateur ANSI sur Android et iOS, correspondant à l'allocateur utilisé par ONNX Runtime.

Configuration Mac / Linux (UE 5.6+)​

Conflit du Plugin NNERuntimeORT

Si vous utilisez Unreal Engine 5.6 ou une version ultérieure sur les plateformes Mac ou Linux, vous rencontrerez un conflit de plugin qui empêche les modèles réalistes de fonctionner correctement.

Le Problème​

À partir de l'UE 5.6, le moteur inclut le plugin NNERuntimeORT, qui entre en conflit avec les modèles réalistes du plugin Runtime MetaHuman Lip Sync sur les plateformes Mac et Linux. Ce conflit empêche l'initialisation correcte de la fonctionnalité de synchronisation labiale réaliste.

Solution​

Pour résoudre ce conflit, vous devez modifier le fichier de configuration du plugin :

  1. Accédez au dossier d'installation de votre Unreal Engine
  2. Allez dans Engine/Plugins/Marketplace/
  3. Trouvez le dossier du plugin RuntimeTextToSpeech
  4. Ouvrez le fichier RuntimeTextToSpeech.uplugin dans un éditeur de texte
  5. Supprimez entièrement la section suivante :
,
  "Plugins": [
    {
      "Name": "NNERuntimeORT",
      "Enabled": true
    }
  ]

Notes importantes​

  • Cette modification n'affecte que les plateformes Mac et Linux. Les utilisateurs Windows n'ont pas besoin d'effectuer ce changement.
  • Ce correctif n'est requis que pour UE 5.6 et versions ultérieures. Les versions antérieures du moteur ne sont pas affectées.
  • Vous devrez peut-être répéter ce processus si vous mettez à jour le plugin, car les mises à jour restaureront le fichier de configuration d'origine.