Android自定义键盘输出错误字符（数字变带圈样式）求助

问题重现 #

你为三星S8制作了自定义键盘，keyboard.xml中已经正确设置了数字按键的ASCII码（49对应"1"、48对应"0"等），但点击数字按键时，输出的却是❶、❷这类带圈数字，而非预期的普通阿拉伯数字。

成因分析 #

这种情况通常和以下几个原因有关：

• 输入法服务的自定义按键处理逻辑：你继承InputMethodService实现的输入法核心类中，可能重写了onKey或onCodeInput方法，把接收到的ASCII数字码转换成了Unicode带圈数字字符；
• 三星系统级字符替换干扰：三星S8的系统设置或默认键盘功能中，可能开启了“文本替换”或“快捷输入”规则，自动把普通数字替换成带圈样式；
• 字符提交逻辑错误：如果在提交字符时没有直接使用ASCII码对应的字符，而是调用了自定义的字符映射表，也会出现这类异常。

修复步骤 #

1. 检查并修正输入法服务的按键处理代码

打开你实现的输入法服务类（通常继承自InputMethodService），查看是否有类似下面的错误转换逻辑：

@Override
public boolean onKey(int primaryCode, int[] keyCodes) {
    // 错误示例：将ASCII数字转换为带圈数字
    if (primaryCode >= 49 && primaryCode <= 57) {
        // 0x2776是带圈数字❶的Unicode编码
        char circledCharacter = (char) (0x2776 + primaryCode - 49);
        getCurrentInputConnection().commitText(String.valueOf(circledCharacter), 1);
        return true;
    }
    return super.onKey(primaryCode, keyCodes);
}

如果存在这段代码，修改为直接提交ASCII码对应的普通字符：

@Override
public boolean onKey(int primaryCode, int[] keyCodes) {
    // 直接提交ASCII码对应的字符
    getCurrentInputConnection().commitText(String.valueOf((char) primaryCode), 1);
    return super.onKey(primaryCode, keyCodes);
}

如果没有重写onKey方法，确保你调用的字符提交逻辑没有做额外转换。

2. 关闭三星系统的文本替换功能

在三星S8的系统设置中：

• 打开「设置」→「常规管理」→「语言和输入」→「屏幕键盘」→「三星键盘」→「文本替换」；
• 检查是否存在将"1"替换为"❶"、"2"替换为"❷"的规则，删除这类自定义替换项。

3. 验证键盘配置与按键日志

• 再次确认keyboard.xml中的codes属性确实是ASCII数字码（48-57），没有被误写为Unicode带圈数字的编码；
• 在输入法服务中添加日志，打印接收到的primaryCode值，确认按键触发时传递的是正确的ASCII码：

@Override
public boolean onKey(int primaryCode, int[] keyCodes) {
    Log.d("CustomKeyboard", "Received key code: " + primaryCode);
    // 其他提交逻辑
    return super.onKey(primaryCode, keyCodes);
}

通过日志确认代码接收到的是49、50等正确值，再检查提交的字符是否符合预期。

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