1. 项目概述：为什么你的Unity安卓游戏需要适配多档刷新率？

如果你是一名Unity游戏开发者，尤其是专注于移动平台的，那么“卡顿”这个词一定是你最不想听到的玩家反馈之一。在安卓设备上，玩家体验的流畅度不仅取决于你的代码优化和美术资源，更与一个底层硬件特性紧密相关——屏幕刷新率。过去，绝大多数手机屏幕都锁定在60Hz，我们只需要保证游戏稳定跑在60FPS，就能提供流畅的体验。但现在，情况完全不同了。从90Hz到120Hz，再到144Hz甚至更高，高刷新率屏幕已经成为中高端安卓手机的标配。如果你的游戏还停留在“60Hz世界”，那么在90Hz或120Hz的设备上，你可能会遇到一个尴尬的局面：游戏明明能跑满60帧，但玩家依然感觉“不跟手”、“有拖影”或者“莫名卡顿”。这背后的核心原因，就是游戏的渲染帧率与屏幕的物理刷新率不同步。

想象一下，你的游戏引擎（Unity）正在以固定的60次/秒的频率绘制画面，而手机的屏幕却以90次/秒的频率刷新显示。这就好比两个人一起跑步，一个每秒钟跑60步，另一个每秒钟跑90步，他们的步伐永远无法对齐。在屏幕上，这会导致一种叫做“画面撕裂”或“帧时间不一致”的现象，即使帧数很高，视觉上的卡顿感和操作延迟依然存在。更糟糕的是，一些设备为了兼容，可能会强制将高刷屏“降频”到60Hz运行，这不仅浪费了硬件优势，还可能因为系统的帧率管理策略引入额外的延迟。

因此，为你的Unity安卓游戏主动适配多档刷新率（如60Hz、90Hz、120Hz），不再是“锦上添花”的优化，而是“雪中送炭”的必备技能。它意味着你的游戏能够主动探测并匹配设备屏幕的最佳刷新率，让每一帧渲染都在最合适的时机提交给屏幕显示，从而彻底释放高刷屏的潜力，实现真正的“指哪打哪”的跟手体验。本教程将带你从原理到实践，完成一次完整的适配，让你告别因刷新率不匹配导致的卡顿，为玩家提供顶级的流畅体验。

2. 核心原理与Unity引擎机制解析

在动手写代码之前，我们必须搞清楚Unity引擎在安卓平台上处理刷新率的核心机制。这能帮助你在遇到问题时，知道该从哪个方向排查。

2.1 安卓屏幕刷新率的基础概念

屏幕刷新率（Refresh Rate），单位是赫兹（Hz），代表屏幕每秒钟刷新画面的次数。60Hz即每秒刷新60次，每次刷新持续约16.67毫秒。这个刷新过程是屏幕硬件的行为，是连续不断的。而游戏帧率（FPS， Frames Per Second）是游戏引擎（如Unity）每秒钟能够渲染并提交到屏幕的完整画面数量。理想的流畅状态是FPS等于或略高于屏幕刷新率，并且每一帧的渲染完成时机，恰好赶在屏幕下一次刷新开始之前（即垂直同步， V-Sync）。

在安卓系统中，应用可以通过WindowManager获取当前屏幕支持的刷新率列表，并请求系统将窗口的刷新率设置为其中某一个值。系统会尽力满足，但最终生效的刷新率可能受设备电量、热管理策略或系统设置的影响。

2.2 Unity的帧率管理与Application.targetFrameRate

Unity开发者最熟悉的帧率控制接口是Application.targetFrameRate。将其设置为-1表示不限制帧率（尽可能跑高），设置为60则期望帧率锁定在60FPS。但这里有一个至关重要的误区：在默认情况下，Application.targetFrameRate控制的是游戏的逻辑更新与渲染循环的频率，它并不直接等同于或控制屏幕的硬件刷新率。

当Application.targetFrameRate设置为60，而手机屏幕是120Hz时，Unity引擎仍然会尝试每秒更新60次。但屏幕以120Hz刷新，这意味着同一帧画面可能会被屏幕显示两次，或者引擎渲染的帧与屏幕刷新周期错位，导致不均匀的帧呈现时间，从而产生卡顿感。

