SDK 集成相关问题

最近更新时间:2026-04-13 12:51:26

我的收藏

概况问题

收不到推送,插件费用到期?

推送插件试用或购买到期后,将自动停止提供推送服务(包括普通消息离线推送、全员/标签推送等服务)。为避免影响您业务正常使用,请提前 购买/续费

关于 Push SDK 包体积问题?

如果您要求集成包体积更低,并且希望单独使用 Push 推送服务不集成 IM SDK,您可以 提交工单 咨询。

上架隐私合规相关问题?

概念解释

提供推送接入方法对比

接入方法
集成方式对比
功能对比
插件快速集成:
不再需要逐个厂商填写配置,控制台下载引入 json 配置文件,即可完成所有手机厂商的推送信息配置。
支持按需集成一个或者多个对应厂商的推送渠道包,更加满足合规要求。
不需要客户处理推送注册、token 上报、前后台状态上报等,接入后插件自动闭环。
不再需要关注和添加打点和上报逻辑,开启功能后插件自行上报和汇总,支持链路排查和指标统计等。
插件封装界面跳转、图标自定义等方法,直接使用即可。
普通消息推送。
全员标签推送。
自定义界面跳转。
推送自定义样式。
设备推送状态查询。
全链路排查工具。
推送记录和指标统计分析。
需要自行集成多个厂商推送 SDK,接入成本高。
需要自行构建多端逻辑。
自建通道维护成本高,同时极易引起消息堵塞、延迟高,触达效率低。
消息接收失败、发送失败等各类问题需自行排查并解决。
收集用户隐私数据不当会导致 App 下架,严重影响业务。
仅支持普通消息推送。

系统服务问题

海外推送如何配置?

支持的厂商通道:FCM、华为、OPPO 和 APNs。
FCM 通道必备条件:设备可访问海外网站、安装 GMS 服务、成功集成 TIMPush。
国内设备大多无 GMS 服务,不支持 FCM。

接入过程问题

解决接入冲突问题(第三方推送客户端与 TIMPush 冲突)?

冲突原因是应用自身或依赖的第三方推送客户端与 TIMPush 中的第三方客户端冲突。需仅保留一个使用,具体方法参见 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 是否一致。