游戏状态持久化：在GameReset中保持FreeGame状态的技术实践

最新推荐文章于 2025-12-16 22:54:59 发布

原创最新推荐文章于 2025-12-16 22:54:59 发布 · 364 阅读

7 ·

CC 4.0 BY-SA版权

文章标签：

#游戏 #slots #java

Slots 同时被 2 个专栏收录

5 篇文章

订阅专栏

LibGDX

4 篇文章

订阅专栏

游戏状态持久化：在GameReset中保持FreeGame状态的技术实践

引言

在游戏开发中，状态管理是一个常见但复杂的挑战。特别是在涉及复杂游戏逻辑和UI交互的slot游戏中，如何在游戏重置(GameReset)后正确恢复各种状态，确保玩家体验的连贯性，是一个需要精心设计的技术问题。本文将分享我们在一个slot游戏项目中实现FreeGame状态持久化的实践经验。

问题背景

在我们的slot游戏项目中，FreeGame模式包含多个需要持久化的状态：

isFirstFreeSpin: 标记是否为FreeGame的第一次旋转
lionAnimationIndex: 当前播放的狮子动画索引
baseMultiplier: 基础倍数，影响UI显示
preFreeMultiply: 前一次FreeGame的倍数

这些状态在正常的游戏流程中能够正确工作，但在GameReset事件发生后，所有的本地变量都会被重置，导致UI显示异常和游戏逻辑错误。

解决方案架构

1. 定义持久化参数

首先，我们在GameConst类中定义用于存储这些状态的参数：

public class GameConst {
    public static final String FIRST_FREESPIN = "FirstFreeSpin";
    public static final String LION_ANIMATION_INDEX = "LionAnimationIndex";
    public static final String BASE_MULTIPLIER = "BaseMultiplier";
    public static final String PRE_FREE_MULTIPLY = "PreFreeMultiply";
    public static final String MULTIPLIER_COUNTER = "MultiplierCounter";
    public static final String PROGRESS_VALUE = "ProgressValue";
    public static final String SPIN_COUNT = "SpinCount";
    public static final String PROGRESS_COUNT = "ProgressCount";
    public static final String CURRENT_USE_MULTIPLIER = "CurrentUseMultiplier";
}

2. 状态保存策略

我们采用"即时保存"的策略，在状态改变时立即将其保存到GameData中：

private void setBaseMultiplier(int value) {
    baseMultiplier = value;
    GameData.setMathParamStringValue(GameConst.BASE_MULTIPLIER, String.valueOf(baseMultiplier));
    
    // 更新相关的UI显示
    for (int i = 0; i < 4; i++) {
        freeGameMultiplierDown[i].setText((baseMultiplier + i) + "X");
    }
}

3. 状态恢复机制

在GameReset事件中，我们恢复所有持久化的状态：

registerEvent(new GameResetEvent() {
    @Override
    public void execute(Object... obj) {
        boolean isFreeSpin = GameData.currentGameMode == GameMode.FreeGame;
        
        if(isFreeSpin) {
            // 恢复所有关键状态
            restorePersistedStates();
            restoreProgress();
            restoreMultiLionAnim();
            restoreButtonAnim();
        }
    }
});

private void restorePersistedStates() {
    // 恢复isFirstFreeSpin
    String firstFreeSpin = GameData.getMathParamStringValue(GameConst.FIRST_FREESPIN);
    isFirstFreeSpin = firstFreeSpin != null ? Boolean.parseBoolean(firstFreeSpin) : true;
    
    // 恢复Lion动画索引
    String lionIndexStr = GameData.getMathParamStringValue(GameConst.LION_ANIMATION_INDEX);
    if (lionIndexStr != null && !lionIndexStr.isEmpty()) {
        lionAnimationIndex = Integer.parseInt(lionIndexStr);
    }
    
    // 恢复baseMultiplier
    String baseMultiplierStr = GameData.getMathParamStringValue(GameConst.BASE_MULTIPLIER);
    if (baseMultiplierStr != null && !baseMultiplierStr.isEmpty()) {
        baseMultiplier = Integer.parseInt(baseMultiplierStr);
    }
    
    // 恢复preFreeMultiply
    String preFreeMultiplyStr = GameData.getMathParamStringValue(GameConst.PRE_FREE_MULTIPLY);
    if (preFreeMultiplyStr != null && !preFreeMultiplyStr.isEmpty()) {
        preFreeMultiply = Integer.parseInt(preFreeMultiplyStr);
    }
}

4. 状态重置管理

在FreeGame结束时，我们需要重置所有状态：

private void outFreeGameReset() {
    // 重置所有状态并保存
    isFirstFreeSpin = true;
    GameData.setMathParamStringValue(GameConst.FIRST_FREESPIN, String.valueOf(isFirstFreeSpin));
    
    lionAnimationIndex = 0;
    GameData.setMathParamStringValue(GameConst.LION_ANIMATION_INDEX, String.valueOf(lionAnimationIndex));
    
    setBaseMultiplier(2);
    setPreFreeMultiply(1);
    
    // 重置其他相关状态
    multiplierCounter = 0;
    progressValue = 0;
    spinCount = 0;
    progressCount = 0;
    
    // 保存重置后的状态
    GameData.setMathParamIntValue(GameConst.MULTIPLIER_COUNTER, multiplierCounter);
    GameData.setMathParamFloatValue(GameConst.PROGRESS_VALUE, progressValue);
    GameData.setMathParamIntValue(GameConst.SPIN_COUNT, spinCount);
}

技术难点与解决方案

1. 状态一致性

问题: 多个状态之间存在依赖关系，恢复时需确保一致性。

解决方案: 我们采用分层恢复策略：

首先恢复基础状态（boolean、int等简单类型）
然后恢复依赖状态（UI元素、动画等）
最后验证状态一致性

2. 性能优化

问题: 频繁的状态保存可能影响游戏性能。

解决方案:

使用setter方法封装状态保存，避免重复代码
批量保存相关状态
在状态真正改变时才触发保存

3. 错误处理

问题: 持久化数据可能损坏或格式不正确。

解决方案:

private int safeParseInt(String value, int defaultValue) {
    if (value != null && !value.isEmpty()) {
        try {
            return Integer.parseInt(value);
        } catch (NumberFormatException e) {
            Logger.warn("Failed to parse integer value: " + value);
        }
    }
    return defaultValue;
}

在GameRecall中的应用

持久化的状态数据不仅用于GameReset恢复，还可以在GameRecall（游戏回放）中重现游戏状态：

public class GameRecallFreeGame extends DrawableComponent {
    private void loadBlueLionImages() {
        // 从持久化数据中获取Lion动画索引
        String lionIndexStr = GameData.getGameRecallMathParamStringValue(GameConst.LION_ANIMATION_INDEX);
        int lionIndex = safeParseInt(lionIndexStr, 0);
        
        // 根据索引显示对应的狮子图片
        String imagePath = String.format("Recall/BlueLion_%02d", lionIndex + 1);
        BlueLion = ImageLoader.getInstance().load(imagePath, "BlueLion");
        addActor(BlueLion);
    }
}