文档

通道配置

更新时间:

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

配置 iOS 推送通道

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

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

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

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

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

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

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

说明

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 推送通道;关闭开关,即取消接入。

    包名

    支持自定义 OPPO 应用包名,必须与 OPPO 开放平台上的应用包名保持一致。如不填,则默认使用小米通道所登记的包名。

    AppKey

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

    MasterSecret

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

    说明

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

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

配置 vivo 推送通道

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

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

    参数

    是否必填

    说明

    状态

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

    包名

    支持自定义 vivo 应用包名,必须与 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 推送通道 配置区域右上角的 配置,配置通道信息。

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

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

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

  • 本页导读 (0)
文档反馈