应用研发平台EMAS消息转离线还应该设置哪些参数？

在应用研发平台 EMAS 中，消息转离线推送需要设置以下参数以确保设备在不在线时仍能接收到通知或消息。以下是详细的参数说明和配置要求：

1. Android 平台相关参数

1.1 辅助弹窗功能相关参数

• AndroidRemind

  • 描述: 当推送类型为消息且设备不在线时，是否启用辅助弹窗功能。默认值为 false，仅当 PushType=MESSAGE 时生效。
  • 取值:
  • true: 启用辅助弹窗功能。
  • false: 不启用辅助弹窗功能。
  • 重要提示: 如果启用辅助弹窗功能，必须正确配置以下参数：
  • AndroidPopupActivity: 指定点击通知后跳转的 Activity（需填写完整的包名+类名）。
  • AndroidPopupTitle: 设置辅助弹窗的通知标题。
  • AndroidPopupBody: 设置辅助弹窗的通知内容。

• StoreOffline

  • 描述: 是否保存离线消息。如果设置为 true，即使设备当前不在线，消息也会在设备上线后送达。
  • 取值:
  • true: 保存离线消息。
  • false: 不保存离线消息。

• AndroidExtParameters

  • 描述: 自定义扩展参数，用于传递额外信息。该参数需以 JSON 格式传入，否则会解析出错。
  • 示例:

  {"k1": "android", "k2": "v2"}
  

1.2 厂商通道相关参数

• AndroidBadgeAddNum 和 AndroidBadgeSetNum

  • 描述: 设置角标数字。
  • AndroidBadgeAddNum: 在原角标基础上累加指定值（仅华为/荣耀厂商通道有效）。
  • AndroidBadgeSetNum: 设置固定的角标数字（仅华为、荣耀、阿里云通道有效）。
  • 注意: 如果同时设置了 AndroidBadgeAddNum 和 AndroidBadgeSetNum，以 AndroidBadgeSetNum 为准。

• AndroidMusic

  • 描述: 华为厂商通道通知声音。需指定存放在客户端项目 app/src/main/res/raw/ 目录下的音频文件名（无需携带文件格式后缀）。
  • 示例: alicloud_notification_sound

2. iOS 平台相关参数

2.1 离线消息转通知

• iOSRemind

  • 描述: 当设备不在线时，是否将消息通过 APNs 通道转为通知送达。仅适用于生产环境。
  • 取值:
  • true: 启用离线消息转通知功能。
  • false: 不启用离线消息转通知功能。

• iOSApnsEnv

  • 描述: 指定 iOS 的推送环境。
  • 取值:
  • DEV: 开发环境。
  • PRODUCT: 生产环境。

• iOSRemindBody

  • 描述: iOS 消息转通知时使用的通知内容。仅当 iOSApnsEnv=PRODUCT 且 iOSRemind=true 时生效。

• iOSBadge 和 iOSBadgeAutoIncrement

  • 描述: 设置 iOS 应用图标右上角角标。
  • iOSBadge: 设置固定角标数字。
  • iOSBadgeAutoIncrement: 是否开启角标自增功能（需使用 V1.9.5 及以上版本 SDK）。
  • 注意: 如果启用了 iOSBadgeAutoIncrement，则 iOSBadge 必须为空。

3. 鸿蒙平台相关参数

3.1 辅助弹窗功能相关参数

• HarmonyRemind

  • 描述: 当推送类型为消息且设备不在线时，是否启用辅助弹窗功能。默认值为 false，仅当 PushType=MESSAGE 时生效。
  • 取值:
  • true: 启用辅助弹窗功能。
  • false: 不启用辅助弹窗功能。

• HarmonyRemindTitle 和 HarmonyRemindBody

  • 描述: 鸿蒙消息转通知时使用的通知标题和内容。仅当 HarmonyRemind=true 时生效。

• HarmonyCategory

  • 描述: 通知消息类别，用于标识消息类型并影响展示和提醒方式。例如：
  • IM: 即时聊天。
  • VOIP: 音视频通话。
  • MARKETING: 资讯营销类消息。
  • 详情: 参见鸿蒙官网 Notification.category 文档。

4. 其他通用参数

4.1 离线保存时间

• ExpireTime
  • 描述: 设置离线消息的失效时间。超过该时间后，消息将不再发送。最长可设置为 72 小时。
  • 示例:

  String expireTime = ParameterHelper.getISO8601Time(new Date(System.currentTimeMillis() + 72 * 3600 * 1000));
  pushRequest.setExpireTime(expireTime);
  

4.2 发送对象

• 描述: 设置本次推送的目标设备范围。可选项包括：
  • 所有设备。
  • 指定终端（根据设备 ID 推送）。
  • 指定账号（根据设备 ID 绑定的账号推送）。
  • 设备别名（Alias）。
  • 设备标签（Tag）。
  • 注意: 当选择指定终端、账号或别名时，支持上传 .txt 文件（最大 30M，UTF-8 编码，每行一条记录）。

总结

为了实现消息转离线推送，您需要根据目标平台（Android、iOS 或鸿蒙）正确配置上述参数。特别注意以下几点：
1. 辅助弹窗功能（如 AndroidRemind 和 HarmonyRemind）需配合相关参数（如 AndroidPopupActivity 和 HarmonyRemindTitle）使用。
2. 离线保存时间（ExpireTime）和 厂商通道参数（如 AndroidBadgeSetNum 和 iOSBadgeAutoIncrement）对推送效果至关重要。
3. 推送环境（如 iOSApnsEnv）需根据实际需求选择开发环境或生产环境。

通过合理配置这些参数，您可以确保消息在设备离线时仍能成功送达用户。