文档

通道配置

更新时间:

本文介绍如何进行 iOS 和 Android 以及鸿蒙推送通道配置。

配置 iOS 推送通道

接入苹果手机时,依赖 APNs 服务作为消息推送网关,需要在控制台侧上传 iOS 推送证书,用于连接 APNs 服务。

完成以下步骤配置 iOS 推送证书:

  1. 登录 mPaaS 控制台,选择目标应用后,从左侧导航栏进入 消息推送 > 设置 页面。

  2. 在右侧的设置页面上,选择 通道配置 标签,在 iOS 通道 配置区域,配置 iOS 推送证书。

    • 选择证书文件:选择并上传预先准备好的 iOS 推送证书。后端会通过解析上传的证书获得证书环境和 BundleId。如需了解 iOS 推送证书的制作步骤,参考 制作 iOS 推送证书

    • 证书密码:填写证书密码,即导出 .p12 证书时所设置的密码。

  3. 单击 上传,保存配置,若证书格式正确,可以看到证书的详细内容,如下图所示。若需要验证证书是否和环境对应,是否合法,可通过在控制台推送消息进行测试。p342649

说明

iOS 推送证书具有有效期,请在推送证书失效前及时更新证书,以免消息推送无法正常工作。系统会在证书失效前 15 天开始提醒更换。如需更换证书,单击证书信息下方的 重新上传 上传新的证书即可。

配置 iOS 实时活动消息推送证书

重要

在配置 iOS 实时活动消息推送证书之前,首先要确定 iOS 原推送证书,即 .p12 证书,已经配置完毕,否则将无法配置实时活动消息证书。

完成以下步骤配置 iOS 实时活动消息推送证书:

  1. 登录 mPaaS 控制台,选择目标应用后,从左侧导航栏进入 消息推送 > 设置 页面。

  2. iOS 通道 的设置页面上,勾选 Token Authentication 配置,配置好 bundleId、keyId、teamId 后,上传 p8AuthKey 私钥文件,即 .p8 文件,而后点击 保存

image.png

重要

实时活动消息推送的环境和原 iOS 证书之间绑定,因此使用效果如下:

  • 若原 iOS 证书为测试环境 sandbox 证书,则推送测试环境实时活动消息。

  • 若原 iOS 证书为生产环境证书,则推送生产环境实时活动消息。

配置 Android 推送通道

为提升推送的到达率,mPaaS 集成了华为、小米、OPPO 和 vivo 等厂商推送通道。采用小米通知栏消息、华为通知栏消息、OPPO 通知栏消息和 vivo 通知栏消息实现消息推送。在应用未运行时,依然可以发送通知,用户点击通知栏即可激活进程。

说明

接入厂商自有的推送通道后,能够帮助应用获得稳定的推送性能,因此建议您将厂商推送通道接入应用。

本文将引导您完成在接入小米、华为、OPPO、和 vivo 推送渠道时需要进行的控制台侧配置。

前置条件

您需要先完成客户端侧的接入配置,操作参见 接入厂商推送通道

操作方法

配置华为推送渠道

  1. 从左侧导航栏进入 消息推送 > 设置 > 通道配置 标签页。

  2. 单击 华为推送通道 配置区域右上角的 配置,页面上展示配置入口,如下图所示。 配置华为推送渠道

    参数

    是否必填

    说明

    状态

    渠道的接入状态开关。打开开关,MPS 将根据配置接入华为推送渠道;关闭开关,即取消接入。

    包名

    输入华为应用包名。

    华为应用 ID

    输入华为应用的 App ID。

    华为应用密钥

    输入华为应用的密钥(App Secret)。

    说明

    可登录 华为开发者联盟 官网,进入 管理中心 > 我的产品 > 移动应用详情 页面中获取应用包名、应用 App ID 和密钥。

  3. 点击 确定 按钮,保存配置。

配置荣耀推送渠道

  1. 从左侧导航栏进入 消息推送 > 设置 > 通道配置 标签页。

  2. 单击 荣耀推送通道 配置区域右上角的 配置,页面上展示配置入口。

    参数

    是否必填

    说明

    状态

    渠道的接入状态开关。打开开关,MPS 将根据配置接入荣耀推送渠道;关闭开关,即取消接入。

    包名

    支持自定义荣耀应用包名。

    荣耀 AppID

    唯一应用标识符,在开发者平台开通对应应用的荣耀推送服务时生成。

    荣耀应用 ID

    应用的客户 ID,用于获取发送消息令牌的 ID,在开发者平台开通对应应用 PUSH 服务时生成。

    荣耀应用密钥

    输入荣耀应用的密钥(App Secret)。

    说明

    可登录 荣耀开发者联盟 官网,进入 管理中心 > 我的产品 > 移动应用详情 页面中获取应用包名、应用 App ID 和密钥。

  3. 点击 确定 按钮,保存配置。