2.3 Unity的“优化帧步调”（Optimized Frame Pacing）

从Unity 2019.3版本开始，针对安卓平台引入了一个关键设置：Optimized Frame Pacing。你可以在Edit -> Project Settings -> Player -> Android settings -> Optimization下找到它。

这个功能的作用是，让Unity引擎的渲染循环与安卓系统的显示子系统（Choreographer）进行更紧密的同步。当勾选此选项后，Unity会尝试使每一帧的渲染完成时机，对齐到屏幕下一次刷新的垂直同步信号（VSync）。更重要的是，在高版本Unity（如2021.3 LTS及以上）中，当开启Optimized Frame Pacing后，Unity会尝试自动使用设备屏幕支持的最高刷新率。

这听起来像是“一键解决”的方案，但实际使用中你会发现它并不完美：

1. 行为不确定：它“尝试”使用最高刷新率，但具体行为可能因Unity版本、设备型号和系统版本而异。在某些设备上，它可能无法正确获取或切换到90Hz/120Hz。
2. 缺乏精细控制：你无法指定一个备选刷新率列表（如优先120Hz， 失败则90Hz， 最后60Hz）。如果最高刷新率（如144Hz）导致你的游戏无法稳定运行，反而会引发更严重的卡顿。
3. 无法动态切换：在游戏运行时，你无法根据场景复杂度（如从菜单切换到战斗场景）动态地、安全地在不同刷新率间切换。

因此，完全依赖Optimized Frame Pacing是不够的。我们需要一种更主动、更可控的方式，直接与安卓系统对话，来管理我们游戏窗口的刷新率。

2.4 核心解决方案：使用Android Java API

最终的解决方案，是绕过Unity引擎的部分封装，直接调用安卓原生的Java API。核心步骤包括：

1. 获取Window对象：通过Unity提供的UnityPlayer当前Activity。
2. 获取WindowManager和Display对象：用于查询屏幕能力。
3. 获取支持的刷新率列表：使用Display.getSupportedRefreshRates()（旧API）或Display.getSupportedModes()（新API）来获取设备支持的所有刷新率模式。
4. 创建并应用WindowManager.LayoutParams：创建一个新的布局参数对象，设置其preferredRefreshRate（旧）或preferredDisplayModeId（新），然后应用到游戏窗口。

通过这种方式，我们直接告诉安卓系统：“我的应用窗口希望以这个特定的刷新率运行。” 系统会尽力满足，从而确保Unity渲染的每一帧都能在正确的刷新周期内提交和显示。

3. 环境准备与Unity项目设置

在开始编写代码之前，我们需要确保Unity项目和开发环境配置正确。这一步是后续所有工作的基础，配置错误会导致代码无法编译或运行异常。

3.1 Unity版本与模块选择

首先，推荐使用Unity 2021.3 LTS或更高版本。长期支持版本更加稳定，并且对高刷新率适配的相关API支持更好。确保在安装Unity Hub时，为你的目标版本勾选了“Android Build Support”模块，并且包含了“Android SDK & NDK Tools”和“OpenJDK”。这些是编译安卓应用所必需的。

3.2 配置Player Settings（关键步骤）

打开File -> Build Settings， 确保Android平台被选中，然后点击Player Settings按钮。

1. Other Settings 面板：

   • Graphics APIs： 确保Vulkan和/或OpenGL ES 3被包含。高刷新率渲染对图形API有一定要求，Vulkan通常能提供更好的性能和更可控的渲染调度。你可以将Vulkan放在首位尝试。
   • Identification：
     • Package Name： 设置一个符合安卓规范的反向域名格式包名，如com.YourCompany.YourGame。
     • Version和Bundle Version Code： 设置好应用版本。
   • Configuration：
     • Scripting Backend： 推荐使用IL2CPP。它比Mono能生成性能更好的代码，并且是64位应用所必需的（Google Play要求）。
     • Target Architectures： 勾选ARM64。这是现代安卓设备的架构，必须勾选。

2. Resolution and Presentation 面板：

   • 这里通常保持默认即可。但注意Fullscreen Mode可以是Fullscreen Window或Exclusive Fullscreen（如果支持），这取决于你的游戏类型。

