SDL中按键响应延迟、多键无法同时触发的解决方法

问题说明 #

我用SDL开发游戏，已经实现了方向键控制矩形移动，但存在两个问题：

• 按下按键后有短暂延迟才开始持续移动，之后恢复正常
• 同时按住多个方向键（比如左+上）无法实现斜向移动，只能响应单个按键

当前事件循环代码：

while (!quit)
{
    if (SDL_PollEvent(&e))
    {
        if (e.type == SDL_QUIT) {
            quit = true;
        }
        else if (e.type == SDL_KEYDOWN)
        {
            switch (e.key.keysym.sym)
            {
                case SDLK_RIGHT:
                    squareX += 10;
            }
            switch (e.key.keysym.sym)
            {
                case SDLK_LEFT:
                    squareX -= 10;
            }
            switch (e.key.keysym.sym)
            {
                case SDLK_UP:
                    squareY -= 10;
            }
            switch (e.key.keysym.sym)
            {
                case SDLK_DOWN:
                    squareY += 10;
            }
        }
    }

完整代码如下：

#define SDL_MAIN_HANDLED

#include<SDL.h>
#include<iostream>



SDL_Window* mainWindow = NULL;
SDL_Surface* mainWindowSurf = NULL;
SDL_Renderer* mainRenderer = SDL_CreateRenderer(mainWindow, -1, 0);

int mainScreenWidth = 1280;
int mainScreenHeight = 720;

int squareX = 50;
int squareY = 50;

const int squareWidth = 50;
const int squareHeight = 100;

const int gravityAffect = 5;

bool mainGameInit();
void mainGameExit();

// Note to self - From here and to the next note comment, everything is functions.

bool mainGameInit()
{
    bool mainGameInitSuccess = true;

    if (SDL_Init(SDL_INIT_VIDEO) < 0)
    {
        std::cout << "SDL could not INIT. This time around, the window could not be created. For more details, SDL_ERROR: " << SDL_GetError() << std::endl;
        mainGameInitSuccess = false;
    }
    else
    {
        mainWindow = SDL_CreateWindow("Wednesday Night Dash",
            SDL_WINDOWPOS_UNDEFINED,
            SDL_WINDOWPOS_UNDEFINED,
            mainScreenWidth,
            mainScreenHeight,
            SDL_WINDOW_SHOWN);
        if (mainWindow == NULL)
        {
            std::cout << "SDL_Window could not be created! For more information, SDL_ERROR: " << SDL_GetError() << std::endl;
            mainGameInitSuccess = false;
        }
        else
        {
            // Create renderer after window creation
            mainRenderer = SDL_CreateRenderer(mainWindow, -1, 0);
            if (mainRenderer == NULL)
            {
                std::cout << "SDL_Renderer could not be created! For more information, SDL_ERROR: " << SDL_GetError() << std::endl;
                mainGameInitSuccess = false;
            }
        }
    }
    return mainGameInitSuccess;
}

void mainGameExit()
{
    SDL_DestroyWindow(mainWindow);
    mainWindow = NULL;

    SDL_Quit();
}

int main(int argc, char* args[])
{
    if (!mainGameInit())
    {
        std::cout << "Uh oh! SDL (The game code) Failed to init. For more information, SDL_ERROR: " << SDL_GetError() << std::endl;
    }
    else
    {
        SDL_Event e;
        bool quit = false;
        while (!quit)
        {
            if (SDL_PollEvent(&e))
            {
                if (e.type == SDL_QUIT) {
                    quit = true;
                }
                else if (e.type == SDL_KEYDOWN)
                {
                    switch (e.key.keysym.sym)
                    {
                        case SDLK_RIGHT:
                            squareX += 10;
                    }
                    switch (e.key.keysym.sym)
                    {
                        case SDLK_LEFT:
                            squareX -= 10;
                    }
                    switch (e.key.keysym.sym)
                    {
                        case SDLK_UP:
                            squareY -= 10;
                    }
                    switch (e.key.keysym.sym)
                    {
                        case SDLK_DOWN:
                            squareY += 10;
                    }
                }
            }

            // Clear screen
            SDL_SetRenderDrawColor(mainRenderer, 0, 0, 0, 255);
            SDL_RenderClear(mainRenderer);

            SDL_Rect squareRect = { squareX, squareY, squareWidth, squareHeight };
            SDL_SetRenderDrawColor(mainRenderer, 255, 0, 0, 255);
            SDL_RenderFillRect(mainRenderer, &squareRect);

            // Update screen
            SDL_RenderPresent(mainRenderer);
        }
    }

    mainGameExit();

    return 0;
}

问题原因 #

1. 按键延迟：SDL_KEYDOWN事件仅在按键按下时触发一次，之后系统会触发默认的按键重复延迟（模拟打字场景），导致移动前出现停顿。
2. 无法多键同时触发：每次SDL_PollEvent只能处理单个事件，同一时间仅能捕获一个按键的SDL_KEYDOWN信号，无法同时识别多个按键的按下状态。

解决方案 #

改用SDL_GetKeyboardState获取所有按键的实时状态，在游戏主循环的每一帧主动检查按键并更新矩形位置，同时添加帧率控制保证移动速度稳定。

修改后的完整代码：

#define SDL_MAIN_HANDLED

#include<SDL.h>
#include<iostream>

SDL_Window* mainWindow = NULL;
SDL_Renderer* mainRenderer = NULL;

int mainScreenWidth = 1280;
int mainScreenHeight = 720;

int squareX = 50;
int squareY = 50;

const int squareWidth = 50;
const int squareHeight = 100;
const int moveSpeed = 10; // 统一移动速度
const int frameDelay = 16; // 控制帧率，约60帧/秒

bool mainGameInit();
void mainGameExit();

bool mainGameInit()
{
    bool mainGameInitSuccess = true;

    if (SDL_Init(SDL_INIT_VIDEO) < 0)
    {
        std::cout << "SDL初始化失败，错误信息：" << SDL_GetError() << std::endl;
        mainGameInitSuccess = false;
    }
    else
    {
        mainWindow = SDL_CreateWindow("Wednesday Night Dash",
            SDL_WINDOWPOS_UNDEFINED,
            SDL_WINDOWPOS_UNDEFINED,
            mainScreenWidth,
            mainScreenHeight,
            SDL_WINDOW_SHOWN);
        if (mainWindow == NULL)
        {
            std::cout << "窗口创建失败，错误信息：" << SDL_GetError() << std::endl;
            mainGameInitSuccess = false;
        }
        else
        {
            mainRenderer = SDL_CreateRenderer(mainWindow, -1, SDL_RENDERER_ACCELERATED);
            if (mainRenderer == NULL)
            {
                std::cout << "渲染器创建失败，错误信息：" << SDL_GetError() << std::endl;
                mainGameInitSuccess = false;
            }
        }
    }
    return mainGameInitSuccess;
}

void mainGameExit()
{
    SDL_DestroyRenderer(mainRenderer);
    SDL_DestroyWindow(mainWindow);
    mainRenderer = NULL;
    mainWindow = NULL;

    SDL_Quit();
}

int main(int argc, char* args[])
{
    if (!mainGameInit())
    {
        std::cout << "游戏初始化失败，错误信息：" << SDL_GetError() << std::endl;
    }
    else
    {
        SDL_Event e;
        bool quit = false;
        Uint32 frameStart;
        int frameTime;

        while (!quit)
        {
            frameStart = SDL_GetTicks();

            // 处理退出等事件
            while (SDL_PollEvent(&e))
            {
                if (e.type == SDL_QUIT) {
                    quit = true;
                }
            }

            // 获取实时键盘状态并更新位置
            const Uint8* keyState = SDL_GetKeyboardState(NULL);
            if (keyState[SDL_SCANCODE_RIGHT]) {
                squareX += moveSpeed;
            }
            if (keyState[SDL_SCANCODE_LEFT]) {
                squareX -= moveSpeed;
            }
            if (keyState[SDL_SCANCODE_UP]) {
                squareY -= moveSpeed;
            }
            if (keyState[SDL_SCANCODE_DOWN]) {
                squareY += moveSpeed;
            }

            // 边界检测：防止矩形移出屏幕
            squareX = std::max(0, std::min(squareX, mainScreenWidth - squareWidth));
            squareY = std::max(0, std::min(squareY, mainScreenHeight - squareHeight));

            // 渲染流程
            SDL_SetRenderDrawColor(mainRenderer, 0, 0, 0, 255);
            SDL_RenderClear(mainRenderer);

            SDL_Rect squareRect = { squareX, squareY, squareWidth, squareHeight };
            SDL_SetRenderDrawColor(mainRenderer, 255, 0, 0, 255);
            SDL_RenderFillRect(mainRenderer, &squareRect);

            SDL_RenderPresent(mainRenderer);

            // 控制帧率，保证移动速度一致
            frameTime = SDL_GetTicks() - frameStart;
            if (frameDelay > frameTime) {
                SDL_Delay(frameDelay - frameTime);
            }
        }
    }

    mainGameExit();

    return 0;
}

修改要点说明 #

• 实时按键检测：通过SDL_GetKeyboardState直接获取所有按键的当前状态，每帧主动检查，彻底解决按键延迟和多键同时触发的问题。
• 帧率控制：添加SDL_GetTicks和SDL_Delay实现帧率锁定，避免不同性能设备上移动速度差异过大。
• 代码修复：修正原代码中渲染器初始化顺序错误的问题（原代码在窗口创建前初始化渲染器会导致空指针），移除无用的mainWindowSurf变量。
• 边界检测：新增屏幕边界限制，防止矩形移出可视区域（可根据需求调整或移除）。

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