Chuyển tới nội dung chính

Cấu hình theo Nền tảng

Hướng dẫn này bao gồm các yêu cầu và cấu hình thiết lập theo nền tảng cụ thể cho plugin Runtime Text To Speech.

Android và iOS - Sự cố Treo máy​

Trong một số trường hợp trên Android và iOS, có thể xảy ra hiện tượng treo máy trong thời gian chạy (ví dụ như trong quá trình kiểm thử TestFlight). Nguyên nhân là do các yêu cầu cấp phát bộ nhớ của thư viện ONNX Runtime bên dưới xung đột với bộ cấp phát mặc định của Unreal Engine trên các nền tảng này.

Để khắc phục, bạn cần ép buộc sử dụng bộ cấp phát ANSI trong tệp Target.cs của dự án:

Đối với Unreal Engine 5.5 trở về trước:

  • Dự án của bạn phải sử dụng engine được xây dựng từ mã nguồn (không phải bản nhị phân được biên dịch sẵn)
  • Thêm dòng sau vào tệp Target.cs của bạn:
GlobalDefinitions.Add("FORCE_ANSI_ALLOCATOR=1");

Dành cho Unreal Engine 5.6 trở lên:

  • Hoạt động với cả bản dựng từ mã nguồn và bản dựng đã biên dịch sẵn
  • Thêm hai dòng sau vào tệp Target.cs của bạn:
bOverrideBuildEnvironment = true;
StaticAllocator = StaticAllocatorType.Ansi;

Điều này buộc Unreal Engine sử dụng bộ cấp phát ANSI trên Android và iOS, khớp với bộ cấp phát được ONNX Runtime sử dụng.

Cấu hình Mac / Linux (UE 5.6+)​

Xung đột Plugin NNERuntimeORT

Nếu bạn đang sử dụng Unreal Engine 5.6 trở lên trên các nền tảng Mac hoặc Linux, bạn sẽ gặp phải xung đột plugin khiến các mô hình realistic không hoạt động chính xác.

Vấn đề​

Bắt đầu từ UE 5.6, engine bao gồm plugin NNERuntimeORT, plugin này xung đột với các mô hình realistic của plugin Runtime MetaHuman Lip Sync trên các nền tảng Mac và Linux. Xung đột này ngăn chức năng đồng bộ khẩu hình miệng realistic khởi tạo đúng cách.

Giải pháp​

Để giải quyết xung đột này, bạn cần sửa đổi tệp cấu hình plugin:

  1. Điều hướng đến thư mục cài đặt Unreal Engine của bạn
  2. Vào Engine/Plugins/Marketplace/
  3. Tìm thư mục plugin RuntimeTextToSpeech
  4. Mở tệp RuntimeTextToSpeech.uplugin trong một trình soạn thảo văn bản
  5. Xóa hoàn toàn phần sau:
,
  "Plugins": [
    {
      "Name": "NNERuntimeORT",
      "Enabled": true
    }
  ]

Ghi chú quan trọng​

  • Sửa đổi này chỉ ảnh hưởng đến các nền tảng Mac và Linux. Người dùng Windows không cần thực hiện thay đổi này.
  • Bản sửa lỗi này chỉ cần thiết cho UE 5.6 trở lên. Các phiên bản engine cũ hơn không bị ảnh hưởng.
  • Bạn có thể cần lặp lại quy trình này nếu bạn cập nhật plugin, vì các bản cập nhật sẽ khôi phục tệp cấu hình gốc.