3. Android settings 面板（重点）：

   • 找到Optimization栏目。
   • 取消勾选Optimized Frame Pacing。是的，我们要禁用Unity的自动管理，因为我们将实现自己的、更可控的刷新率管理逻辑。如果这里勾选了，可能会和我们自己的代码产生冲突或导致不可预测的行为。

3.3 准备Android SDK与NDK路径

确保Unity能正确找到你的Android SDK和NDK路径。在Edit -> Preferences -> External Tools中，检查Android部分的路径。如果为空或路径不正确，可以点击Download按钮让Unity自动下载，或者手动指向你本地已有的SDK目录。

注意：手动管理SDK时，请确保SDK Tools中安装了必要的版本，特别是Platform-Tools和Build-Tools。使用Unity自带的下载工具通常是最省事的选择。

3.4 创建脚本目录与准备工具类

在Unity项目的Assets文件夹下，创建一个有组织的脚本文件夹结构，例如Scripts/Runtime/AndroidRefreshRate。我们将在这里放置所有相关的C#脚本。

由于我们需要调用安卓Java API，会频繁使用AndroidJavaClass和AndroidJavaObject。为了方便，我们可以先创建一个简单的工具类来封装一些常用的操作，比如获取当前Activity。

// Assets/Scripts/Runtime/AndroidRefreshRate/AndroidUtils.cs using UnityEngine; public static class AndroidUtils { private static AndroidJavaObject _currentActivity; /// <summary> /// 获取UnityPlayer的当前Activity对象。 /// 这是一个耗资源的操作，建议缓存结果。 /// </summary> public static AndroidJavaObject GetCurrentActivity() { if (_currentActivity == null) { using (AndroidJavaClass unityPlayer = new AndroidJavaClass("com.unity3d.player.UnityPlayer")) { _currentActivity = unityPlayer.GetStatic<AndroidJavaObject>("currentActivity"); } } return _currentActivity; } /// <summary> /// 获取一个安卓系统类的静态字段值。 /// </summary> public static T GetAndroidStaticField<T>(string className, string fieldName) { using (AndroidJavaClass clazz = new AndroidJavaClass(className)) { return clazz.GetStatic<T>(fieldName); } } }

这个工具类会在后续的步骤中频繁使用。有了这些基础准备，我们就可以开始编写核心的刷新率管理代码了。

4. 核心实现：获取与设置刷新率

这是整个适配过程的核心部分。我们将编写一个RefreshRateManager类，它负责探测设备能力，并提供接口来动态设置游戏窗口的刷新率。

4.1 探测设备支持的刷新率

我们需要编写一个方法，来获取当前安卓设备屏幕支持的所有刷新率。这里需要注意API级别的兼容性。

