MAUI蓝牙自定义配对：如何弹窗让用户输入设备PIN完成配对？

问题场景 #

在Windows 10设备上配对蓝牙BLE设备时，设备会显示PIN码，需要在.NET 8 MAUI应用中弹出输入对话框，让用户输入该PIN码并提交至Windows BLE协议栈。当前实现中，PairingRequestedHandler_事件处理器内调用MAUI的DisplayPromptAsync时，UI会出现卡顿，尝试使用Dispatcher也无法解决。

现有代码 #

蓝牙配对核心类 #

using Windows.Devices.Bluetooth;
using Windows.Devices.Bluetooth.GenericAttributeProfile;
using Windows.Devices.Enumeration;

public static class BluetoothPairing
{
    public async Task<bool> PairAsync(BluetoothLEDevice bluetoothLeDevice, DevicePairingProtectionLevel devicePairingProtectionLevel = DevicePairingProtectionLevel.Default)
    {
        if (bluetoothLeDevice.DeviceInformation.Pairing.IsPaired)
            return true;
        
        var canPair = bluetoothLeDevice.DeviceInformation.Pairing.CanPair;
        if (!canPair)
            return false;
        
        try
        {
            bluetoothLeDevice.DeviceInformation.Pairing.Custom.PairingRequested += PairingRequestedHandler_;
            
            const DevicePairingKinds allowedDevicePairingKinds = DevicePairingKinds.ConfirmOnly
                                                                 | DevicePairingKinds.DisplayPin
                                                                 | DevicePairingKinds.ProvidePin
                                                                 | DevicePairingKinds.ConfirmPinMatch
                                                                 | DevicePairingKinds.ProvidePasswordCredential;
            
            var pairingResult = await bluetoothLeDevice.DeviceInformation.Pairing.Custom.PairAsync(
                pairingKindsSupported: allowedDevicePairingKinds,
                minProtectionLevel: devicePairingProtectionLevel
            );
            
            return pairingResult?.Status is DevicePairingResultStatus.Paired or DevicePairingResultStatus.AlreadyPaired;
        }
        finally
        {
            bluetoothLeDevice.DeviceInformation.Pairing.Custom.PairingRequested -= PairingRequestedHandler_;
        }
    }
}

存在问题的配对请求处理器 #

static async void PairingRequestedHandler_(DeviceInformationCustomPairing sender, DevicePairingRequestedEventArgs ea)
{
    //var deferral = ea.GetDeferral();
    // var tcs = new TaskCompletionSource();
    
    var appCurrent = Application.Current;
    if (appCurrent == null)
        return;
    
    var mainPage = Application.Current?.MainPage;
    if (mainPage == null)
        return;
    
    await appCurrent.Dispatcher.DispatchAsync(async () =>
    {
        //var deferral = ea.GetDeferral();
        try
        {
            var typedPin = await mainPage.DisplayPromptAsync(
                title: "Enter Pairing PIN",
                message: $"Type the PIN (ea.Pin='{ea.Pin}') displayed on the device to proceed:",
                accept: "OK",
                cancel: "Cancel"
            );
            
            if (string.IsNullOrEmpty(typedPin))
                return;
            
            ea.Accept(typedPin);
        }
        catch (Exception ex) //if a dialog is already open we will definitely get an exception
        {
            //tcs.TrySetException(ex);
        }
        finally
        {
            //deferral.Complete();
            
            // if (!tcs.Task.IsFaulted)
            // {
            //     tcs.TrySetCompleted(); // deferral.Complete();    
            // }
        }
    });
    
    // tcs.Task.GetAwaiter().GetResult(); //couldnt find a different way to wait for the async code to finish inside the handler
    
    // await tcs.Task;
}

解决方案 #

问题核心是未正确使用配对延迟对象（Deferral），且异步流程上下文管理混乱。以下是修复后的代码：

修改后的配对请求处理器 #

static async void PairingRequestedHandler_(DeviceInformationCustomPairing sender, DevicePairingRequestedEventArgs ea)
{
    // 获取延迟对象，告知Windows需等待用户操作完成再结束配对流程
    var deferral = ea.GetDeferral();
    try
    {
        var mainPage = Application.Current?.MainPage;
        if (mainPage == null)
        {
            ea.Reject();
            return;
        }

        // 确保UI操作在主线程执行，并等待操作结果
        var typedPin = await mainPage.Dispatcher.DispatchAsync(async () =>
        {
            return await mainPage.DisplayPromptAsync(
                title: "输入配对PIN码",
                message: $"请输入设备上显示的PIN码（PIN: {ea.Pin}）:",
                accept: "确认",
                cancel: "取消",
                placeholder: "输入PIN码"
            );
        });

        if (string.IsNullOrWhiteSpace(typedPin))
        {
            // 用户取消输入，主动拒绝配对
            ea.Reject();
            return;
        }

        // 提交PIN码完成配对
        ea.Accept(typedPin);
    }
    catch (Exception ex)
    {
        // 处理对话框异常（如已有对话框打开），拒绝配对
        ea.Reject();
    }
    finally
    {
        // 通知Windows配对流程已完成
        deferral.Complete();
    }
}

关键修复点 #

1. 强制使用Deferral：事件处理器开头必须调用ea.GetDeferral()，所有操作完成后调用deferral.Complete()，否则Windows会判定配对超时失败。
2. 简化Dispatcher调用：直接通过mainPage.Dispatcher.DispatchAsync执行UI操作并等待结果，避免嵌套异步导致的上下文混乱。
3. 明确处理取消场景：用户取消输入时调用ea.Reject()，避免流程挂起。
4. 异常兜底处理：捕获UI操作异常，确保配对流程能正常结束，避免资源泄漏。

额外优化建议 #

• 可添加PIN码格式验证：根据设备PIN码的常规长度（4/6位数字），在提交前校验输入格式，减少无效提交。

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