AndroidUtilCode中KeyboardUtils获取软键盘高度的解决方案

在Android游戏开发中，处理软键盘高度获取是一个常见需求，特别是在横屏游戏场景下。Blankj的AndroidUtilCode库提供了KeyboardUtils工具类来简化这一过程，但在实际使用中开发者可能会遇到一些特定问题。

问题背景

当开发者需要在横屏游戏中点击EditText或EditBox时获取软键盘高度，通常会使用KeyboardUtils.registerSoftInputChangedListener方法。然而，实际测试发现：

1. 如果不先调用KeyboardUtils.fixAndroidBug5497方法，则无法正确获取软键盘高度
2. 调用fixAndroidBug5497方法会导致游戏界面整体上移，这可能不符合某些游戏的设计需求

技术原理分析

Android软键盘高度获取机制

Android系统本身没有提供直接获取软键盘高度的API，开发者通常需要通过以下方式间接获取：

1. 监听布局变化：通过监听Activity根视图的布局变化来计算软键盘高度
2. 使用ViewTreeObserver：观察视图树的全局布局变化

fixAndroidBug5497的作用

这个方法主要是为了解决Android系统的一个已知bug（Issue 5497），该bug会导致在某些情况下：

• 软键盘弹出时无法正确调整窗口大小
• 布局变化监听器无法正常触发
• 软键盘高度计算不准确

解决方案

方案一：自定义软键盘高度监听

可以不依赖fixAndroidBug5497方法，自行实现软键盘高度监听：

View rootView = activity.getWindow().getDecorView().findViewById(android.R.id.content);
rootView.getViewTreeObserver().addOnGlobalLayoutListener(new ViewTreeObserver.OnGlobalLayoutListener() {
    @Override
    public void onGlobalLayout() {
        Rect rect = new Rect();
        rootView.getWindowVisibleDisplayFrame(rect);
        int screenHeight = rootView.getRootView().getHeight();
        int keyboardHeight = screenHeight - rect.bottom;
        
        if (keyboardHeight > screenHeight / 3) {
            // 软键盘高度有效
            onKeyboardHeightChanged(keyboardHeight);
        }
    }
});

方案二：修改布局处理方式

对于横屏游戏，可以调整Window的softInputMode属性：

<activity
    android:name=".YourActivity"
    android:windowSoftInputMode="adjustNothing|stateHidden" />

然后在代码中手动处理布局变化：

getWindow().setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_ADJUST_NOTHING);

方案三：结合两种方式

1. 先使用fixAndroidBug5497获取正确的软键盘高度
2. 记录下这个高度值
3. 在后续的界面中手动调整布局，而不依赖系统的自动调整

最佳实践建议

1. 横屏游戏的特殊处理：横屏模式下，软键盘行为与竖屏不同，需要特别注意
2. 性能考虑：避免频繁计算软键盘高度，可以在首次获取后缓存该值
3. 兼容性测试：在不同Android版本和设备上进行充分测试
4. 用户体验：确保软键盘弹出时不会遮挡关键游戏UI元素

总结

在Android游戏开发中处理软键盘高度时，理解底层原理比直接使用工具类更重要。虽然AndroidUtilCode的KeyboardUtils提供了便利的方法，但在特定场景下可能需要自定义实现。通过分析布局变化、理解Window管理机制，开发者可以找到更适合自己游戏需求的解决方案。