【FAQ】HarmonyOS SDK 闭源开放能力 —Push Kit

1.问题描述：

消息推送未接收到可以缓存多久？

解决方案：

"Push Kit接收方无法收到消息分两种情况：

1、如果接收端的设备离线，导致消息重新发送到接收端设备，则应用消息最多可以在Push Kit服务器侧缓存15天，该缓存时间可以在pushOptions中由ttl参数定义。

2、如果接收端设备在线，但是应用不在前台，导致推送后台消息时无法推送至应用，则该消息会缓存至端侧，最多可缓存7天。"

2.问题描述：

消息推送图片不展示。

解决方案：

"对于请求体中image字段有如下限制：

1、image字段支持图片格式为PNG、JPG、JPEG、BMP，图片长*宽建议小于128x128像素，若超过49152像素，则图片不展示。
2、Wearable不支持右侧大图标样式。
3、如果图片地址无法下载也不会展示，请确认图片链接有效。"

3.问题描述：

无法收到消息推送。

解决方案：

"可以根据如下步骤排查问题：

• 当收到资讯营销类消息时，由于静默通知仅在通知中心展示，并不会弹框提示，需要去通知中心查看。通知中心如下图，可以查看对应消息。

• 若终端上的app手动关闭了消息提醒方式，终端收到消息不会有提醒，需要打开所需的提醒方式。

• 打开AGC平台，按查询路径：“开发与服务>增长>推送服务>自助分析（Beta）”，在自助分析里面输入requestId和token，系统会自动分析消息推送失败的原因，注意requestId有效期为三天。
  Push token不是有效的token，建议您在应用启动时调用getToken()接口，若设备的Push Token发生变化，及时上报到您的应用服务器更新Push Token，以防由于Push Token失效导致收不到消息。

• 检查服务端发送请求时是否正确携带Authorization请求头，value为JWT格式字符串，是基于服务账号生成鉴权令牌。可参考：请求体结构说明。

• 推送后台消息用于内容不频繁更新的场景，不会显示通知、播放铃声或改变应用角标。终端设备接收到后台消息后，如果应用进程在前台则将消息内容传给应用；如果应用进程不在前台则缓存消息，等待应用启动后再传给应用。

• 如果设备离线，Push Kit会缓存消息，待设备上线后，再将消息推送给设备。

• 检查自分类权益是否已申请，并且打开自分类权益开关，请参考：申请推送场景化消息权益。

• 检查是否受到消息频控。

  • 调测阶段：每个项目每个自然日最多可推送1000条测试消息（非设备级，所有设备共用1000条），且不受场景化消息频控限制（即不区分通知消息类别、不区分场景化消息类别）。可以在消息发送请求体中设置pushOptions.testMessage为true，发送测试消息。
  • 正式发布阶段：单设备单应用下每个自然日最多可推送3000条消息，并受场景化消息频控限制。

• 参考推送消息跳转能力文档，检查module.json5中skills配置是否正确。

  • 应用只需要配置一条skill对象。

    • 设置action参数点击消息进入应用页面（若skills中添加了uris参数，则uris内容需为空）

    • 设置uris参数点击消息进入应用页面（skills中必须同时设置actions参数，actions参数需为空）

  • 应用需要配置多条skill对象。
    比如同时设置推送消息跳转能力和其他跳转能力（如NFC跳转、浏览器跳转等），可以在skills数组中创建不同的skill对象，分别映射对应的能力。"