FCM 通道接入

【重要】移动推送 TPNS 产品停止售卖公告

公告

产品功能动态

Android SDK 发布动态

iOS SDK 发布动态

macOS SDK 发布动态

产品动态

产品概述

产品优势

应用场景

全球化部署

产品简介

价格总览

购买指引

计费模式

免费试用

欠费说明

购买指南

创建产品和应用

Android 快速接入

iOS 快速接入

创建推送任务

查询推送记录

推送测试方法指引

产品限制说明

快速入门

排查工具

转化漏斗

推送计划

推送控制

消息回撤

推送管理

标签功能

多包名推送

通知点击跳转

定速推送

通道策略

消息折叠

富媒体通知

个性化通知

账号推送

推送高级功能

操作指南

iOS 平台角标功能实践

实践教程

简介

API 概览

签名认证（推荐）

Basic Auth 认证

请求结构

调用方式

推送接口

创建推送计划接口

号码包上传接口

Token 包上传接口

推送相关接口

标签绑定与解绑

删除标签下所有设备

标签相关接口

账号绑定与解绑

账号设备绑定查询

账号相关接口

推送统计按天聚合统计

设备统计查询

特定时间段所有推送信息查询

单个任务推送信息查询

单条任务推送统计信息查询

多条任务统计数据聚合查询

根据 Token 查询当天所有推送任务

统计相关接口

用户属性相关接口

服务端错误码

服务端 SDK

API（Java）

API 文档

SDK 集成

接口文档

厂商通道接入指南

 厂商通道高级功能

错误码

Android 接入指南

推送证书获取指引

推送环境选择说明

拓展功能

iOS 接入指南

客户端集成插件

推送证书说明

macOS接入指南

SDK 文档

快速入门配置

进阶自定义配置

资源标签

用户及权限

服务等级协议

开发者协议

服务协议

iOS 常见问题

Android 常见问题

Flutter 常见问题

其他问题

常见问题

移动推送隐私协议

TPNS 数据处理和安全协议

Developer Agreement

移动推送政策

联系我们

词汇表

移动推送

FCM 通道是谷歌推出的系统级推送通道，在国外具备谷歌 Service 框架的手机上，鉴于其较宽松的后台进程管理方式，在应用进程未被强制停止的情况下，可以收到推送消息。FCM 通道不支持国内集群。

FCM 推送支持两种密钥配置，以下方式二选一，推荐使用“服务器私钥”的新协议方式。

https://firebase.google.com/?hl=zh-cn

，获取到 Firebase 服务器私钥 json 文件。然后进入 

https://console.tencentcloud.com/tpns

 栏目中，选中“（推荐）服务器私钥”，单击

配置 google-services.json 文件。如图所示：


在项目级的 build.gradle 文件中的 dependencies 节点中添加下面代码：

classpath 'com.google.gms:google-services:4.2.0'

FCM Register error! java.lang.IllegalStateException: Default FirebaseApp is not initialized in this process com.qq.xg4all. Make sure to call FirebaseApp.initializeApp(Context) first.

，建议在 res/values 文件夹下的 string.xml， 加上 YOUR_GOOGLE_APP_ID。

在应用级的 build.gradle 文件中，添加依赖：

        implementation 'com.tencent.tpns:fcm:[VERSION]-release' // FCM 推送 [VERSION] 为当前 SDK 版本号，版本号可在 Android SDK 发布动态查看

 implementation  'com.google.firebase:firebase-messaging:17.6.0'

//在应用级的 gradle 文件的最后一行代码中新增并将 google-services.json 放进您应用 model 的根路径下

apply plugin: 'com.google.gms.google-services'

FCM 推送 [VERSION] 为当前 SDK 版本号，版本号可在 

Google 配置 google-play-services（建议版本 17.0.0+，较低版本有可能出现无法注册 FCM 风险）。

在调用移动推送注册代码 XGPushManager.registerPush 前，添加以下代码设置：

XGPushConfig.enableOtherPush(this, true);

V/TPush: [XGPushConfig] isUsedOtherPush:true

I/TPush: [OtherPush] checkDevice pushClassNamecom.tencent.android.tpush.otherpush.fcm.impl.OtherPushImpl

I/TPush: [XGPushManager] other push token is : dSJA5n4fSZ27YeDf2rFg1A:APA91bGiqSPCMZTuyup**********f1fBIahZKYkth2OoDpixDPQmEZkQ11fX06mw_1kEaW5-jFmT4YwlER4qfX66h_BIoUxOyj_tKqZSUg7oHigIKaOrDWmMQfMAqGoT8qSfg  other push type: fcm

 混淆规则需要放在 App 项目级别的 proguard-rules.pro 文件中。

推送 FCM 推送收不到，是什么原因？

在境外具备谷歌 Service 框架的手机上，鉴于其较宽松的后台进程管理方式，在应用进程未被强制停止的情况下， FCM 消息抵达较为稳定。

在大陆发行的国内品牌手机，其后台进程管理普遍较为严格，谷歌 service 后台服务同样也会受到限制，这些手机上 FCM 消息抵达可能会受到影响，FCM 无法进行下发和接收，建议保持 App 在前台接收。

在手机设置-应用管理-具体应用-点击“结束运行”/“强制停止”等按钮停止了应用。大部分国内品牌手机，在多任务页面划掉应用进程，也可认为是强制停止了应用进程（境外手机不会）。

tencent cloud