Bao gồm các cảnh Addressables

Trang này mô tả cách định cấu hình Android Performance Tuner để đưa các cảnh Addressables vào Unity.

Addressables cho phép nhà phát triển chủ động tải nội dung trong thời gian chạy. Trong đó có thể bao gồm những cảnh không có trong chế độ cài đặt bản dựng của Unity khi tệp .apk được tạo. Trước Android Performance Tuner 1.5.1, những cảnh đó không được Android Performance Tuner nhận dạng và không thể kiểm tra trong Play Console.

Yêu cầu

Để hỗ trợ cảnh Addressables, cần đáp ứng các yêu cầu sau:

  • Android Performance Tuner 1.5.1 trở lên
  • Unity 2019.3 trở lên
  • Gói Addressables 1.19.4 trở lên

Thêm cảnh Addressables

Để Android Performance Tuner nhận dạng các cảnh Addressables của bạn, hãy làm như sau:

  1. Khi bạn đã sẵn sàng kiểm thử ứng dụng, hãy chuyển đến Window > Android Performance Tuner > Setup (Cửa sổ > Android Performance Tuner > Thiết lập) rồi mở thẻ Addressables Settings (Cài đặt Addressables).

    Hình 1. Cửa sổ Addressables Settings (Cài đặt Addressables).

  2. Nhấp vào nút Update Addressables Scenes (Cập nhật cảnh Addressables).

Theo mặc định, tất cả các cảnh trong AddressableAssetSettingsDefaultObject đều có trong Android Performance Tuner. Cửa sổ này hiện hiển thị một danh sách bao gồm tất cả các cảnh đã được tìm thấy cùng với giá trị của các cảnh đó được lưu trong tệp proto.

Hình 2. Các cảnh Addressables do Android Performance Tuner liệt kê.

Cách thay đổi Đối tượng cài đặt Addressable kéo cảnh:

  1. Chuyển đến thư mục Assets/AndroidPerformanceTuner_gen/Runtime/Resources rồi mở đối tượng có thể tạo tập lệnh SetupConfig trong Inspector (Trình kiểm tra).

  2. Chèn đường dẫn đến Đối tượng cài đặt tuỳ chỉnh của bạn trong trường Addressables Settings Object Path (Đường dẫn đối tượng cài đặt Addressable), bao gồm cả tên tệp.

Bạn nên cập nhật các cảnh Addressables khi bố cục cảnh của bạn là bán kết để tránh các vấn đề về khả năng tương thích ngược.

Android Performance Tuner chỉ thu thập dữ liệu cho các cảnh có trong tệp .apk đã được tải lên Play Console.

Đặt lại cảnh Addressables

Bạn có thể đặt lại cảnh Addressable bằng cách nhấp vào Reset Addressables Scenes (Đặt lại cảnh Addressable) trong thẻ Addressables Settings (Cài đặt Addressable). Tuy nhiên, điều này sẽ làm hỏng khả năng tương thích với phiên bản đã phát hành hiện tại của ứng dụng.

Nếu bạn chủ động cập nhật đối tượng SetupConfig trong ứng dụng mà không phát hành bản phát hành mới, thì Play Console sẽ bị lỗi vì mối quan hệ giữa các giá trị liên quan đến cảnh sẽ không được bảo toàn.

Đặt cảnh Addressable trong chú giải

Nếu bạn đang sử dụng chú giải mặc định, Android Performance Tuner sẽ tự động được đặt đúng cảnh. Nếu bạn đang sử dụng chú giải tuỳ chỉnh, hãy gọi ConvertAddressableScenePathToAPTSceneIndex():

tuner.SetCurrentAnnotation(new Annotation
{
    Scene = (Scene) tuner.ConvertAddressableScenePathToAPTSceneIndex(scenePath),
    Difficulty = Difficulty.Medium
});