4. 用法

4.1. 发送通知

当您为推送通知注册设备时，您将收到您应该发布项目的 PubSub 节点的名称。按照 XEP-0357: Push Notifications 中的规定将项目发布到此节点将导致将推送通知传递到注册设备。

4.2. 注册设备

要注册设备，您需要执行推送通知组件中可用的临时命令 register-device。该命令将返回一个需要填写的表格。

表单由以下字段组成：

供应商

您要为其注册设备的提供商的 ID。它包含可用提供程序的列表，您需要选择一个合适的提供程序。

设备令牌

您的应用程序从设备或客户端库中检索到的唯一令牌，用于识别您要注册推送通知的设备。

当您提交此表单时，它将被处理并以 result 类型的表单进行响应。在此表单中，您将找到一个 node 字段，其中包含由 Push Notifications 组件创建的 PubSub 节点名称，您应该向其发布通知项目。这个返回的带有推送通知组件 jid 的节点应该作为 XMPP 推送服务的地址传递给您的 XMPP 服务器。

4.3. 注销设备

要取消注册设备，您需要执行推送通知组件中可用的临时命令 unregister-device。该命令将返回一个需要填写的表格。

此表单由以下字段组成：

供应商

您的设备注册的提供商的 ID。

设备令牌

您的应用程序从设备或客户端库中检索并在此推送通知组件中注册的唯一令牌。

当您提交此表单时，它将被处理并以 result 表单作为响应，通知您设备已成功从推送通知组件中注销。

4.4. 通过 HTTPS 取消注册设备

在 Tigase XMPP 服务器安装目录的 /scripts/rest/push/ 目录中有 REST API 处理程序（以 UnregisterDeviceHandler.groovy 脚本的形式）将启用端点（在开发指南中记录）以允许客户端即使没有对他们的 XMPP 服务器进行身份验证，也可以禁用他们的推送通知。

备注

建议不要使用 HTTP 公开此端点，而仅使用 HTTPS。