Android

最近更新时间:2025-12-30 10:48:51

我的收藏

注册应用到厂商推送平台

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

步骤1:注册小米开发者账号

1. 进入 小米开放平台,注册小米开发者账号,详情请参见 企业开发者账号注册流程
2. 使用小米开发者账号登录 小米澎湃 OS 开发者平台,在管理中心选择 PUSH 服务,进入应用列表页。


3. 进入推送服务应用列表。应用列表包括该开发者账号下的已有 App(包括 Android 手机/平板应用、Android TV 应用)。

4. 单击未启用状态 App 的启用推送,可以进入消息推送启用页面。

步骤2:启用推送

1. 启用推送前,您须先阅读《消息分类介绍及运营规范》、《推送消息违规处理办法》、《小米推送技术服务协议》、《小米推送技术服务数据保护附录》。勾选同意接受后,点击右上方按钮进入下一步。

2. 为您的应用创建所需的通知类别:
2.1 点击选择分类,详细的消息分类描述参考《小米推送消息分类新规》
2.2 按如上要求完整填写相应信息。
2.3 提交审核。
该环节您最多可同时创建8个不同分类的通知类别,我们会在3-5个工作日内完成审核。后续您可在“推送运营平台-消息分类管理”中维护应用的通知类别。


步骤3:创建应用

1. 如果您想使用的应用不在应用列表内,点击创建应用,选择创建手机/平板应用或电视应用

2. 选择操作系统,填写应用名包名,选择应用分类,单击创建,创建一个新应用。

3. 完成应用创建后,就可以启用该应用的推送服务了。
4. 启用推送服务后,在“应用管理-应用信息”页面可查看该应用对应的 AppId、AppKey 和 AppSecret。
其中 AppId 和 AppKey 是客户端的身份标识,在客户端 SDK 初始化时使用;AppSecret 是服务器端的身份标识,在使用服务端 SDK 向客户端发送消息时使用。

5. 应用列表包括该开发者账号下的已有APP(包括 Android 手机/平板应用、Android TV 应用)。


步骤4:查看获取应用信息

进入推送运营平台的应用信息页面,查看应用信息









步骤5:配置推送证书

登录腾讯云 即时通信 IM 控制台 ,在推送管理 > 接入设置功能栏添加各个厂商推送证书,并将您获取的厂商的 AppId、AppKey、AppSecret 等参数配置给添加的推送证书。
厂商推送平台
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 控制台 ,单击推送管理 > 接入设置添加各个厂商推送证书,并将您获取的厂商的 AppId、AppKey、AppSecret 等参数配置给添加的推送证书。
厂商推送平台
IM 控制台配置



说明:
Client ID 对应 AppID,Client Secret 对应 AppSecret。
应用内指定界面,请使用默认配置。




回执配置请参考:消息触达统计配置 > 华为

说明:
通知栏推送:应用需在 OPPO 软件商店上架;
通知栏推送测试权限:每天仅可推送1000条消息,限测试使用。应用上架后需重新申请“通知栏推送”权限,以获得正常消息推送数量;
平台将会在1个工作日内返回审核结果,开发者可以在申请页面查看审核结果,其他问题可咨询开放平台客服。

步骤1:注册 OPPO 开发者账号

进入 OPPO开放平台,注册 OPPO 开发者账号,详情参见 OPPO 企业开发者账号注册

步骤2:创建应用

进入 OPPO 开放平台,单击产品 > 应用分发> OPPO 软件商店 > 发布应用进入管理中心,创建应用。




步骤3:开通 PUSH 服务

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

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


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


步骤4:添加推送证书

登录腾讯云 即时通信 IM 控制台 ,在推送管理 > 接入设置功能栏添加各个厂商推送证书,并将您获取的厂商的 AppId、AppKey、AppSecret 等参数配置给添加的推送证书。
厂商推送平台
IM 控制台配置





说明:
应用内指定界面,请使用默认配置。





