厂商通道参数申请指南
本文旨在指导用户获取厂商通道的推送参数,并完成极光控制台上的厂商参数配置。
上架说明
部分厂商要求必须上架应用市场才可以正常使用推送服务,详情参考下表:
厂商通道 | 是否需要上架 | 说明 |
---|---|---|
小米 | 是 | 需要注册企业开发者账号,详见 小米参数获取。 |
华为 | 否 | 个人开发者账号即可,详见 华为参数获取。 |
魅族 | 否 | 个人开发者账号即可,详见 魅族参数获取。 |
vivo | 是 | 需要注册企业开发者账号,详见 vivo 参数获取。 |
OPPO | 是 | 需要注册企业开发者账号,详见 OPPO 参数获取。 |
FCM | 否 | 个人开发者账号即可,详见 FCM 参数获取。 |
荣耀 | 否 | 需要注册企业开发者账号,详见 荣耀参数获取。 |
小米参数获取
注册小米开发者账号
进入 小米开放平台,注册小米开发者账号,详情参考 企业开发者账号注册流程。
2022年6月27日起,《小米推送技术服务协议》对“开发者应用”进行了重新定义,是指开发者独立开发或经合法授权运营并在小米商店发布的移动应用(APP)。若您的应用未在小米应用商店发布,则无法使用小米推送服务。
创建应用
1.进入【管理控制台】,选择消息推送。
若使用个人账号登录,会显示“抱歉,您当前没有推送/审核权限。”
2.创建应用。
3.填写应用信息,点击创建。
应用包名需跟您在极光官网填写的包名保持一致。
4.在完善应用资料界面,直接点击保存。
启用推送服务
1.进入【推送运营平台】-【应用列表】页面,在对应的应用名称点击“启用推送”。
2.勾选小米推送的接入合作协议,并点击“启用”。
获取应用信息
进入【推送运营平台】-【应用信息】页面,即可查看应用信息。
小米通道参数配置
进入【极光控制台】-【消息推送】-【推送设置】-【集成设置】页面,填写参数:AppKey、AppID、AppSecret、DefaultTitle,并点击“启用”。
DefaultTitle 默认标题自定义,建议使用应用名称。
华为参数获取
注册华为开发者账号
进入 华为开发者联盟,注册华为开发者账号,详情参考 注册账号。
创建项目
1.点击“管理中心”,进入【管理中心】页面。
2.选择【开发服务】-【PUSH】。
3.添加一个新的项目,填写项目名称。
开通推送服务
1.【项目设置】-【推送服务】页面,点击立即开通。
2.选择数据存储位置
3.进入【项目设置】-【API管理】页面,开启推送服务的权限。
4.进入【项目设置】-【常规】页面,点击添加应用。
设置应用包名需跟您在极光官网填写的包名保持一致。
获取应用信息
进入【项目设置】-【常规】页面,即可查看应用信息。
- 常规页面包含项目和应用的 Client ID 和 Client Secret,两者对应的参数不一致,请下拉至页面底部,获取应用的 Client ID 和 Client Secret。
- 需要添加打包的 SHA256证书指纹,SHA256 证书指纹需与自己的打包证书一致。
- 下载 agconnect-services.json 文件,SDK 集成时需要配置到 app 目录下。
- 修改了项目、应用信息、开发服务设置,都需要重新下载配置 agconnect-services.json 文件。
华为通道参数配置
进入【极光控制台】-【消息推送】-【推送设置】-【集成设置】页面,填写参数:AppID、AppSecret、DefaultTitle,并点击“启用”。
DefaultTitle 默认标题自定义,建议使用应用名称。
魅族参数获取
注册魅族开发者账号
进入 Flyme推送平台,注册魅族开发者账号,详情参考 开发者注册。
创建应用
1.进入【控制台】-【 Flyme 推送】页面。
2.新建应用。
3.填写应用信息后点击创建。
应用包名需跟您在极光官网填写的包名保持一致。
获取应用信息
1.在应用列表中选择“打开应用”。
2.进入【配置管理】页面,即可查看应用信息。
魅族的 AppID 是6位数字组成,请正确获取参数。
魅族通道参数配置
进入【极光控制台】-【消息推送】-【推送设置】-【集成设置】页面,填写参数:AppKey、AppID、AppSecret、DefaultTitle,并点击“启用”。
DefaultTitle 默认标题自定义,建议使用应用名称。
vivo 参数获取
注册 vivo 开发者账号
进入 vivo 开发者平台,注册 vivo 开发者账号,详情参考 企业开发者注册。
创建应用
1.进入【管理中心】-【应用与游戏】页面,点击【创建应用】。
2.填写应用信息后,点击创建。
若应用没有上架应用市场,推送权限受限,不可在 vivo 官网的 Web 界面和 API 后台发送正式消息,可在 API 后台向设置的测试设备发送测试消息进行测试。
申请推送服务
1.进入【管理中心】-【消息推送】页面。
2.点击推送申请,选择需要申请的应用名称后提交申请。
获取应用信息
进入【推送运营平台】-【应用信息】页面,即可查看应用信息。
vivo 通道参数配置
进入【极光控制台】-【消息推送】-【推送设置】-【集成设置】页面,填写参数:AppKey、AppID、AppSecret、DefaultTitle,并点击“启用”。
DefaultTitle 默认标题自定义,建议使用应用名称。
OPPO 参数获取
注册 OPPO 开发者账号
进入 OPPO 开放平台,注册 OPPO 开发者账号,详情参考 OPPO 企业开发者账号注册。
创建应用
1.进入【管理中心】-【应用服务平台】页面。
2.点击创建应用,详情请参考应用接入流程。
开启推送服务
1.进入【管理中心】-【应用服务】-【移动服务】-【推送服务】页面。
2.点击“申请接入”。
3.在消息推送页面,选择需要开启推送服务的应用并选择“申请开通”。
- 推送测试权限只能用于测试,每个应用每天有1000条。
- 推送正式权限需要重新申请“通知栏推送”权限(资源上架后方可申请)。
4.申请通过后状态显示“已开通”。
获取应用信息
在移动应用列表页面,选择需要查看的应用,即可查看应用详情。
appserversecret 为极光控制台必填参数 Master Secret。
OPPO 通道参数配置
进入【极光控制台】-【消息推送】-【推送设置】-【集成设置】页面,填写参数:AppKey、AppID、AppSecret、MasterSecret/AppServerSecret、DefaultTitle,并点击“启用”。
DefaultTitle 默认标题自定义,建议使用应用名称。
FCM 参数获取
【重要】:2024年6月20开始,FCM 旧版 API 已停止使用,请您按照如下配置,尽快切换到 FCM 新 API 服务。
创建项目
1.进入 Firebase,登录谷歌账号。
2.点击“添加项目”。
3.创建项目后,点击该项目进入项目详情。
创建应用
1.点击 Android 应用图标创建应用。
2.填写应用信息。
应用包名需跟您在极光官网填写的包名保持一致。
3.下载 google-services.json 文件,SDK 集成时需要配置至 app 目录下。
获取应用信息
点击进入【项目设置】页面,选择“云消息传递”,启用新版消息发送 API 权益。
获取含 FCM 服务帐号密钥的 JSON 文件。
FCM 通道参数配置
进入【极光控制台】-【消息推送】-【推送设置】-【集成设置】页面,上传包含FCM服务帐号密钥的 JSON 文件,并点击“启用”。
含FCM服务帐号密钥的 JSON 文件的获取方式参考:FCM服务帐号生成私钥文件
荣耀参数获取
注册荣耀开发者账号
创建应用
1.进入【管理中心】页面。
2.点击【推送服务】进入推送服务列表页面。
3.选择“申请推送服务”进入应用申请页面。
4.选择应用类型“移动应用”和“服务器应用”,填写或选择已创建的产品、填写应用包名和证书指纹、同意推送服务协议和数据处理附录,点击“提交”按钮。
需要添加打包的 SHA256 证书指纹,SHA256 证书指纹需与自己的打包证书一致。
5.提交后即可在推送列表中看到应用名称。
获取应用信息
1.点击“查看”,进入查看推送服务详情页面即可获取应用信息。
荣耀通道参数配置
进入【极光控制台】-【消息推送】-【推送设置】-【集成设置】页面,填写参数:App ID、Client ID、Client Secrect、App Secret、DefaultTitle,并点击“启用”。
DefaultTitle 默认标题自定义,建议使用应用名称。