// Assets/Scripts/Runtime/AndroidRefreshRate/RefreshRateManager.cs using System; using System.Collections.Generic; using UnityEngine; public class RefreshRateManager : MonoBehaviour { // 存储探测到的可用刷新率列表（单位：Hz） public List<float> SupportedRefreshRates { get; private set; } = new List<float>(); // 当前生效的刷新率 public float CurrentRefreshRate { get; private set; } /// <summary> /// 初始化并获取设备支持的刷新率列表。 /// 需要在主线程调用，且最好在游戏启动早期（如Awake或Start中）执行。 /// </summary> public void Initialize() { SupportedRefreshRates.Clear(); // 方法1：尝试使用新的Display.Mode API (API level 23, Android 6.0+) TryGetModesViaDisplayMode(); // 方法2：如果新API失败或返回空，尝试使用旧的RefreshRate API if (SupportedRefreshRates.Count == 0) { TryGetRatesViaLegacyAPI(); } // 方法3：如果以上都失败，添加一个默认的60Hz if (SupportedRefreshRates.Count == 0) { Debug.LogWarning("无法获取设备刷新率列表，将使用默认60Hz。"); SupportedRefreshRates.Add(60f); } // 去重并排序（从高到低） SupportedRefreshRates.Sort((a, b) => b.CompareTo(a)); Debug.Log($"支持的刷新率列表: {string.Join("Hz, ", SupportedRefreshRates)}Hz"); // 尝试获取并设置一个合理的初始刷新率（例如，优先选择120Hz或90Hz，否则选最高） SetOptimalRefreshRate(); } private void TryGetModesViaDisplayMode() { try { AndroidJavaObject activity = AndroidUtils.GetCurrentActivity(); AndroidJavaObject window = activity.Call<AndroidJavaObject>("getWindow"); AndroidJavaObject windowManager = window.Call<AndroidJavaObject>("getWindowManager"); AndroidJavaObject display = windowManager.Call<AndroidJavaObject>("getDefaultDisplay"); // Display.getSupportedModes() 返回一个Display.Mode[]数组 AndroidJavaObject[] modes = display.Call<AndroidJavaObject[]>("getSupportedModes"); if (modes != null) { foreach (var mode in modes) { // 从Display.Mode对象中获取刷新率 float refreshRate = mode.Call<float>("getRefreshRate"); // 四舍五入到最近的整数，因为有些设备返回的是59.94之类的值 int roundedRate = Mathf.RoundToInt(refreshRate); if (!SupportedRefreshRates.Contains(roundedRate)) { SupportedRefreshRates.Add(roundedRate); } } } } catch (Exception e) { Debug.Log($"使用Display.Mode API获取刷新率失败: {e.Message}"); } } private void TryGetRatesViaLegacyAPI() { try { AndroidJavaObject activity = AndroidUtils.GetCurrentActivity(); AndroidJavaObject window = activity.Call<AndroidJavaObject>("getWindow"); AndroidJavaObject windowManager = window.Call<AndroidJavaObject>("getWindowManager"); AndroidJavaObject display = windowManager.Call<AndroidJavaObject>("getDefaultDisplay"); // 旧方法：Display.getSupportedRefreshRates() 返回一个float[]数组 float[] rates = display.Call<float[]>("getSupportedRefreshRates"); if (rates != null) { foreach (float rate in rates) { int roundedRate = Mathf.RoundToInt(rate); if (!SupportedRefreshRates.Contains(roundedRate)) { SupportedRefreshRates.Add(roundedRate); } } } } catch (Exception e) { Debug.Log($"使用旧版RefreshRate API获取刷新率失败: {e.Message}"); } } }

4.2 实现设置刷新率的方法

获取列表后，我们需要实现一个方法来实际改变窗口的刷新率。同样，我们需要处理新旧API。

