全部产品
Search
文档中心

移动开发平台mPaaS:通道配置

更新时间:Nov 07, 2024

本文介绍如何进行 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 P8 实时活动证书

    • 实时活动消息推送的环境和原 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. 单击 确定,保存配置。

配置新版 FCM 通道

重要

自 2024 年 6 月 20 日起,FCM 旧版 API 不再受到支持,并且会停用。为避免推送通知服务发生任何中断,请您尽快迁移到新版 FCM API。

  1. 通过控制台上传 FCM 鉴权文件。

    image

    Firebase 项目支持 Google 服务账号,您可以使用这些账号从应用服务器或受信任环境调用 Firebase 服务器 API。如果您在本地编写代码,或在本地部署您的应用,则可以通过此服务账号获取的凭据来对服务器请求进行授权。

    说明

    如需对服务账号进行身份验证并授予其访问 Firebase 服务的权限,您必须生成 JSON 格式的私钥文件,操作步骤如下:

    1. 在 Firebase 控制台中,选择 设置 > 服务账号

    2. 单击 生成新的私钥,而后通过单击 生成密钥 按钮进行确认。

    3. 妥善存储包含密钥的 JSON 文件。

  2. 推送链路切换方式。

    通过新版 FCM 逻辑提供的链路切换方式是增加扩展参数(extended_params)配置,增加一个键值对 useNewFcmApi=1 表示通过新链路进行消息推送。

    image.png

    推送消息时,需要添加扩展字段:

    • 旧版:useNewFcmApi,0;

    • 新版:useNewFcmApi,1;

    不添加扩展参数时默认为旧版。