安卓厂商接入文档

说明

厂商(华为、小米、oppo、vivo、魅族等)推送通道是由厂商官方提供的系统级推送通道。在手机上,推送消息能够通过厂商的系统通道抵达终端,并且无需打开应用就能够收到推送。

接入前准备

创建百度云推送的APP,创建步骤请参考接入指南

华为代理接入

华为将在2021年9月30日下架HMS Core 2.x版本的SDK,请您及时检查当前平台使用的华为Push版本,若仍在使用华为Push 2.x版本SDK,请您及时更新到2.x以上的版本,避免影响应用正常使用华为推送能力。

创建厂商应用

1.在开发应用前需要在华为开发者联盟 网站上注册成为开发者并完成实名认证,具体方法可参考帐号注册认证

注册成为华为开发者

2.在华为推送平台创建应用,创建过程参见创建项目和在项目下创建应用(注意:应用包名需跟您在百度云推送填写的包名保持一致)

(1)在我的项目页面点击“添加项目”

注册成为华为开发者

(2)项目创建成功后会自动进入“项目设置”页面

(3)在项目列表中点击您的项目

注册成为华为开发者

(4)在页面顶部的项目名称右边,选择“添加应用”

注册成为华为开发者

(5)在“添加应用”页面填写应用信息

创建华为应用

配置如下:

● “选择平台”:选择“Android”

● “支持设备”:选择“手机”

● “应用分类”:选择“应用”或“游戏

3.开通Push服务

(1)在推送运营平台的首页点击立即开通

注册push组件

(2)开通API权益:开通推送服务后请前往API管理中开启权限,请参见打开服务开关(所有开关均为可选项,打开您需要的服务开关即可)。

API权限

(3)权益配置:目前权益配置包括回执状态、IOS推送代理和WEB推送代理,请按照您的需要开通以下权益并进行配置(此页面的IOS代理推送和WEB代理推送为华为厂商实现的,若要使用IOS代理推送请使用百度云推送的IOS代理推送,百度云推送的IOS代理推送不需要在此配置)

权益配置

4.获取华为厂商应用的APPID、APIKEY和APPSECRET

点击项目管理->选择要查看的应用->进入项目设置界面,获得厂商应用信息

权益配置

5.厂商应用信息与百度云推送应用绑定

获取华为厂商应用的信息APPID、APIKEY和APPSECRET,将APPID、APIKEY和APPSECRET保存到百度云推送的应用配置中,BadgeClass为端上应用程序的入口名(应用包名+应用入口Activity类名,样例:com.example.hmstest.MainActivity。角标推送时需要使用此参数)如下图所示:

第三方应用信息绑定

温馨提示

至此已完成百度云推送的代理(厂商)推送配置,点击应用列表中的创建推送开始厂商推送,消息推送流程请参考创建推送消息

创建推送

推送回执接入

1.开通回执权益: 登录AppGallery Connect 网站 ,选择“我的应用”

我的应用

2.选择需要开通服务的应用所属产品的名称,进入应用信息页面

3.点击“开发”页签,左侧导航选择“增长服务 > 推送服务”

4.点击“开通”,配置推送服务的状态。开通服务后,可以选择是否开通回执

开通回执

5.回执参数配置

(1)回调地址:请填入百度云推送的回执的url:

    https://iosack.tuisong.baidu.com/msgack

(2)配置https证书

HTTPS证书:

    -----BEGIN CERTIFICATE-----
    MIIDrzCCApegAwIBAgIQCDvgVpBCRrGhdWrJWZHHSjANBgkqhkiG9w0BAQUFADBh
    MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
    d3cuZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBD
    QTAeFw0wNjExMTAwMDAwMDBaFw0zMTExMTAwMDAwMDBaMGExCzAJBgNVBAYTAlVT
    MRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5j
    b20xIDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IENBMIIBIjANBgkqhkiG
    9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4jvhEXLeqKTTo1eqUKKPC3eQyaKl7hLOllsB
    CSDMAZOnTjC3U/dDxGkAV53ijSLdhwZAAIEJzs4bg7/fzTtxRuLWZscFs3YnFo97
    nh6Vfe63SKMI2tavegw5BmV/Sl0fvBf4q77uKNd0f3p4mVmFaG5cIzJLv07A6Fpt
    43C/dxC//AH2hdmoRBBYMql1GNXRor5H4idq9Joz+EkIYIvUX7Q6hL+hqkpMfT7P
    T19sdl6gSzeRntwi5m3OFBqOasv+zbMUZBfHWymeMr/y7vrTC0LUq7dBMtoM1O/4
    gdW7jVg/tRvoSSiicNoxBN33shbyTApOB6jtSj1etX+jkMOvJwIDAQABo2MwYTAO
    BgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUA95QNVbR
    TLtm8KPiGxvDl7I90VUwHwYDVR0jBBgwFoAUA95QNVbRTLtm8KPiGxvDl7I90VUw
    DQYJKoZIhvcNAQEFBQADggEBAMucN6pIExIK+t1EnE9SsPTfrgT1eXkIoyQY/Esr
    hMAtudXH/vTBH1jLuG2cenTnmCmrEbXjcKChzUyImZOMkXDiqw8cvpOp/2PV5Adg
    06O/nVsJ8dWO41P0jmP6P6fbtGbfYmbW0W5BjfIttep3Sp+dWOIrWcBAI+0tKIJF
    PnlUkiaY4IBIqDfv8NZ5YBberOgOzW6sRBc4L0na4UU+Krk2U886UAb3LujEV0ls
    YSEY1QSteDwsOoBrp+uvFRTp2InBuThs4pFsiv9kuXclVzDAGySj4dzp30d8tbQk
    CAUw7C29C79Fv1C5qfPrmAESrciIxpg0X40KPMbp1ZWVbd4=
    -----END CERTIFICATE-----