// 接上段代码，仍在 RefreshRateManager.cs 中 /// <summary> /// 请求将窗口刷新率设置为指定值。 /// </summary> /// <param name="refreshRateHz">目标刷新率（Hz），必须是SupportedRefreshRates列表中的值。</param> /// <returns>设置是否成功。</returns> public bool SetRefreshRate(float refreshRateHz) { if (!SupportedRefreshRates.Contains(refreshRateHz)) { Debug.LogError($"尝试设置不支持的刷新率: {refreshRateHz}Hz。请从支持列表中选择。"); return false; } try { AndroidJavaObject activity = AndroidUtils.GetCurrentActivity(); AndroidJavaObject window = activity.Call<AndroidJavaObject>("getWindow"); AndroidJavaObject windowManager = window.Call<AndroidJavaObject>("getWindowManager"); // 获取当前的WindowManager.LayoutParams AndroidJavaObject layoutParams = window.Call<AndroidJavaObject>("getAttributes"); // 方法1：尝试使用新的preferredDisplayModeId (API level 23+) bool success = TrySetViaDisplayModeId(window, layoutParams, refreshRateHz); // 方法2：如果新方法失败，尝试使用旧的preferredRefreshRate if (!success) { success = TrySetViaPreferredRefreshRate(layoutParams, refreshRateHz); } if (success) { // 将修改后的LayoutParams应用回窗口 window.Call("setAttributes", layoutParams); CurrentRefreshRate = refreshRateHz; Debug.Log($"刷新率已设置为: {CurrentRefreshRate}Hz"); // 同步设置Unity的targetFrameRate，建议设置为刷新率或刷新率的整数倍/分数 // 例如，对于120Hz屏幕，可以设targetFrameRate为120、60、40、30等。 Application.targetFrameRate = Mathf.RoundToInt(CurrentRefreshRate); return true; } else { Debug.LogError("设置刷新率失败，新旧API均未生效。"); return false; } } catch (Exception e) { Debug.LogError($"设置刷新率时发生异常: {e.Message}"); return false; } } private bool TrySetViaDisplayModeId(AndroidJavaObject window, AndroidJavaObject layoutParams, float targetRate) { try { AndroidJavaObject windowManager = window.Call<AndroidJavaObject>("getWindowManager"); AndroidJavaObject display = windowManager.Call<AndroidJavaObject>("getDefaultDisplay"); AndroidJavaObject[] modes = display.Call<AndroidJavaObject[]>("getSupportedModes"); int targetModeId = -1; foreach (var mode in modes) { float modeRate = mode.Call<float>("getRefreshRate"); if (Mathf.Approximately(modeRate, targetRate)) { targetModeId = mode.Call<int>("getModeId"); break; } } if (targetModeId != -1) { // 设置preferredDisplayModeId字段 layoutParams.Set<int>("preferredDisplayModeId", targetModeId); return true; } } catch (Exception e) { Debug.Log($"使用preferredDisplayModeId设置失败: {e.Message}"); } return false; } private bool TrySetViaPreferredRefreshRate(AndroidJavaObject layoutParams, float targetRate) { try { // 设置preferredRefreshRate字段（旧API，单位是fps，即Hz） layoutParams.Set<float>("preferredRefreshRate", targetRate); return true; } catch (Exception e) { Debug.Log($"使用preferredRefreshRate设置失败: {e.Message}"); } return false; } /// <summary> /// 根据设备能力，设置一个最优的初始刷新率。 /// 策略：优先选择120Hz，其次是90Hz，否则选择支持列表中的最高刷新率。 /// </summary> private void SetOptimalRefreshRate() { float desiredRate = 60f; // 默认回退值 if (SupportedRefreshRates.Contains(120f)) desiredRate = 120f; else if (SupportedRefreshRates.Contains(90f)) desiredRate = 90f; else if (SupportedRefreshRates.Count > 0) desiredRate = SupportedRefreshRates[0]; // 列表已排序，第一个是最高值 if (SetRefreshRate(desiredRate)) { Debug.Log($"已自动设置最优刷新率: {desiredRate}Hz"); } else { Debug.LogWarning("自动设置最优刷新率失败，将保持系统默认。"); } }

4.3 创建管理器实例并集成到游戏启动流程

我们需要在游戏启动时创建并初始化这个管理器。一个简单的方法是在初始场景中创建一个永不销毁的GameObject来挂载它。

// Assets/Scripts/Runtime/AndroidRefreshRate/RefreshRateBootstrapper.cs using UnityEngine; public class RefreshRateBootstrapper : MonoBehaviour { public static RefreshRateManager Instance { get; private set; } [SerializeField] private bool enableOnAwake = true; void Awake() { if (Instance != null) { Destroy(gameObject); return; } Instance = gameObject.AddComponent<RefreshRateManager>(); DontDestroyOnLoad(gameObject); if (enableOnAwake && Application.platform == RuntimePlatform.Android) { Instance.Initialize(); } } }

将RefreshRateBootstrapper脚本挂载到一个空的GameObject上，并将这个GameObject放入你的游戏启动场景（通常是第一个加载的场景）。这样，游戏一开始就会初始化刷新率管理器，并尝试设置最优刷新率。

重要提示：SetRefreshRate的调用可能会触发窗口重新布局或短暂的渲染管线重置，不建议在每帧或高频调用。通常只在游戏启动、切换前后台、或玩家在游戏内手动更改设置时调用。

5. 高级策略与性能调优

简单地设置最高刷新率并不总是最佳选择。高刷新率意味着GPU和CPU需要在更短的时间内（例如120Hz下每帧只有8.33毫秒）完成一帧的所有工作，这对性能提出了严峻挑战。如果游戏无法稳定维持目标帧率，频繁掉帧的体验会比稳定60帧更糟糕。因此，我们需要一套智能的策略。

5.1 动态刷新率切换策略