配置小米推送通道

  1. 从左侧导航栏进入 消息推送 > 设置 > 通道配置 标签页。

  2. 单击 小米推送通道 配置区域右上角的 配置,页面上展示配置入口,如下图所示。

    参数

    是否必填

    说明

    状态

    通道的接入状态开关。打开开关,MPS 将根据配置接入小米推送通道;关闭开关,即取消接入。

    包名

    输入小米应用的主包名。

    密码

    输入小米应用的密钥(AppSecret)。

    说明

    可登录 小米开放平台,进入 应用管理 > 应用信息 页面获取包名和密钥。

  3. 点击 确定 按钮,保存配置。

配置 OPPO 推送通道

  1. 从左侧导航栏进入 消息推送 > 设置 > 通道配置 标签页。

  2. 单击 OPPO 推送通道 配置区域右上角的 配置,页面上展示配置入口,如下图所示。

    参数

    是否必填

    说明

    状态

    通道的接入状态开关。打开开关,MPS 将根据配置接入 OPPO 推送通道;关闭开关,即取消接入。

    AppKey

    AppKey 是客户端的身份标识,在客户端 SDK 初始化时使用。

    MasterSecret

    MasterSecret 是开发者在使用服务端 API 接口时,用于校验身份的标识。

    说明

    OPPO 开放平台 上,开通 OPPO PUSH 权限后,即可在 OPPO 推送平台 > 配置管理 > 应用配置 页面上查看应用的 AppKey 和 MasterSecret 信息。

  3. 点击 确定 按钮,保存配置。

配置 vivo 推送通道

  1. 从左侧导航栏进入 消息推送 > 设置 > 通道配置 标签页。

  2. 单击 VIVO 推送通道 配置区域右上角的 配置,页面上展示配置入口,如下图所示。

    参数

    是否必填

    说明

    状态

    通道的接入状态开关。打开开关,MPS 将根据配置接入 vivo 推送通道;关闭开关,即取消接入。

    APP ID

    AppId 是客户端的身份标识,在客户端 SDK 初始化时使用。

    AppKey

    AppKey 是客户端的身份标识,在客户端 SDK 初始化时使用。

    MasterSecret

    MasterSecret 是开发者在使用服务端 API 接口时,用于校验身份的标识。该参数对应您从 vivo 开发者平台申请获取的 AppSecret。

    说明

    vivo 开放平台 上为应用申请 Push 服务通过后,即可获取应用的 AppId,AppKey 和 MasterSecret(AppSecret)。

  3. 点击 确定 按钮,保存配置。

配置 FCM 推送通道

接入海外安卓设备时,依赖谷歌的 FCM 服务作为消息推送网关,需要在控制台侧配置 FCM 推送通道。

前提条件

进行 FCM 推送通道配置前,您需要先在 Firebase 控制台上获取 FCM 服务器密钥,获取方法如下图所示。

获取 FCM 服务器密钥02

操作步骤

  1. 从左侧导航栏进入 消息推送 > 设置 > 通道配置 标签页。

  2. 单击 FCM 推送通道 配置区域右上角的 配置,配置通道信息,如下图所示。FCM 推送渠道配置

  3. 单击 状态 开关,打开开关后,MPS 将接入 FCM 服务;关闭开关后,MPS 不接入 FCM 服务。

  4. 填写 FCM 服务器密钥,确保填写的是服务器(server)的密钥,Android 密钥、iOS 密钥和浏览器密钥会被 FCM 拒绝。

  5. 单击 确定,保存配置。

配置 HarmonyOS 推送通道

接入鸿蒙手机时,需要在控制台侧配置应用 ID 和上传鸿蒙推送证书,用于消息推送。

  1. 登录 mPaaS 控制台,选择目标应用后,从左侧导航栏进入 消息推送 > 设置 页面。

  2. 在右侧的设置页面上,选择 通道配置 标签,在 HarmonyOS 通道 配置区域,配置 HarmonyOS 推送证书。

说明

可在 API Console 上创建并下载推送服务 API 的证书文件。相关创建步骤请参见 API Console操作指南-服务账号密钥

  1. 单击 点击上传 按钮,保存配置。