Để sử dụng tệp mở rộng APK, bạn cần phải có Unity 2018.2
Để cải thiện tốc độ khung hình và chỉ số đo lường GPU, bạn cần sử dụng Unity phiên bản 2019.3.14 trở lên
Để hỗ trợ tính năng cảnh Addressables, bạn cần có Unity 2019.3 trở lên và gói Addressables 1.19.4 trở lên.
Tải trình bổ trợ xuống
Tải trình bổ trợ xuống qua kho lưu trữ GitHub. Chọn tải tệp .unitypackage xuống.
Nhập trình bổ trợ
Trước khi nhập trình bổ trợ, hãy đảm bảo dự án đang sử dụng .NET phiên bản 4.6.
Điều này áp dụng cho Unity phiên bản 2018.4 trở về trước (các phiên bản sau của Unity chỉ chứa .NET phiên bản 4.6).
Chọn File > Build Settings (Tệp > Cài đặt bản dựng). Đảm bảo Android được chọn làm nền tảng hiện tại.
Nhấp vào nút Player Settings (Cài đặt trình phát).
Trong phần Other Settings (Cài đặt khác), hãy tìm Scripting Runtime Version (Phiên bản thời gian chạy tập lệnh) rồi chọn .NET 4.6.
Trình bổ trợ này được cung cấp dưới dạng một Unity Package (Gói Unity) mà bạn có thể nhập vào dự án.
Chọn Assets > Import Package > Custom Package (Tài sản > Nhập gói > Gói tuỳ chỉnh) rồi chọn tệp .unitypackage bạn đã tải xuống.
Android Performance Tuner phiên bản 1.5.1 trở lên với Unity 2017
Để sử dụng Android Performance Tuner phiên bản 1.5.1 trở lên với Unity 2017 bạn cần thực hiện thêm các bước sau đây khi nhập trình bổ trợ này:
Chuyển đến thư mục Assets/AndroidPerformanceTuner/Editor.
Nhấp vào tệp Google.Android.PerformanceTuner.Editor để mở tệp đó trong Inspector (Trình kiểm tra).
Nhấp vào tham chiếu assembly bị thiếu rồi nhấp vào - để xoá tham chiếu đó.
Nhấp vào nút Apply (Áp dụng).
Hình 1. Thiếu tham chiếu đến assembly.
Chuyển đến thư mục Assets/AndroidPerformanceTuner/Runtime.
Nhấp vào tệp Google.Android.PerformanceTuner để mở tệp đó trong Inspector (Trình kiểm tra).
Lặp lại bước 3 để xoá 2 tham chiếu assembly bị thiếu.
Khởi động lại Unity.
Chuyển đến Window > AndroidPerformanceTuner > Setup (Cửa sổ > AndroidPerformanceTuner > Thiết lập) rồi xác minh rằng không có lỗi nào hiển thị.
Nhập lại trình bổ trợ sau khi xoá
Nếu bạn đang nhập lại trình bổ trợ sau khi xoá trình bổ trợ đó khỏi dự án, trước tiên, hãy xoá ANDROID_PERFORMANCE_TUNER_UTILITIES khỏi phần Player Settings > Scripting Define Symbols (Cài đặt trình phát > Ký hiệu định nghĩa tập lệnh).
Định cấu hình trình bổ trợ
Để định cấu hình trình bổ trợ, hãy làm như sau:
Đối với Unity phiên bản 2019.3.14 trở lên:
Bật thư viện Android Frame Pacing (Tốc độ khung hình Android). Android Performance Tuner sẽ sử dụng thư viện này để đo lường hiệu năng của trò chơi, bao gồm cả các biện pháp đo lường chuyên sâu hơn so với những chỉ số mà Unity báo cáo.
Hãy chọn File > Build Settings (Tệp > Cài đặt bản dựng) rồi nhấp vào nút Player Settings (Cài đặt trình phát).
Trong mục Resolution and Presentation (Độ phân giải và trình bày), hãy chọn hộp đánh dấu Optimized Frame Pacing (Tốc độ khung hình được tối ưu hoá).
Đồng bộ hoá quá trình kết xuất khung hình với khoảng trống dọc.
Trong phần Player Settings (Cài đặt trình phát), hãy chọn thẻ Quality (Chất lượng) rồi tìm trình đơn VSync Count (Số lượng VSync). Sử dụng lựa chọn bất kỳ (ngoại trừ Don't Sync (Không đồng bộ hoá)).
Các lựa chọn khác với Don't Sync (Không đồng bộ hoá) sẽ cho phép đo lường chính xác hơn khi liên kết với thư viện Android Frame Pacing.
(Đối với các phiên bản Unity trước năm 2019) Đặt hệ thống bản dựng thành Gradle. Chọn File > Build Settings (Tệp > Cài đặt bản dựng). Tìm Build System (Hệ thống bản dựng) rồi chọn Gradle.
Thêm quyền truy cập Internet. Trong phần Other Settings (Cài đặt khác), hãy tìm Internet Access (Quyền truy cập Internet) rồi chọn Require (Bắt buộc).
Nhập khoá API. Sau khi cài đặt trình bổ trợ này, bạn có thể nhập chính trình bổ trợ đó qua trình đơn Window > Android Performance Tuner > Setup (Cửa sổ > Android Performance Tuner > Thiết lập). Trên hộp thoại này, hãy chọn thẻ Settings (Cài đặt) rồi nhập khoá API của dự án Google Cloud vào trường API key (Khoá API).
Nội dung và mã mẫu trên trang này phải tuân thủ các giấy phép như mô tả trong phần Giấy phép nội dung. Java và OpenJDK là nhãn hiệu hoặc nhãn hiệu đã đăng ký của Oracle và/hoặc đơn vị liên kết của Oracle.
Cập nhật lần gần đây nhất: 2025-08-26 UTC.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-08-26 UTC."],[],[],null,["This page describes how to download, import, and configure the Unity plugin for\nAndroid Performance Tuner.\n\nRequirements\n\nTo use the plugin in your game, use a supported version of Unity:\n\n- Unity version 2017.4 or later and [.NET version 4.6](https://dotnet.microsoft.com/download/dotnet-framework/net46)\n- To use APK Expansion files, Unity 2018.2 is required\n- For improved frame pacing and GPU measurements, Unity version 2019.3.14 or later is required\n- For Addressables scenes support, Unity 2019.3 or later and [Addressables package 1.19.4](https://docs.unity3d.com/Packages/com.unity.addressables@0.8/manual/index.html) or later are required.\n\nDownload the plugin\n\nDownload the plugin from the\n[GitHub repository](https://github.com/android/tuningfork/releases). Select the\n`.unitypackage` file download.\n\nImport the plugin\n\nBefore importing the plugin, make sure your project is using .NET version 4.6.\nThis applies to Unity version 2018.4 and earlier (later versions of Unity\ncontain .NET version 4.6 only).\n\n1. Select **File \\\u003e Build Settings**. Make sure Android is selected as the current platform.\n2. Click the **Player Settings** button.\n3. Under **Other Settings** , find **Scripting Runtime Version** and select **.NET 4.6**.\n\nThe plugin is provided as a Unity Package that you can import in your project.\nSelect **Assets \\\u003e Import Package \\\u003e Custom Package** and select the\n`.unitypackage` file you downloaded.\n\nAndroid Performance Tuner version **1.5.1 or higher** with **Unity 2017**\n\nUsing Android Performance Tuner version **1.5.1 or higher** with **Unity 2017**\nrequires the following additional steps when importing the plugin:\n\n1. Go to the **Assets/AndroidPerformanceTuner/Editor** folder.\n2. Click the **Google.Android.PerformanceTuner.Editor** file to open it in the **Inspector**.\n3. Click the missing assembly reference and then click **-** to remove it.\n4. Click the **Apply** button.\n\n\n **Figure 1.** Missing assembly reference.\n5. Go to the **Assets/AndroidPerformanceTuner/Runtime** folder.\n\n6. Click the **Google.Android.PerformanceTuner** file to open it in the\n Inspector.\n\n7. Repeat **step 3** to remove the two missing assembly references.\n\n8. Restart Unity.\n\n9. Go to **Window \\\u003e AndroidPerformanceTuner \\\u003e Setup** and verify that no errors\n are displayed.\n\nRe-importing the plugin after deletion\n\nIf you're re-importing the plugin after removing it from the project, remove\n`ANDROID_PERFORMANCE_TUNER_UTILITIES` from\n**Player Settings \\\u003e Scripting Define Symbols** first.\n\nConfigure the plugin\n\nTo configure the plugin, do the following:\n\n1. For Unity version 2019.3.14 or later:\n\n - Enable the Android Frame Pacing library. Android Performance Tuner will use\n this library to measure the performance of your game, including more\n in-depth measures than what Unity alone reports.\n\n Select **File \\\u003e Build Settings** and click the **Player Settings** button.\n Under **Resolution and Presentation** , select the **Optimized Frame Pacing**\n checkbox.\n - Synchronize the frame rendering with vertical blanks.\n\n From the Player Settings, select the **Quality** tab and find the\n **VSync Count** menu. Use any selection (except **Don't Sync** ).\n Selections other than **Don't Sync** enable more precise measurements in\n conjunction with the Android Frame Pacing library.\n2. (For versions of Unity prior to 2019) Set the build system to Gradle. Select\n **File \\\u003e Build Settings** . Find **Build System** and select **Gradle**.\n\n3. Add the internet access permission. Under **Other Settings** , find\n **Internet Access** and select **Require**.\n\n4. Enter your API key. Once the plugin is installed, you can enter it from the\n **Window \\\u003e Android Performance Tuner \\\u003e Setup** menu. On this dialog, select the\n **Settings** tab and enter the\n [API key from your Google Cloud project](/games/sdk/performance-tuner/unity/enable-api)\n into the **API key** field.\n\n | **Note:** If you don't enter your API key, Android Performance Tuner won't send your game performance data to the Google Play Console. Android Performance Tuner logs this error, and you can see the error using `adb logcat`. (You will run `adb logcat` in the next section to confirm the proper operation of Android Performance Tuner.)\n\n\n **Figure 2.** Settings tab in the plugin"]]
Hình 1. Thiếu tham chiếu đến assembly.
Hình 2. Thẻ Settings (Cài đặt) trong trình bổ trợ