一个优秀的游戏应该能根据当前负载动态调整刷新率。例如：

• 菜单/低负载场景：使用最高刷新率（120Hz），提供极致的滑动和动画流畅度。
• 复杂3D战斗场景：如果无法稳定120FPS，则自动降至90Hz或60Hz，以换取更稳定的帧生成时间和更低的功耗发热。

我们可以创建一个简单的性能探针来指导切换：

// Assets/Scripts/Runtime/AndroidRefreshRate/AdaptiveRefreshRateController.cs using System.Collections; using UnityEngine; public class AdaptiveRefreshRateController : MonoBehaviour { public RefreshRateManager refreshRateManager; [Header("性能监测")] public float performanceSamplingDuration = 2.0f; // 每次采样的时长 public int targetFPSThresholdPercent = 85; // 当平均FPS低于目标刷新率的此百分比时，考虑降档 private float samplingTimer; private int frameCount; private float lastSampleTime; [Header("刷新率档位")] public float[] refreshRateTiers = { 120f, 90f, 60f }; // 从高到低排列 private int currentTierIndex = 0; void Start() { if (refreshRateManager == null) refreshRateManager = RefreshRateBootstrapper.Instance; if (refreshRateManager == null) { Debug.LogError("未找到RefreshRateManager！"); enabled = false; return; } // 初始化当前档位 float currentRate = refreshRateManager.CurrentRefreshRate; currentTierIndex = System.Array.IndexOf(refreshRateTiers, currentRate); if (currentTierIndex < 0) currentTierIndex = 0; StartCoroutine(PerformanceMonitoringRoutine()); } IEnumerator PerformanceMonitoringRoutine() { while (true) { yield return new WaitForSeconds(performanceSamplingDuration); EvaluateAndAdjustRefreshRate(); } } private void EvaluateAndAdjustRefreshRate() { if (refreshRateManager == null) return; float currentTargetRate = refreshRateTiers[currentTierIndex]; float averageFPS = frameCount / (Time.time - lastSampleTime); // 计算当前FPS是否达到目标刷新率的阈值要求 bool isPerformanceAdequate = averageFPS >= (currentTargetRate * targetFPSThresholdPercent / 100f); if (!isPerformanceAdequate && currentTierIndex < refreshRateTiers.Length - 1) { // 性能不足，尝试降到下一档 int newTierIndex = currentTierIndex + 1; float newRate = refreshRateTiers[newTierIndex]; if (refreshRateManager.SupportedRefreshRates.Contains(newRate)) { if (refreshRateManager.SetRefreshRate(newRate)) { currentTierIndex = newTierIndex; Debug.Log($"性能不足，刷新率由{currentTargetRate}Hz降至{newRate}Hz。平均FPS: {averageFPS:F1}"); } } } // 可选：如果性能非常充裕，可以考虑升档（这里逻辑更复杂，需考虑功耗和温度，暂不实现） // 重置采样计数器 frameCount = 0; lastSampleTime = Time.time; } void Update() { frameCount++; } /// <summary> /// 供外部调用，强制切换到指定档位（例如进入菜单场景时）。 /// </summary> public void RequestRefreshRateTier(int tierIndex) { if (tierIndex >= 0 && tierIndex < refreshRateTiers.Length) { float requestedRate = refreshRateTiers[tierIndex]; if (refreshRateManager.SupportedRefreshRates.Contains(requestedRate)) { if (refreshRateManager.SetRefreshRate(requestedRate)) { currentTierIndex = tierIndex; } } } } }

5.2 帧率（Application.targetFrameRate）的匹配策略

设置了屏幕刷新率后，Application.targetFrameRate该如何设置？这里有几种常见策略：

1. 1:1 匹配：targetFrameRate = 屏幕刷新率。这是最理想的情况，每一帧都对应一次屏幕刷新，延迟最低。前提是你的游戏性能必须能稳定跑满这个帧率。
2. 1/2 匹配：targetFrameRate = 屏幕刷新率 / 2。例如在120Hz屏幕上锁定60FPS。这能确保每一帧被显示两次，帧呈现时间依然均匀，避免了画面撕裂，同时大大降低了性能压力。这是性能与流畅度之间一个非常好的折中点。
3. 可变刷新率（VRR）适配：如果设备支持（如部分游戏手机），可以配合Application.targetFrameRate = -1（不限制），并依靠系统的可变刷新率技术（如高通Q-Sync）来同步。但这需要更底层的支持，且Unity默认不开启，实现更复杂。

