.NET Maui 7使用外接键盘时如何隐藏软键盘？

问题描述 #

我开发了一个.NET Maui 7应用，尝试使用一款模拟外接键盘工作的条码扫描器。为接收扫描到的条码，我创建了一个标准Entry控件。现有代码如下：

// Button to start scanning
private void OnButtonClicked(object sender, EventArgs e)
{
    this.MyEntry.Focus();   // Focus on the entry        
    HideSoftKeyboard();
}

// Hide the soft keyboard
void HideSoftKeyboard()
{
    Microsoft.Maui.Handlers.EntryHandler.Mapper.AppendToMapping("MyCustomization", (handler, view) =>
    {
#if ANDROID
        handler.PlatformView.EditorAction += (s, e) =>
        {
            handler.PlatformView.InputType = Android.Text.InputTypes.Null;
        };

#elif IOS
        handler.PlatformView.EditingDidBegin += (s, e) =>
        {
            handler.PlatformView.InputView=new UIKit.UIView();
            
        };
#endif
    });
}   

当前代码可隐藏软键盘，但使用扫描器时，Entry输入第一个字符后软键盘会再次弹出，且输入速度极慢。请问如何禁用软键盘？或是有什么正确使用外接扫描器的方法？

一、彻底禁用Entry控件的软键盘 #

你的现有代码仅在特定事件触发时修改键盘设置，无法覆盖扫描器输入的场景，以下是分平台的修复方案：

Android平台 #

直接在控件获取焦点时强制设置InputType为Null，并主动隐藏软键盘，确保扫描器输入时不会触发键盘弹出：

#if ANDROID
handler.PlatformView.FocusChange += (s, e) =>
{
    if (e.HasFocus)
    {
        handler.PlatformView.InputType = Android.Text.InputTypes.Null;
        // 强制隐藏软键盘
        var imm = Android.App.Application.Context.GetSystemService(Android.Content.Context.InputMethodService) as Android.Views.InputMethods.InputMethodManager;
        imm.HideSoftInputFromWindow(handler.PlatformView.WindowToken, 0);
    }
};
#endif

iOS平台 #

除了设置空的InputView，还要清空InputAccessoryView，并通过短暂失焦再聚焦的方式彻底阻止键盘弹出：

#if IOS
handler.PlatformView.EditingDidBegin += (s, e) =>
{
    handler.PlatformView.InputView = new UIKit.UIView();
    handler.PlatformView.InputAccessoryView = new UIKit.UIView();
    // 强制重置焦点状态，确保键盘不弹出
    handler.PlatformView.ResignFirstResponder();
    handler.PlatformView.BecomeFirstResponder();
};
#endif

优化代码执行时机 #

不要每次点击按钮都重复配置Handler映射，而是在页面初始化时只执行一次：

protected override void OnAppearing()
{
    base.OnAppearing();
    // 仅配置一次Entry的键盘禁用逻辑
    Microsoft.Maui.Handlers.EntryHandler.Mapper.AppendToMapping("DisableKeyboard", (handler, view) =>
    {
#if ANDROID
        handler.PlatformView.FocusChange += (s, e) =>
        {
            if (e.HasFocus)
            {
                handler.PlatformView.InputType = Android.Text.InputTypes.Null;
                var imm = Android.App.Application.Context.GetSystemService(Android.Content.Context.InputMethodService) as Android.Views.InputMethods.InputMethodManager;
                imm.HideSoftInputFromWindow(handler.PlatformView.WindowToken, 0);
            }
        };
#elif IOS
        handler.PlatformView.EditingDidBegin += (s, e) =>
        {
            handler.PlatformView.InputView = new UIKit.UIView();
            handler.PlatformView.InputAccessoryView = new UIKit.UIView();
            handler.PlatformView.ResignFirstResponder();
            handler.PlatformView.BecomeFirstResponder();
        };
#endif
    });
}

private void OnButtonClicked(object sender, EventArgs e)
{
    MyEntry.Focus();
    // 无需再重复调用HideSoftKeyboard
}

二、外接扫描器的更优使用方式 #

模拟键盘的扫描器输入效率较低，推荐以下两种更高效的方案：

• 全局监听输入事件：无需依赖Entry控件，直接在页面或应用层面监听所有键盘输入，通过扫描器的输入特征（比如连续快速输入、结尾带回车/换行）捕获完整条码。Android可重写DispatchKeyEvent方法，iOS可监听UIKeyCommand或文本输入事件。
• 对接厂商SDK：如果扫描器支持蓝牙或提供专用SDK，直接对接SDK获取条码数据，绕过模拟键盘的方式，输入速度更快，也不会有软键盘问题。
• 自定义无输入控件：创建一个仅负责接收焦点和捕获输入事件的自定义View，完全不触发软键盘，性能比Entry控件更优。

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