如何为Xamarin Forms应用手动通过Azure Notification Hub注册设备及解析PNS Handle

首先得理清几个核心概念，帮你打通当前的注册流程：

什么是PNS Handle？为什么它是必需的？ #

PNS Handle就是推送服务给设备分配的唯一标识：

• Android上是FCM Token，由Firebase Cloud Messaging生成
• iOS上是APNs Device Token，由Apple Push Notification service生成

Azure Notification Hub本身不直接和设备通信，它是通过FCM/APNs这些平台推送服务转发消息的。所以必须要有这个Handle，Azure才能知道要把推送消息发送到哪台具体设备——没有它，就算生成了RegistrationId，也只是一个空的标识，无法关联到实际设备。

你的后端代码问题在哪里？ #

你当前的代码只生成了RegistrationId，但没有把它和PNS Handle、设备平台信息绑定起来。要完成完整的注册，需要创建对应平台的RegistrationDescription实例，把Handle和RegistrationId关联后提交给Notification Hub。

修改后的后端实现方案 #

首先我们需要定义一个接收设备信息的模型，再调整注册方法：

1. 定义设备注册参数模型 #

public class DeviceRegistration
{
    public string Handle { get; set; } // 对应FCM Token或APNs Device Token
    public string Platform { get; set; } // 标识设备平台："Android" 或 "iOS"
    public IEnumerable<string> Tags { get; set; } // 可选，用于定向推送（比如用户ID、兴趣标签）
}

2. 完善RegisterDevice方法 #

public async Task<string> RegisterDevice([FromBody] DeviceRegistration deviceReg) 
{
    string registrationId = null;

    // 第一步：检查该PNS Handle是否已有关联注册，避免重复
    if (!string.IsNullOrEmpty(deviceReg.Handle))
    {
        var existingRegistrations = await hub.GetRegistrationsByChannelAsync(deviceReg.Handle, 100);
        foreach (var registration in existingRegistrations)
        {
            if (registrationId == null)
            {
                // 复用已有的RegistrationId
                registrationId = registration.RegistrationId;
            }
            else
            {
                // 删除重复的注册记录
                await hub.DeleteRegistrationAsync(registration);
            }
        }
    }

    // 第二步：如果没有找到现有注册，创建新的RegistrationId
    if (string.IsNullOrEmpty(registrationId))
    {
        registrationId = await hub.CreateRegistrationIdAsync();
    }

    // 第三步：根据平台创建对应Registration实例，绑定Handle和RegistrationId
    RegistrationDescription registration;
    switch (deviceReg.Platform.ToLower())
    {
        case "android":
            registration = new FcmRegistrationDescription(deviceReg.Handle)
            {
                RegistrationId = registrationId,
                Tags = deviceReg.Tags ?? new List<string>()
            };
            break;
        case "ios":
            registration = new ApnsRegistrationDescription(deviceReg.Handle)
            {
                RegistrationId = registrationId,
                Tags = deviceReg.Tags ?? new List<string>()
            };
            break;
        default:
            throw new ArgumentException("Unsupported platform provided.");
    }

    // 第四步：提交注册信息到Notification Hub
    await hub.CreateOrUpdateRegistrationAsync(registration);

    return registrationId;
}

Xamarin.Forms设备端如何获取并传递PNS Handle？ #

你需要在Android和iOS项目中分别获取对应的Handle，再调用后端的RegisterDevice接口：

Android端（获取FCM Token） #

在Firebase消息服务类中重写OnNewToken方法：

[Service]
[IntentFilter(new[] { "com.google.firebase.MESSAGING_EVENT" })]
public class MyFirebaseMessagingService : FirebaseMessagingService
{
    public override void OnNewToken(string token)
    {
        base.OnNewToken(token);
        // 调用后端接口提交Token和平台信息
        _ = SendRegistrationToBackend(token, "Android");
    }

    private async Task SendRegistrationToBackend(string handle, string platform)
    {
        var client = new HttpClient();
        var deviceReg = new DeviceRegistration
        {
            Handle = handle,
            Platform = platform,
            Tags = new List<string> { "your_user_id" } // 可选，添加用户标签方便定向推送
        };
        var json = JsonConvert.SerializeObject(deviceReg);
        var content = new StringContent(json, Encoding.UTF8, "application/json");
        var response = await client.PostAsync("your_backend_api_url/RegisterDevice", content);
        response.EnsureSuccessStatusCode();
    }
}

iOS端（获取APNs Device Token） #

在AppDelegate中重写RegisteredForRemoteNotifications方法：

public override void RegisteredForRemoteNotifications(UIApplication application, NSData deviceToken)
{
    // 格式化Device Token（去掉尖括号和空格）
    var token = deviceToken.Description.Trim('<', '>').Replace(" ", "");
    // 调用后端接口提交Token和平台信息
    _ = SendRegistrationToBackend(token, "iOS");
}

private async Task SendRegistrationToBackend(string handle, string platform)
{
    var client = new HttpClient();
    var deviceReg = new DeviceRegistration
    {
        Handle = handle,
        Platform = platform,
        Tags = new List<string> { "your_user_id" }
    };
    var json = JsonConvert.SerializeObject(deviceReg);
    var content = new StringContent(json, Encoding.UTF8, "application/json");
    var response = await client.PostAsync("your_backend_api_url/RegisterDevice", content);
    response.EnsureSuccessStatusCode();
}

关键总结 #

• PNS Handle是必需的：它是设备在推送服务中的唯一标识，没有它Azure无法定位到具体设备
• RegistrationId需要和Handle绑定：通过创建对应平台的RegistrationDescription，把两者关联起来，才能让Notification Hub明确消息推送目标
• 避免重复注册：每次注册前检查该Handle是否已有注册，复用或清理重复记录，保证注册信息的唯一性

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