概述

更新时间:
复制 MD 格式
重要

厂商通道配置与原生 SDK 集成使用共用文档。请使用与主 SDK 配套的厂商适配包,并按所用 SDK 版本选择辅助弹窗接入方式。4.x 迁移差异请参见Android SDK 4.x升级指南。

前言

在国内Android生态中,推送通道都是由终端与云端之间的长链接来维持,非常依赖于应用进程的存活状态。如今一些手机厂家会在自家ROM中做系统级别的推送通道,再由系统分发给各个App,以此提高在自家ROM上的推送送达率。

完整接入厂商通道仅需两步:

第一步:接入厂商通道:接入厂商通道 SDK,并完成注册和消息接收验证。

第二步:接入辅助弹窗:配置消息接收,处理推送消息和通知事件。

第一步:接入厂商通道

移动推送针对小米、华为、荣耀、vivo、OPPO、魅族、谷歌等设备管控较严的情况,分别接入了相应的设备厂商推送通道以提高这些设备上的到达率。

说明

移动推送优先选择自有通道进行推送消息下发,只有在自有通道断连时才会选择厂商通道下发消息。

请根据自身需求选择厂商通道进行集成。

第二步:接入辅助弹窗

厂商通道可以在App被终止情况下将通知消息推送到手机通知栏。点击通知的响应需要您接入辅助弹窗才能实现通知消息的接收和处理。当前移动推送已接入小米、华为、荣耀、OPPO、vivo、魅族辅助弹窗。

SDK 3.x: 辅助弹窗接入方式请查看辅助弹窗接入(3.x)。

重要

SDK 3.x 的厂商通道通知点击业务不在MessageReceiver/AliyunMessageIntentService的回调中处理,请在辅助弹窗回调中处理。

SDK 4.x:辅助弹窗 Activity 仍是厂商通知点击的中转入口;点击数据解析成功后,业务回调统一进入 MessageReceiver.onNotificationOpened 或 AliyunMessageIntentService.onNotificationOpened。不再使用 onSysNoticeOpened、onNotPushData、onParseFailed 处理业务。配置方式请参见辅助弹窗接入(4.x)。

重要

Android SDK 4.x 中,MessageReceiver 和 AliyunMessageIntentService 的业务回调范围如下:

  • ACCS 自有通道和 FCM:支持消息接收(onMessage)、通知到达(onNotification)、通知点击(onNotificationOpened)、通知清除(onNotificationRemoved)等完整业务回调。

  • 除 FCM 外的其他 Android 厂商通道:仅支持 onNotificationOpened(通知点击),不触发消息接收、通知到达、通知清除等其他回调。

场景解析

普通推送与辅助弹窗的通用场景:厂商通道集成场景解析

具体点击处理请按所用 SDK 参见辅助弹窗接入(3.x)或辅助弹窗接入(4.x)。