注册应用到厂商推送平台
推送需要将您自己的应用注册到各个厂商的推送平台,得到 AppID 和 AppKey 等参数,来实现推送功能。目前国内支持的手机厂商有:小米、华为、荣耀、OPPO、vivo、魅族,境外支持 Google FCM。
说明:
通知栏推送:应用需在小米软件商店上架。
需要使用企业账号进行推送配置。
小米开发平台的应用包名与插件应用包名需保持一致。
步骤1:注册小米开发者账号
步骤2:创建应用
1. 在 小米管理控制台 单击消息推送。

2. 单击创建应用,完善应用资料界面后单击保存。 



步骤3:启用推送
进入推送运营平台的应用列表页面,在对应的应用名称单击启用推送,确定启用。


步骤4:查看获取应用信息
进入推送运营平台的应用信息页面,查看应用信息。




步骤5:配置推送证书
厂商推送平台 | IM 控制台配置 |
![]() | 说明: 应用内指定界面,请使用默认配置。 ![]() |
步骤1:注册华为开发者账号
步骤2:创建应用
1. 在 华为管理中心 的应用管理中,单击 AppGallery Connect,进入应用管理中心。

2. 单击我的项目,添加一个新的项目。

3. 在项目设置栏单击推送服务 > 立即开通。

4. 单击项目设置 > API 管理,开启推送服务的权限。

步骤3. 添加应用
单击项目设置 > 常规,添加应用。
说明:
应用包名与插件应用包名保持一致。


步骤4:获取应用信息
单击项目设置 > 常规,获取应用信息。
说明:
常规页面包含项目和应用的 Client ID 和 Client Secret,两者对应的参数不一致,请下拉至页面底部,获取应用的 Client ID 和 Client Secret。
必须添加打包的 SHA256证书指纹,SHA256 证书指纹需与自己的打包证书一致。
下载 agconnect-services.json 文件,放到项目中:nativeResources/android/assets/ 路径下。
修改了项目、应用信息、开发服务设置,都需要重新下载配置 agconnect-services.json 文件。


步骤5:添加推送证书
厂商推送平台 | IM 控制台配置 |
![]() | 说明: Client ID 对应 AppID,Client Secret 对应 AppSecret。 应用内指定界面,请使用默认配置。 ![]() |
回执配置请参考:消息触达统计配置 > 华为
说明:
通知栏推送:应用需在 OPPO 软件商店上架;
通知栏推送测试权限:每天仅可推送1000条消息,限测试使用。应用上架后需重新申请“通知栏推送”权限,以获得正常消息推送数量;
平台将会在1个工作日内返回审核结果,开发者可以在申请页面查看审核结果,其他问题可咨询开放平台客服。
步骤1:注册 OPPO 开发者账号
步骤2:创建应用
进入 OPPO 开放平台,单击产品 > 应用分发> OPPO 软件商店 > 发布应用进入管理中心,创建应用。


步骤3:开通 PUSH 服务
1. 进入 OPPO 开放平台,单击产品 > 移动服务 > 推送服务进入推送主页,单击申请接入开通推送服务。

2. 单击进入管理中心 > 应用列表 > 申请推送服务界面,为未开启服务的应用申请推送权限。
说明:
已开启服务:已申请 PUSH 权限并通过的应用。
未开启服务:可申请 PUSH 权限的应用。


3. 单击申请开通。在未开启服务中单击需要申请 PUSH 权限的应用,进入 PUSH 服务并点击申请开通。

步骤4:添加推送证书
厂商推送平台 | IM 控制台配置 |
![]() | 说明: 应用内指定界面,请使用默认配置。 ![]() |
说明:
若应用没有上架应用市场,推送权限受限,不可在 vivo 官网的 Web 界面和 API 后台发送正式消息,可在 API 后台向设置的测试设备发送测试消息进行测试。
vivo开发平台的应用包名与插件应用包名需保持一致。
步骤1:注册 vivo 开发者账号
步骤2:新建应用
进入vivo 开放平台,单击分发 > 应用分发 > 应用商店 > 上传应用来新建您的应用。

步骤3:开通推送
进入管理中心单击推送服务 > 推送申请为新建的应用申请开通推送。


步骤4:获取应用信息
进入推送运营平台,单击应用管理 > 应用信息,获取应用信息。

步骤5:添加推送证书
厂商推送平台 | IM 控制台配置 |
![]() | 说明: 应用内指定界面,请使用默认配置。 ![]() |
回执配置请参见:消息触达统计配置 > vivo
步骤1:注册魅族开发者账号
步骤2:创建应用
1. 单击控制台 > Flyme 推送。

2. 填写应用信息后,创建应用。
说明:
应用包名与插件应用包名保持一致。

步骤3:获取应用信息
在应用列表中单击打开应用。进入配置管理页面,获取应用信息。


步骤4:添加推送证书
厂商推送平台 | IM 控制台配置 |
![]() | 说明: 应用内指定界面,请使用默认配置。 ![]() |
回执配置请参见:消息触达统计配置 > 魅族
步骤1. 注册荣耀开发者账号
步骤2: 进入管理中心页面。


步骤3: 创建应用
1. 进入应用管理,点击新建应用创建新应用。


2. 进入应用详情, 绑定应用包名,下载 mcs-services.json 文件。
说明:
必须添加打包的 SHA256证书指纹,SHA256 证书指纹需与自己的打包证书一致。
下载 mcs-services.json 文件,放到项目中:nativeResources/android/ 路径下。
修改了项目、应用信息、开发服务设置,都需要重新下载配置 mcs-services.json 文件。


步骤4: 开通推送服务
1. 单击开发能力 -> 推送服务进入推送服务列表页面。

2. 单击申请推送服务进入应用申请页面。

3. 选择应用类型“移动应用”,填写应用包名和证书指纹、同意推送服务协议和数据处理附录,单击提交。
注意:


步骤5: 获取应用信息
在推送服务列表中,单击查看,获取应用信息。

步骤6:添加推送证书
厂商推送平台 | IM 控制台配置 |
![]() | 注意: 应用内指定界面链接,不可以修改。 该配置用于派发单击后离线推送插件的事件监听,不可以直接配置应用内页面的跳转。 ![]() |
回执配置请参考:消息触达统计配置 > 荣耀
步骤1:进入Firebase 控制台
步骤2:创建应用
1. 单击创建项目,添加一个新的项目。

2. 进入Android 应用。

3. 输入应用信息,注册应用。

4. 下载并添加配置文件并完成注册。

步骤3. 生成证书私钥。
1. 点击应用,进入应用管理。

2. 在项目设置单击服务账号 > 生成新的密钥。

步骤4. 配置推送证书。
厂商推送平台 | IM 控制台配置 |
![]() | ![]() |
注意:
关于点击后续动作支持上报统计功能:
1. 如果选择打开应用和打开网页,购买插件后会默认支持上报统计。
2. 如果选择打开应用内指定界面:
新增证书情况,请直接使用自动填写的默认值即可支持点击上报统计。
如果之前有证书且已配置,继续使用旧证书需要修改为默认值,才可以支持上报统计,或者重新生成新的证书。
关于 FCM 数据消息
FCM 提供两种推送方式是通知消息和数据消息。
通知消息,样式简单不区分设备,成功集成即可进行离线推送;
数据消息,样式定制丰富,特定设备有效,支持触达和点击上报,需要集成后在设备上做好测试开放上线。
控制台默认选择为通知消息,两种模式切换可在 IM 控制台操作:


注意:
FCM 数据消息能力仅支持 TIMPush 7.8 及以上版本的 pixel 手机,其他厂商设备需自测支持情况;