A-阿里云移动推送配置

一、阿里云移动推送配置

目前物联云平台已接入阿里云移动推送功能，实现在离线状态下可以将设备产生的告警信息等重要消息及时推送到 APP 上。使用该功能是需要接入阿里云推送 SDK 并在管理台配置相应的应用及 Server API key 以启用功能。

1、获取 Server API key

访问阿里云EMAS控制台，选择【添加项目图标】，创建一个新项目（若已有项目则请跳过此步骤）并进入项目中

在项目中选择【添加应用】，根据指引创建应用并集成 FCM 以使用 Google 服务（若已有应用则请跳过此步骤）

从右上角头像图标入个账号设置，选择【accesskeys】进入 accessKey 管理界面

在【用户信息管理】界面，获取 AccesskeyID，Access Key Secret

在【应用管理】界面，即创建 APP 的页面，获取 APP 的 AppKey

注：

阿里移动推送集成请参考官方阿里移动集成文档

2、配置管理台 Server API Key

在获取到 Server API key 后，需要在物联云平台企业管理台配置相应的应用以支持推送功能

登录企业管理台
选择【开发平台】->【应用网关】->【新建应用】，创建一个应用（若已存在应用可跳过此步骤）
进入需要配置的应用，选择【启用】开启应用，在【应用配置】中勾选【启用阿里推送服务】
将以上获取的 AccessKeyID，AccessKeySecret，AppKey 填写入相应位置，然后【保存】

3、绑定移动端设备及应用

由于推送是针对应用进行的，所以每个移动端设备（手机或 Pad 等）都需要通过阿里的服务获取到设备的唯一 token，并且使用该 token 与管理台创建的应用进行绑定。（在 Android 中获取的是 DeviceId）

在应用配置界面，获取【应用ID】一栏的数据
确保 APP 成功集成阿里推送服务并测试正常（请参考官方的集成验证方式测试）
在 APP 中通过阿里移动推送 SDK 获取设备的 token 或 deviceId，详情请参考官方文档及官方 demo
将获取的设备的 token 与管理台中获取的应用ID通过 Restful 接口绑定
推送注册接口文档

UserMessageApi.RegisterAlipushRequest request = new UserMessageApi.RegisterAlipushRequest();
//应用ID，从物联云平台管理台创建的应用中获取的应用ID
request.appId = appId;
//当前移动设备token，来自阿里SDK中获取的设备ID
//PushServiceFactory.getCloudPushService().getDeviceId();
request.deviceToken = deviceToken;
//是否为通知
request.noticed = notified;
//通知打开方式
request.openType = openType;
//通知提醒方式
request.notifyType = notifyType;
if (openType == XLinkRestfulEnum.PushMessageOpenType.ACTIVITY) {
    request.activity = openInput;
} else if (openType == XLinkRestfulEnum.PushMessageOpenType.URL) {
    request.openUrl = openInput;
}
 
//接口调用的参数说明请根据接口文档提供
XLinkRestful.getApplicationApi()
        .postUserRegisterAlipush(XLinkUserManager.getInstance().getUid(), request)
        .enqueue(callback);

4、注意事项

管理台提供的推送功能是针对应用的，即必须有创建了应用并且应用配置了有效的阿里推送的 AccessKeyId、AccessKey、AccessKeySecret，设备与该应用绑定的情况下该设备才能接收到推送的消息；
推送时需要指定应用，如果未指定应用则无法获取到相应的推送消息

上次更新：2023-02-02