写点什么

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

作者:HarmonyOS SDK
  • 2024-10-29
    贵州
  • 本文字数:2041 字

    阅读完需:约 7 分钟

1.问题描述:


目前华为推送 API 使用的是 v2 或者 v1 版本,请问目前最新的鸿蒙 next 使用 v3 版本是否兼容 v2 或者 v1,反过来将 v2 或者 v1 的 api 可以推送鸿蒙 next 的设备吗?


解决方案:


v3 接口兼容向非 HarmonyOS NEXT 设备推送,老版本接口不兼容向 HarmonyOS NEXT 设备推送。


2.问题描述:


获取 Push Token 报错 Get push token catch error: 1000900010 Illegal application identity.


解决方案:


检查以下配置项是否正确:


1、确认 AppGallery Connect 上配置的应用签名证书指纹与应用实际证书是否一致, API 9 以上应用需要选择“添加公钥指纹 (HarmonyOS API 9 及以上)”的方式配置。https://developer.huawei.com/consumer/cn/doc/app/agc-help-signature-info-0000001628566748#section5181019153511


2、在项目模块级别下的 src/main/module.json5(例如 entry/src/main/module.json5)中配置 client_id,需要使用项目设置->常规页面->应用->OAuth 2.0 客户端 ID(凭据)中的 Client ID。https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/push-preparations-0000001727885250#section792641732919


注意:配置证书指纹后生效需要一定时间,建议 30-60 分钟后重试。


3.问题描述:


  1. push-type=0 的普通消息如果要带图片,是否要先调图片风控接口?

  2. 图片风控接口返回的 expireTime 最长截止时间是多久?


解决方案:


1、目前发送 push-type:0 通知消息未限制必须图片风控,图片符合文档说明规格即可。https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/push-send-alert-0000001862404293-V5#section62011739001


2、expireTime 一般为 7 天。


4.问题描述:


应用在 AppGallery Connect 申请了调试证书、开启了推送服务,app 项目中配置了调试证书签名,应用也配置了 client_id,但是获取 token 失败,报错信息 get token fail:, {error.name:Error, error.message:Illegal application identity.} ,json:{"code":1000900010}}


解决方案:


1,在 API 管理中,打开相关服务的 API。会有一定的延迟,一般有 10 分钟左右。


2,  应用在 AppGallery Connect 上创建时未选择 HarmonyOS 应用类型。


3,module.json5 文件中 metadata 节点下 clientid 写正确。需要直接写 client_id 的信息,不能通过 $符引用资源文件中的值,当前无法解析这种引用方式。


4,签名证书使用这个选项中的 配置方式 “选择 SHA256 公钥指纹‘’。


  a、生成配置指纹: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/push-preparations-0000001727885250#section388942317518


  b、配置证书指纹: https://developer.huawei.com/consumer/cn/doc/app/agc-help-signature-info-0000001628566748#section5181019153511 如果以上方式无法解决,请通过如下方式抓取日志以便分析,联系方式https://developer.huawei.com/consumer/cn/support/feedback/#/


  1. 执行:hdc hilog > xxxx.log


  2. 复现场景


  3. 停止脚本执行


  4. 在目录下获取日志信息


5.问题描述:


推送 VoIP 呼叫消息和音视频界面是都内置的吗?开发者是否只需配置一个 UI 其他方面不用考虑?


解决方案:


1、音视频页面应用需要自定义,文档示例代码提供的页面效果仅供开发参考,不代表最终效果。


2、VoIP 呼叫消息负责拉起应用的进程,在进程内完成通话状态上报弹出呼叫横幅通知,监听通话状态回调,被呼叫页面加载等操作。铃声、震动、音视频效果等需要开发者自行适配完成。https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/push-voip-V5


6.问题描述:


通知扩展消息体现:


push-type: 2// Request Body{   "payload": {     "extraData": "通知扩展场景携带的额外数据",     "notification": {       "category": "EXPRESS",        "title": "通知标题",       "body": "通知内容",       "clickAction": {         "actionType": 0       }     }  }}
复制代码


notification 这部分信息是否会以通知方式展示?如果展示,那么和 onReceiveMessage 要返回的 RemoteNotificationContent 有什么区别?extraData 这部分信息是不是通过 onReceiveMessage 方式传递?


解决方案:


  1. notification-----这部分信息是否会以通知方式展示?


会在 RemoteNotificationContent 中 return 中展示


https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/push-send-extend-noti-V5


  1. extraData------这部分信息是不是通过 onReceiveMessage 方式传递?


扩展消息是可以通过 onReceiveMessage 获取。


https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/push-remote-extension-ability-V5?catalogVersion=V5


  1. onReceiveMessage 如果返回空是什么结果?


有可能是没有扩展消息的权限


https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/push-apply-right-V5#section159981112245

用户头像

HarmonyOS SDK

关注

HarmonyOS SDK 2022-06-16 加入

HarmonyOS SDK通过将HarmonyOS系统级能力对外开放,支撑开发者高效打造更纯净、更智能、更精致、更易用的鸿蒙原生应用,和开发者共同成长。

评论

发布
暂无评论
【FAQ】HarmonyOS SDK 闭源开放能力 —Push Kit(4)_HarmonyOS_HarmonyOS SDK_InfoQ写作社区