Xbox UWP WebView应用重启手柄后控制器导航失效问题求助

核心问题分析 #

手柄休眠后重启，系统Gamepad设备状态会重置，但WebView内部的焦点管理和Gamepad事件监听未同步更新，导致事件无法正常触发。

具体修复方案 #

1. 监听手柄连接状态变化 #

在UWP应用层添加Gamepad.GamepadAdded和Gamepad.GamepadRemoved事件监听，手柄重新连接时强制刷新WebView的焦点状态与Gamepad事件绑定：

// 在主页面构造函数或App.xaml.cs中注册事件
Gamepad.GamepadAdded += Gamepad_GamepadAdded;
Gamepad.GamepadRemoved += Gamepad_GamepadRemoved;

private void Gamepad_GamepadAdded(object sender, Gamepad e)
{
    // 强制WebView获取焦点
    MyWebView.Focus(FocusState.Programmatic);
    // 通知Web端重置Gamepad导航逻辑
    MyWebView.InvokeScriptAsync("ResetGamepadNavigation", null);
}

private void Gamepad_GamepadRemoved(object sender, Gamepad e)
{
    // 手柄断开时清空Web端的Gamepad监听
    MyWebView.InvokeScriptAsync("ClearGamepadNavigation", null);
}

2. Web端同步重置Gamepad监听 #

在加载的网页中添加对应JS函数，收到UWP重置指令时重新注册Gamepad事件：

function ResetGamepadNavigation() {
    // 移除原有监听
    window.removeEventListener("gamepadconnected", handleGamepadConnected);
    window.removeEventListener("gamepaddisconnected", handleGamepadDisconnected);
    // 重新注册监听
    window.addEventListener("gamepadconnected", handleGamepadConnected);
    window.addEventListener("gamepaddisconnected", handleGamepadDisconnected);
    // 手动检测已连接的手柄，避免遗漏
    checkGamepads();
}

function ClearGamepadNavigation() {
    window.removeEventListener("gamepadconnected", handleGamepadConnected);
    window.removeEventListener("gamepaddisconnected", handleGamepadDisconnected);
}

function checkGamepads() {
    const gamepads = navigator.getGamepads();
    for (let i = 0; i < gamepads.length; i++) {
        if (gamepads[i]) {
            handleGamepadConnected({ gamepad: gamepads[i] });
        }
    }
}

3. 强制Web内部焦点同步 #

手柄重连后，确保Web页面内的可聚焦元素重新获取焦点，在Web端添加焦点重置逻辑：

function ResetFocus() {
    // 找到页面第一个可聚焦元素并设置焦点
    const focusableElements = document.querySelectorAll('button, [href], input, select, textarea, [tabindex]:not([tabindex="-1"])');
    if (focusableElements.length > 0) {
        focusableElements[0].focus();
    }
}

然后在UWP的Gamepad_GamepadAdded事件中调用：

MyWebView.InvokeScriptAsync("ResetFocus", null);

4. 禁用WebView默认焦点管理（可选） #

若WebView内置焦点逻辑与自定义Gamepad导航冲突，可禁用默认焦点处理：

// WebView初始化时设置
MyWebView.DefaultFocus = null;

调试建议 #

• 使用Xbox开发工具包的Gamepad Test工具，模拟手柄休眠/重启场景，验证事件触发是否正常。
• 在Web端添加console日志，记录Gamepad连接状态和焦点变化，排查事件丢失情况。
• 检查UWP应用后台权限，确保应用在手柄休眠期间不会被系统挂起导致监听失效。

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