回执地址配置

华为厂商特性

1.支持通知栏消息和透传消息两种消息

2.支持缓存消息,Push平台只缓存一次用户的消息,如果用户在线后还发不通,Push平台不再缓存

3.消息内容最大支持为4K字节(不包括token)

4.支持角标

5.消息分组

6.推送小图等功能

详情请见厂商特性说明文档

小米代理接入

创建小米厂商应用

1.登录 小米开放平台 注册成为小米开发者:参考注册文档

注册小米账户

2.注册应用:可参考 创建及管理应用操作指南

(1)登录小米应用商店开发者站官网点击“上传应用”如下图:

上传应用

(2)点击“创建新应用”来创建您的应用,如下图:

创建应用

(3)选择对应应用类型点击下一步。本文档以应用创建流程为例详细讲述了创建流程,应用创建流程可参见创建应用流程

创建应用

(4)选择应用的默认语言、操作系统后输入应用名称、应用包名后点击“创建”按钮(注意:应用包名需跟您在百度云推送填写的包名保持一致)。如下图:

创建应用

(5)获得应用包名对应的的appID、AppKey和AppSecret,如下图:

创建应用

3.厂商应用信息与百度云推送应用绑定

将小米应用的AppID、AppKey和APPSECRET保存到百度云推送的应用配置中,如下图所示:

第三方应用信息绑定

温馨提示

至此已完成百度云推送的代理(厂商)推送配置,点击应用列表中的创建推送开始厂商推送,消息推送流程请参考创建推送消息

创建推送

小米厂商特性

1.支持通知栏消息和透传消息两种消息

2.支持多channel推送

3.支持私信类型消息

详细文档请参阅:小米厂商特性说明文档

OPPO代理接入

友情提示

:OPPO代理推送目前支持一加5/5t及以上机型和realme所有机型

创建OPPO厂商应用

1.注册OPPO推送运营平台账号,详细注册流程请参考:注册为开发者

注册oppo账号

2.登录OPPO企业开发者帐号,并创建应用,详情请参考应用接入流程

3.确认应用的类型以及填写应用的名称和包名

确认应用信息

4.开通PUSH服务

(1)登录OPPO开放平台,依次选择“应用服务”--“开发服务”--“推送服务”

注册oppo账号

(2)接入推送服务界面可以看到所有APP

应用列表

(3)在未开启服务中点击需要申请push权限的应用,进入PUSH服务并点击申请开通

权限申请

(4)提交申请

提交申请

5.进入“配置管理-应用配置”,查看OPPO应用的APPID、AppKey、AppSecret和MasterSecret

提交申请

6.通道配置请参考OPPO PUSH运营平台使用指南

提交申请

7.将OPPO平台应用的APPID、AppKey、AppSecret和MasterSecret信息保存到百度云推送的应用配置中,如下图所示:

第三方应用信息绑定

温馨提示

至此已完成百度云推送的代理(厂商)推送配置,点击应用列表中的创建推送开始厂商推送,消息推送流程请参考创建推送消息

创建推送

OPPO厂商特性

1.只支持通知消息

2.支持指定channel推送

3.支持私信类型推送

4.支持小图推送

5.支持大图推送

6.支持大文本推送 详细文档请参阅:OPPO厂商特性说明文档

VIVO代理接入

创建VIVO厂商应

1.注册VIVO消息推送平台账号(仅支持企业用户注册)

注册vivo开发者账号

2.创建应用

(1)上传应用

创建应用_1 创建应用_2 创建应用_3

(2)完善信息

完善信息

(3)选择发布时间,提交审核

完善信息

3.申请push服务

(1)开放平台首页-开放能力-消息推送进入

开通push

(2)进入应用列表界面,点击“应用名称”选择要申请的应用后点击“提交申请”,开通push服务

创建push权限 提交push权限

4.在应用列表界面点击应用信息,查看应用的AppID、AppKey、AppSecret

查看应用的信息

5.将VIVO的APP信息ppID、AppKey和AppSecret,保存到百度云推送的应用配置中,如下图所示:

第三方应用信息绑定

温馨提示

至此已完成百度云推送的代理(厂商)推送配置,点击应用列表中的创建推送开始厂商推送,消息推送流程请参考创建推送消息

创建推送

VIVO厂商特性

1.仅支持通知消息类型推送

2.可自定义时间段推送

详细文档请参阅:VIVO厂商特性说明文档

魅族代理接入

创建魅族厂商应用

1、注册Flyme开放平台账号,详细注册流程请参考魅族推送平台接入指南

魅族开发者平台

2、在Flyme开放平台上创建应用

(1)进入控制台,点击“集成推送”进入新建应用界面,获取应用的AppID、AppKey和AppSecret,如下所示:

mz控制台

(2)点击新建应用

mz新建应用

(3)填写应用包名、类型等信息

mz新建应用

3.完成创建后点击【打开应用】进入【配置管理】中的【应用配置】查看APP的APPID、AppKEY和AppSecret信息

mz应用信息 mz应用信息

4.将魅族的APP信息ppID、AppKey和AppSecret,保存到百度云推送的应用配置中,如下图所示:

第三方应用信息绑定

温馨提示

至此已完成百度云推送的代理(厂商)推送配置,点击应用列表中的创建推送开始厂商推送,消息推送流程请参考创建推送消息

创建推送

推送回执接入

Flyme开放平台配置管理中设置回执(可选项,如不要回执可跳过),回执地址设置为:http://iosack.tuisong.baidu.com/mzack ,如下所示: 魅族回执地址配置

魅族厂商特性

1.仅支持通知类型消息

2.到达速度快

详细文档请参阅: 魅族厂商特性说明文档