Android平台OpenGL（SDL）应用设置显示刷新率失效问题

修复方案 #

1. 窗口创建时明确指定刷新率 #

别只在Surface层面设置，创建SDL窗口时就得把高刷参数加上：

SDL_Window* window = SDL_CreateWindow(
    "你的应用名称",
    SDL_WINDOWPOS_CENTERED, SDL_WINDOWPOS_CENTERED,
    screenWidth, screenHeight,
    SDL_WINDOW_OPENGL | SDL_WINDOW_FULLSCREEN_DESKTOP | SDL_WINDOW_ALLOW_HIGHDPI
);
// 手动设置窗口刷新率为120Hz
SDL_DisplayMode mode;
SDL_GetCurrentDisplayMode(0, &mode);
mode.refresh_rate = 120;
SDL_SetWindowDisplayMode(window, &mode);

用SDL_WINDOW_FULLSCREEN_DESKTOP让窗口匹配屏幕原生参数，再强制指定120Hz，大概率能触发高刷。

2. 检查EGL配置是否适配高刷 #

三星S21的高刷可能需要特定EGL配置，初始化OpenGL上下文前先选对配置：

const EGLint configAttribs[] = {
    EGL_SURFACE_TYPE, EGL_WINDOW_BIT,
    EGL_RED_SIZE, 8,
    EGL_GREEN_SIZE, 8,
    EGL_BLUE_SIZE, 8,
    EGL_DEPTH_SIZE, 24,
    EGL_STENCIL_SIZE, 8,
    EGL_RENDERABLE_TYPE, EGL_OPENGL_ES3_BIT,
    EGL_NONE
};

// 获取配置后创建Surface，再强制设置帧率
EGLSurface surface = eglCreateWindowSurface(eglDisplay, eglConfig, window, NULL);
SDL_Surface* sdlSurface = SDL_GetWindowSurface(window);
SDL_SetSurfaceFrameRate(sdlSurface, 120);

单纯调用Surface.setFrameRate可能不够，EGL层面的配置得跟上。

3. 补全AndroidManifest.xml的高刷声明 #

Manifest里必须加这个元数据，不然三星系统可能不给高刷权限：

<application ...>
    <meta-data android:name="android.supports_high_refresh_rate" android:value="true" />
    <activity
        android:name=".你的主Activity"
        android:configChanges="orientation|keyboardHidden|screenSize"
        android:launchMode="singleTask"
        android:resizeableActivity="true">
        ...
    </activity>
</application>

加上android.supports_high_refresh_rate，告诉系统你的应用支持高刷。

4. 升级SDL版本 #

你的SDL版本可能太老，存在高刷支持的bug。SDL的NDK示例正常，说明新版本已经修复了这个问题，直接更到最新稳定版（比如2.28.0及以上）试试。

5. 关闭VSync手动控帧 #

OpenGL的VSync可能锁死60Hz，关掉它自己控制帧率：

// 关闭SDL的垂直同步
SDL_SetHint(SDL_HINT_RENDER_VSYNC, "0");

// 渲染循环里手动控制120帧
Uint32 lastFrame = SDL_GetTicks();
while (appRunning) {
    Uint32 now = SDL_GetTicks();
    if (now - lastFrame >= 1000 / 120) {
        // 执行渲染
        glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT);
        // ... 你的渲染代码
        eglSwapBuffers(eglDisplay, eglSurface);
        lastFrame = now;
    }
    // 处理事件
    SDL_Event event;
    while (SDL_PollEvent(&event)) {
        // ... 事件处理逻辑
    }
}

绕开系统的VSync锁，自己控制渲染间隔。

内容的提问来源于stack exchange，提问作者Gravitysensation