说明:
若应用没有上架应用市场,推送权限受限,不可在 vivo 官网的 Web 界面和 API 后台发送正式消息,可在 API 后台向设置的测试设备发送测试消息进行测试。
vivo开发平台的应用包名与插件应用包名需保持一致。

步骤1:注册 vivo 开发者账号

进入 vivo开放平台,注册 vivo 开发者账号,详情参见 vivo 企业开发者账号注册

步骤2:新建应用

进入vivo 开放平台,单击分发 > 应用分发 > 应用商店 > 上传应用来新建您的应用。


步骤3:开通推送

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



步骤4:获取应用信息

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


步骤5:添加推送证书

登录腾讯云 即时通信 IM 控制台 ,单击推送管理 > 接入设置添加各个厂商推送证书,并将您获取的厂商的 AppId、AppKey、AppSecret 等参数配置给添加的推送证书。
厂商推送平台
IM 控制台配置





说明:
应用内指定界面,请使用默认配置。





回执配置请参见:消息触达统计配置 > vivo

步骤1:注册魅族开发者账号

注册魅族开发者账号,详情参见 开发者注册

步骤2:创建应用

1. 单击控制台 > Flyme 推送

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


步骤3:获取应用信息

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





步骤4:添加推送证书

登录腾讯云 即时通信 IM 控制台 ,单击推送管理 > 接入设置功能栏添加各个厂商推送证书,并将您获取的厂商的 AppId、AppKey、AppSecret 等参数配置给添加的推送证书。
厂商推送平台
IM 控制台配置





说明:
应用内指定界面,请使用默认配置。





回执配置请参见:消息触达统计配置 > 魅族

步骤1. 注册荣耀开发者账号

注册荣耀开发者账号,详情参见 开发者注册

步骤2: 进入管理中心页面。





步骤3: 创建应用

1. 进入应用管理,点击新建应用创建新应用。



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




步骤4: 开通推送服务

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


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

3. 选择应用类型“移动应用”,填写应用包名和证书指纹、同意推送服务协议和数据处理附录,单击提交
注意:
需要添加打包的 SHA256 证书指纹,SHA256 证书指纹需与自己的打包证书一致。




步骤5: 获取应用信息

推送服务列表中,单击查看,获取应用信息。



步骤6:添加推送证书

登录腾讯云 即时通信 IM 控制台 ,单击推送管理 > 接入设置,添加各个厂商推送证书,并将您获取的厂商的 AppID、AppKey、AppSecret 等参数配置给添加的推送证书。
厂商推送平台
IM 控制台配置



注意:
应用内指定界面链接,不可以修改。 该配置用于派发单击后离线推送插件的事件监听,不可以直接配置应用内页面的跳转。




回执配置请参考:消息触达统计配置 > 荣耀

步骤1:进入Firebase 控制台

进入 Firebase 控制台,登录谷歌账号。

步骤2:创建应用

1. 单击创建项目,添加一个新的项目。

2. 进入Android 应用。

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

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


步骤3. 生成证书私钥。

1. 点击应用,进入应用管理。

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


步骤4. 配置推送证书。

登录腾讯云 即时通信 IM 控制台 ,在推送管理 > 接入设置功能栏添加各个厂商推送证书,并将您获取的厂商的 AppId、AppKey、AppSecret 等参数配置给添加的推送证书。
厂商推送平台
IM 控制台配置











注意:
关于点击后续动作支持上报统计功能:
1. 如果选择打开应用和打开网页,购买插件后会默认支持上报统计。
2. 如果选择打开应用内指定界面:
新增证书情况,请直接使用自动填写的默认值即可支持点击上报统计。
如果之前有证书且已配置,继续使用旧证书需要修改为默认值,才可以支持上报统计,或者重新生成新的证书。

关于 FCM 数据消息

FCM 提供两种推送方式:通知消息和数据消息。
通知消息,样式简单不区分设备,成功集成即可进行离线推送;
数据消息,样式定制丰富,特定设备有效,支持触达和点击上报,需要集成后在设备上做好测试开放上线。
控制台默认选择为通知消息,两种模式切换可在 IM 控制台操作:



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