本文介绍如何进行 iOS 和 Android 推送通道配置。
配置 iOS 推送通道
接入苹果手机时,依赖 APNs 服务作为消息推送网关,需要在控制台侧上传 iOS 推送证书,用于连接 APNs 服务。
完成以下步骤配置 iOS 推送证书:
登录 mPaaS 控制台,选择目标应用后,从左侧导航栏进入 消息推送 > 设置 页面。
在右侧的设置页面上,选择 通道配置 标签,在 iOS 通道 配置区域,配置 iOS 推送证书。
选择证书文件:选择并上传预先准备好的 iOS 推送证书。后端会通过解析上传的证书获得证书环境和 BundleId。如需了解 iOS 推送证书的制作步骤,参考 制作 iOS 推送证书。
证书密码:填写证书密码,即导出 .p12 证书时所设置的密码。
单击 上传,保存配置,若证书格式正确,可以看到证书的详细内容,如下图所示。若需要验证证书是否和环境对应,是否合法,可通过在控制台推送消息进行测试。
iOS 推送证书具有有效期,请在推送证书失效前及时更新证书,以免消息推送无法正常工作。系统会在证书失效前 15 天开始提醒更换。如需更换证书,单击证书信息下方的 重新上传 上传新的证书即可。
配置 iOS 实时活动消息推送证书
在配置 iOS 实时活动消息推送证书之前,首先要确定 iOS 原推送证书,即 .p12
证书,已经配置完毕,否则将无法配置实时活动消息证书。
完成以下步骤配置 iOS 实时活动消息推送证书:
登录 mPaaS 控制台,选择目标应用后,从左侧导航栏进入 消息推送 > 设置 页面。
在 iOS 通道 的设置页面上,勾选 Token Authentication 配置,配置好 bundleId、keyId、teamId 后,上传 p8AuthKey 私钥文件,即
.p8
文件,而后点击 保存。重要上述参数获取可参考 制作 iOS P8 实时活动证书。
实时活动消息推送的环境和原 iOS 证书之间绑定,因此使用效果如下:
若原 iOS 证书为测试环境 sandbox 证书,则推送测试环境实时活动消息。
若原 iOS 证书为生产环境证书,则推送生产环境实时活动消息。
配置 Android 推送通道
为提升推送的到达率,mPaaS 集成了华为、小米、OPPO 和 vivo 等厂商推送通道。采用小米通知栏消息、华为通知栏消息、OPPO 通知栏消息和 vivo 通知栏消息实现消息推送。在应用未运行时,依然可以发送通知,用户点击通知栏即可激活进程。
接入厂商自有的推送通道后,能够帮助应用获得稳定的推送性能,因此建议您将厂商推送通道接入应用。
本文将引导您完成在接入小米、华为、OPPO 和 vivo 推送渠道时需要进行的控制台侧配置。
前置条件
您需要先完成客户端侧的接入配置,操作参见 接入厂商推送通道。
操作方法
配置华为推送渠道
从左侧导航栏进入 消息推送 > 设置 > 通道配置 标签页。
单击 华为推送通道 配置区域右上角的 配置,页面上展示配置入口,如下图所示。
参数
是否必填
说明
状态
是
渠道的接入状态开关。打开开关,MPS 将根据配置接入华为推送渠道;关闭开关,即取消接入。
包名
是
输入华为应用包名。
华为应用 ID
是
输入华为应用的 App ID。
华为应用密钥
是
输入华为应用的密钥(App Secret)。
说明可登录 华为开发者联盟 官网,进入 管理中心 > 我的产品 > 移动应用详情 页面中获取应用包名、应用 App ID 和密钥。
点击 确定 按钮,保存配置。
配置荣耀推送渠道
从左侧导航栏进入 消息推送 > 设置 > 通道配置 标签页。
单击 荣耀推送通道 配置区域右上角的 配置,页面上展示配置入口。
参数
是否必填
说明
状态
是
渠道的接入状态开关。打开开关,MPS 将根据配置接入荣耀推送渠道;关闭开关,即取消接入。
包名
是
支持自定义荣耀应用包名。
荣耀 AppID
是
唯一应用标识符,在开发者平台开通对应应用的荣耀推送服务时生成。
荣耀应用 ID
是
应用的客户 ID,用于获取发送消息令牌的 ID,在开发者平台开通对应应用 PUSH 服务时生成。
荣耀应用密钥
是
输入荣耀应用的密钥(App Secret)。
说明可登录 荣耀开发者联盟 官网,进入 管理中心 > 我的产品 > 移动应用详情 页面中获取应用包名、应用 App ID 和密钥。
点击 确定 按钮,保存配置。
配置小米推送通道
从左侧导航栏进入 消息推送 > 设置 > 通道配置 标签页。
单击 小米推送通道 配置区域右上角的 配置,页面上展示配置入口,如下图所示。
参数
是否必填
说明
状态
是
通道的接入状态开关。打开开关,MPS 将根据配置接入小米推送通道;关闭开关,即取消接入。
包名
是
输入小米应用的主包名。
密码
是
输入小米应用的密钥(AppSecret)。
说明可登录 小米开放平台,进入 应用管理 > 应用信息 页面获取包名和密钥。
点击 确定 按钮,保存配置。
配置 OPPO 推送通道
从左侧导航栏进入 消息推送 > 设置 > 通道配置 标签页。
单击 OPPO 推送通道 配置区域右上角的 配置,页面上展示配置入口,如下图所示。
参数
是否必填
说明
状态
是
通道的接入状态开关。打开开关,MPS 将根据配置接入 OPPO 推送通道;关闭开关,即取消接入。
AppKey
是
AppKey 是客户端的身份标识,在客户端 SDK 初始化时使用。
MasterSecret
是
MasterSecret 是开发者在使用服务端 API 接口时,用于校验身份的标识。
点击 确定 按钮,保存配置。
配置 vivo 推送通道
从左侧导航栏进入 消息推送 > 设置 > 通道配置 标签页。
单击 VIVO 推送通道 配置区域右上角的 配置,页面上展示配置入口,如下图所示。
参数
是否必填
说明
状态
是
通道的接入状态开关。打开开关,MPS 将根据配置接入 vivo 推送通道;关闭开关,即取消接入。
APP ID
是
AppId 是客户端的身份标识,在客户端 SDK 初始化时使用。
AppKey
是
AppKey 是客户端的身份标识,在客户端 SDK 初始化时使用。
MasterSecret
是
MasterSecret 是开发者在使用服务端 API 接口时,用于校验身份的标识。该参数对应您从 vivo 开发者平台申请获取的 AppSecret。
说明在 vivo 开放平台 上为应用申请 Push 服务通过后,即可获取应用的 AppId,AppKey 和 MasterSecret(AppSecret)。
点击 确定 按钮,保存配置。
配置 FCM 推送通道
接入海外安卓设备时,依赖谷歌的 FCM 服务作为消息推送网关,需要在控制台侧配置 FCM 推送通道。
前提条件
进行 FCM 推送通道配置前,您需要先在 Firebase 控制台上获取 FCM 服务器密钥,获取方法如下图所示。
操作步骤
从左侧导航栏进入 消息推送 > 设置 > 通道配置 标签页。
单击 FCM 推送通道 配置区域右上角的 配置,配置通道信息,如下图所示。
单击 状态 开关,打开开关后,MPS 将接入 FCM 服务;关闭开关后,MPS 不接入 FCM 服务。
填写 FCM 服务器密钥,确保填写的是服务器(server)的密钥,Android 密钥、iOS 密钥和浏览器密钥会被 FCM 拒绝。
单击 确定,保存配置。
配置新版 FCM 通道
自 2024 年 6 月 20 日起,FCM 旧版 API 不再受到支持,并且会停用。为避免推送通知服务发生任何中断,请您尽快迁移到新版 FCM API。
通过控制台上传 FCM 鉴权文件。
Firebase 项目支持 Google 服务账号,您可以使用这些账号从应用服务器或受信任环境调用 Firebase 服务器 API。如果您在本地编写代码,或在本地部署您的应用,则可以通过此服务账号获取的凭据来对服务器请求进行授权。
说明如需对服务账号进行身份验证并授予其访问 Firebase 服务的权限,您必须生成 JSON 格式的私钥文件,操作步骤如下:
在 Firebase 控制台中,选择 设置 > 服务账号。
单击 生成新的私钥,而后通过单击 生成密钥 按钮进行确认。
妥善存储包含密钥的 JSON 文件。
推送链路切换方式。
通过新版 FCM 逻辑提供的链路切换方式是增加扩展参数(extended_params)配置,增加一个键值对
useNewFcmApi=1
表示通过新链路进行消息推送。推送消息时,需要添加扩展字段:
旧版:
useNewFcmApi
,0;新版:
useNewFcmApi
,1;
不添加扩展参数时默认为旧版。