概况问题
收不到推送,插件费用到期?
关于 Push SDK 包体积问题?
上架隐私合规相关问题?
概念解释
提供推送接入方法对比
接入方法 | 集成方式对比 | 功能对比 |
插件快速集成: 不再需要逐个厂商填写配置,控制台下载引入 json 配置文件,即可完成所有手机厂商的推送信息配置。 支持按需集成一个或者多个对应厂商的推送渠道包,更加满足合规要求。 不需要客户处理推送注册、token 上报、前后台状态上报等,接入后插件自动闭环。 不再需要关注和添加打点和上报逻辑,开启功能后插件自行上报和汇总,支持链路排查和指标统计等。 插件封装界面跳转、图标自定义等方法,直接使用即可。 | 普通消息推送。 全员标签推送。 自定义界面跳转。 推送自定义样式。 设备推送状态查询。 全链路排查工具。 推送记录和指标统计分析。 | |
需要自行集成多个厂商推送 SDK,接入成本高。 需要自行构建多端逻辑。 自建通道维护成本高,同时极易引起消息堵塞、延迟高,触达效率低。 消息接收失败、发送失败等各类问题需自行排查并解决。 收集用户隐私数据不当会导致 App 下架,严重影响业务。 | 仅支持普通消息推送。 |
系统服务问题
海外推送如何配置?
支持的厂商通道:FCM、华为、OPPO 和 APNs。
FCM 通道必备条件:设备可访问海外网站、安装 GMS 服务、成功集成 TIMPush。
国内设备大多无 GMS 服务,不支持 FCM。
接入过程问题
解决接入冲突问题(第三方推送客户端与 TIMPush 冲突)?
【Flutter】接入 tencent_cloud_chat_push 版本号8.1+时 调用注册推送 registerPush 登录账号被踢出或推送异常等情况如何处理?

删除 registerPush 方法 sdkAppId 和 appKey 参数。
【Flutter】配置 FCM 推送信息后,使用 OPPO 机型测试,由于插件内部默认走 OPPO 通道,导致注册推送时,报“ oppo 推送注册失败”,该如何解决?
注册推送之前调用
setPushBrandId 指定设置 FCM 通道即可解决。【Flutter】接入 FCM 推送 registerPush 报错“Default FirebaseApp is not initialized in this process 指定包名(eg:com.tencent.flutter.tuikit). Make sure to call FirebaseApp.initializeApp(Context) first.” 如何处理?
原因:"com.google.gms:google-services" google gms 服务插件版本不兼容引起。
解决方法:修改 GMS 插件版本至: 4.3.15。
注:com.tencent.flutter.tuikit 泛指包名。

Flutter tencent_cloud_chat_push 推送插件接入,点击推送通知,不触发 “onNotificationClicked” 回调,日志如下:

既然能收到推送通知,说明推送配置没有问题,可能是以下原因:
客户有混合开发,导致原生端注册推送,因存在多进程导致;
IM 控制台配置的推送点击方式不是“指定页面”;
IM 控制台配置的推送跳转方式,指定页面填写的路径不是“插件默认路径”;
环境配置不全面导致。
【Flutter】TUICallKit + TIMPush 接入,切后台接收通话邀请,点击推送通知,应用不跳转至“通话邀请界面”,如何解决?

检查 IM 控制台配置的"点击后续动作"是否选择"打开应用内指定页面",使用默认值;
在推送插件 onNotificationClicked 回调内加上"自动登录"逻辑,登录代码示例。

【鸿蒙】错误码:80300002;错误信息:harmony requestid: xxxxx, msg: No permission to send message to these tmIDs?
请自查 厂商配置 > 步骤3:创建 IM 控制台证书凭证,确保在正确项目下已创建证书凭证,或对比查看密钥文件中的 project_id 与应用在 AppGallery Connect 中的项目 ID 是否一致。