安卓厂商接入文档

说明

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

接入前准备

创建D推的APP,创建步骤请参考接入指南

华为代理接入

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

创建厂商应用

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

注册成为华为开发者

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

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

注册成为华为开发者

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

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

注册成为华为开发者

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

注册成为华为开发者

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

创建华为应用

配置如下:

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

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

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

3.开通Push服务

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

注册push组件

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

API权限

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

权益配置

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

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

权益配置

5.厂商应用信息与D推应用绑定

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

第三方应用信息绑定

温馨提示

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

创建推送

推送回执接入

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

我的应用

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

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

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

开通回执

5.回执参数配置

(1)回调地址:请填入D推的回执的url:

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

(2)配置https证书

HTTPS证书:

    -----BEGIN CERTIFICATE-----
    MIIGuzCCBaOgAwIBAgIQB4HjqvghvNHNLWd0D8kMczANBgkqhkiG9w0BAQsFADBN
    MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMScwJQYDVQQDEx5E
    aWdpQ2VydCBTSEEyIFNlY3VyZSBTZXJ2ZXIgQ0EwHhcNMjAwMjA0MDAwMDAwWhcN
    MjEwMjI4MTIwMDAwWjCBnzELMAkGA1UEBhMCQ04xEDAOBgNVBAgTB0JlaWppbmcx
    OTA3BgNVBAoTMEJlaUppbmcgQmFpZHUgTmV0Y29tIFNjaWVuY2UgVGVjaG5vbG9n
    eSBDby4sIEx0ZDElMCMGA1UECxMcc2VydmljZSBvcGVyYXRpb24gZGVwYXJ0bWVu
    dDEcMBoGA1UEAwwTKi50dWlzb25nLmJhaWR1LmNvbTCCASIwDQYJKoZIhvcNAQEB
    BQADggEPADCCAQoCggEBANVZ6ZlTKmuEtxsgGGKpy4+zFcwEJ+Pw7hg4lkdtM+v8
    qhioVV17q1OCqT0BkJXB6ao/GTE2RZZ8KQTbvlZJxZckPhitAJD2BgiLMlOKH3Ye
    +YpPqj2yPLM9d0OLfBfVLFxpgUAJCrYlGBdP7ERgURYLI1PL93E02f8sA5QJHDu6
    n7zYLt9O59Si0TCdW2Zfm+6HKtauPMmPeUOLeaGiYm5pas46VkeuUkO0cl7ff2rv
    IOdOpJEWF3t/tdp+V8yuMGSOruswjVGSfATvb+RVASwtbureprRAYmSLxeiYzUmc
    XzolpBECwDkXeX3CdD436+BJlYdUeL4Hmt6ek3EOvNcCAwEAAaOCA0IwggM+MB8G
    A1UdIwQYMBaAFA+AYRyCMWHVLyjnjUY4tCzhxtniMB0GA1UdDgQWBBR202Uj+kPM
    +d2WjZhsWaw0nz4HljCBggYDVR0RBHsweYIVY2hhbm5lbC5hcGkuZHVhcHAuY29t
    ghZjaGFubmVsLmNhcGkuZHVhcHAuY29tgh1jaGFubmVsLmlvc3B1c2guYXBpLmR1
    YXBwLmNvbYIUY2hhbm5lbC5tYy5iYWlkdS5jb22CEyoudHVpc29uZy5iYWlkdS5j
    b20wDgYDVR0PAQH/BAQDAgWgMB0GA1UdJQQWMBQGCCsGAQUFBwMBBggrBgEFBQcD
    AjBrBgNVHR8EZDBiMC+gLaArhilodHRwOi8vY3JsMy5kaWdpY2VydC5jb20vc3Nj
    YS1zaGEyLWc2LmNybDAvoC2gK4YpaHR0cDovL2NybDQuZGlnaWNlcnQuY29tL3Nz
    Y2Etc2hhMi1nNi5jcmwwTAYDVR0gBEUwQzA3BglghkgBhv1sAQEwKjAoBggrBgEF
    BQcCARYcaHR0cHM6Ly93d3cuZGlnaWNlcnQuY29tL0NQUzAIBgZngQwBAgIwfAYI
    KwYBBQUHAQEEcDBuMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5kaWdpY2VydC5j
    b20wRgYIKwYBBQUHMAKGOmh0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdp
    Q2VydFNIQTJTZWN1cmVTZXJ2ZXJDQS5jcnQwCQYDVR0TBAIwADCCAQIGCisGAQQB
    1nkCBAIEgfMEgfAA7gB1ALvZ37wfinG1k5Qjl6qSe0c4V5UKq1LoGpCWZDaOHtGF
    AAABcA8HIfwAAAQDAEYwRAIgDhGiIn4gGGnQE/49VrckUfBJ0bi3rtlcc4LwYE/k
    bwkCIGmod9sIkjgks88JlGM8yF7xgnxfXcz0RVOlx4NzlGsiAHUAXNxDkv7mq0VE
    sV6a1FbmEDf71fpH3KFzlLJe5vbHDsoAAAFwDwciQQAABAMARjBEAiAG+wBvc+f+
    g/Y0tdJH5UkYAVTu1h7XAGTaaoFd+o7DogIgZH44lQNstrPTRaQ3P8/NRGMId/Pw
    7IS02vx+UdlEzOEwDQYJKoZIhvcNAQELBQADggEBAE9gE3eRjQDXhxK8Rc2FGkpt
    2l8cjkOGTP2wsfPXZYyqp+fgx99kubXJGNriiExROXegV7j55fHPM01fluBVlkys
    1n6bmb8yAwEId+ZF6PzOkHNWNd0MBoNnoA8FO2ycXM2ksHhDl/ZBGL7xkR1hv5vf
    6TcOBqcFLthSnEu9fBwqEAUJYIHut+ecq+Zf5CRQvf9Xn89dGehucOVgbjPcUSET
    A1BieeKFU0RipmRCOCrEcyvVDlPKMHDMmfF0iXdgy1vOYWvKd7w65wmbqS2HkycX
    i08wl6H44ciBldGGPOgqdO+cNr6IgzpTHr87ahkQWAEffCGp6w6j3rA0/NfHYE4=
    -----END CERTIFICATE-----

回执地址配置

华为厂商特性

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

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

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

4.支持角标

5.消息分组

6.推送小图等功能

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

小米代理接入

创建小米厂商应用

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

注册小米账户

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

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

上传应用

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

创建应用

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

创建应用

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

创建应用

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

创建应用

3.厂商应用信息与D推应用绑定

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

第三方应用信息绑定

温馨提示

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

创建推送

小米厂商特性

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信息保存到D推的应用配置中,如下图所示:

第三方应用信息绑定

温馨提示

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

创建推送

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,保存到D推的应用配置中,如下图所示:

第三方应用信息绑定

温馨提示

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

创建推送

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,保存到D推的应用配置中,如下图所示:

第三方应用信息绑定

温馨提示

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

创建推送

推送回执接入

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

魅族厂商特性

1.仅支持通知类型消息

2.到达速度快

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