建议策略：在SetRefreshRate方法成功调用后，立即将Application.targetFrameRate设置为新的刷新率值。然后，通过性能监测（如上面的自适应控制器），如果发现无法稳定，再动态地将targetFrameRate降低为刷新率的一半。同时，在Unity的Quality Settings中，确保VSync Count设置为Don't Sync，因为我们已经通过安卓API控制了刷新率同步，再开启Unity的垂直同步可能会造成冲突或额外延迟。

5.3 功耗与发热管理

高刷新率意味着更高的功耗。在移动设备上，这直接转化为更快的电量消耗和更多的发热。发热又会触发系统的温控降频，导致性能下降，形成恶性循环。

管理建议：

• 提供图形质量选项：让玩家可以在“高帧率（高功耗）”和“高画质（低帧率）”之间选择。
• 在检测到设备温度过高时自动降档：可以通过安卓的BatteryManager或第三方插件获取粗略的温度信息，或者在游戏内监测帧率骤降来间接判断，然后主动将刷新率切换到更低档位。
• 连接充电器时使用高刷：可以检测充电状态，在插电时启用更高刷新率，在用电池时保守一些。

6. 测试、调试与常见问题排查

适配完成后，必须在真机上进行详尽的测试。不同厂商、不同型号、不同安卓版本的设备，其行为可能差异巨大。

6.1 测试设备矩阵

理想情况下，你应该至少准备以下类型的设备进行测试：

• 高刷旗舰机：支持120Hz的机型（如各品牌近两年的旗舰）。
• 中端高刷机：支持90Hz的机型。
• 传统60Hz设备：作为基准和兼容性测试。
• 不同芯片平台：高通骁龙、联发科天玑等，它们的驱动和调度策略可能不同。

6.2 关键测试场景与日志输出

在RefreshRateManager的关键节点添加详细的日志输出，方便在adb logcat中过滤查看。

// 在Initialize和SetRefreshRate方法中，使用Debug.Log输出详细信息 Debug.Log($"[RefreshRateManager] 初始化开始，当前Unity targetFrameRate: {Application.targetFrameRate}"); // ... 获取列表后 Debug.Log($"[RefreshRateManager] 最终支持的刷新率列表: {string.Join(", ", SupportedRefreshRates)}"); // ... 设置成功后 Debug.Log($"[RefreshRateManager] 刷新率设置成功为 {newRate}Hz， 已同步设置Application.targetFrameRate为 {Application.targetFrameRate}");

在游戏中创建简单的测试UI，显示当前生效的刷新率、实时帧率(FPS)、以及设备支持的所有刷新率列表。这能让你快速验证功能是否生效。

6.3 常见问题与解决方案速查表

下表列出了开发过程中可能遇到的典型问题及其排查思路：

6.4 使用ADB命令验证

在测试时，adb命令是非常强大的验证工具。连接设备后，可以执行以下命令：

1. 查看当前窗口信息：

   adb shell dumpsys window | grep -A 5 -B 5 "mCurrentRefreshRate"

   或者更精确地查找你的游戏窗口：

   adb shell dumpsys window windows | grep -E "Window #|preferredRefreshRate"

   这可以查看系统记录的窗口首选刷新率。

2. 监控SurfaceFlinger的刷新率：

   adb shell dumpsys SurfaceFlinger | grep "refresh-rate"

   这可以查看系统表面合成器实际使用的刷新率。

3. 实时查看帧生成时间（需要系统权限较高，可能在某些设备上不适用）：

   adb shell dumpsys gfxinfo your.package.name

   将your.package.name替换为你的游戏包名。这个命令能输出详细的帧渲染时间统计，帮助你判断帧率是否稳定。

通过结合游戏内日志和adb命令的输出，你可以精确地确认你的刷新率设置是否真正被系统采纳并生效。