安卓厂商接入文档

说明

厂商（华为、小米、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)在推送运营平台的首页点击立即开通

(2)开通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.推送小图等功能

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

如使用了小米代理通道，需要针对2023年小米消息推送新规进行适配，若不适配会导致小米代理公信配额缩减到1倍日活用户数。如需适配请参考2023年小米消息推送新规适配指南

小米代理接入

创建小米厂商应用

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推送运营平台账号，详细注册流程请参考：注册为开发者

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

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

4.开通PUSH服务

（1）登录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消息推送平台账号（仅支持企业用户注册）

2.创建应用

（1）上传应用

（2）完善信息

（3）选择发布时间，提交审核

3.申请push服务

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

（2）进入应用列表界面，点击"应用名称"选择要申请的应用后点击"提交申请"，开通push服务

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

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

温馨提示

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

VIVO厂商特性

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

2.可自定义时间段推送

3.消息分类功能见消息分类适配文档详细介绍

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

魅族代理接入

创建魅族厂商应用

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

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

（1）进入控制台，点击"集成推送"进入新建应用界面，获取应用的AppID、AppKey和AppSecret，如下所示：

（2）点击新建应用

（3）填写应用包名、类型等信息

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

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

温馨提示

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

推送回执接入

在Flyme开放平台配置管理中设置回执（可选项，如不要回执可跳过），回执地址设置为：http://iosack.tuisong.baidu.com/mzack ，如下所示:

魅族厂商特性

1.仅支持通知类型消息

2.到达速度快

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

荣耀代理接入

注册荣耀开发者账号

1.注册

准备资料

中国大陆开发者

帐号类型	服务类型	所需资料
企业	人工审核	1、营业执照原件扫描件或照片; 2、法定代表人手持身份证正反面照片或法人身份证正反面扫描件并盖公章

海外开发者

帐号类型	服务类型	所需资料
企业	人工审核	1、使用DUNS码进行实名认证; 2、企业资质认证; 3、企业税务登记证明认证

注册流程

1. 点击开发者帐号注册地址，立即注册 1）用户在访客态下点击登录或注册按钮，会依据其IP所在地跳转到相应区域的荣耀帐号登录注册页；

   2）中国大陆IP：跳转简体中文荣耀帐号登录页；

   3）俄罗斯IP：俄文荣耀帐号登录页；

   4）非中国大陆、俄罗斯的海外IP：英文荣耀帐号登录页。

2. 用户注册地区选择，中国大陆IP登录默认为中国大陆地区；若要在注册海外其他地区帐号，可点击海外用户注册页面，在页面中选择其他地区进行注册；企业开发者请在注册时选择您的企业/组织正式注册的国家/地区；

3. 输入正确的邮箱地址/手机号码，输入对应的验证码，设置密码后，点击注册；

4. 签署相关协议后，帐号注册成功，将跳转到实名认证页面。

实名认证

1. 点击页面右上角管理中心或头像右侧的去认证，进入实名认证页面；
2. 完善企业实名认证资料，签署《关于荣耀开发者服务平台与隐私的声明》和《荣耀开发者服务协议》，点击下一步，等待审核，审核结果会在1-3个工作日发送至联系人邮箱

2.创建应用

（1）协议签署

当您首次与荣耀进行合作时，需要签署《荣耀App Distribution Connect服务协议签署》。若您的应用为免费游戏，则需要签署《荣耀App Distribution Connect服务协议签署》、《荣耀APIs使用协议》（若为联运游戏，则需要再签署《荣耀App Distribution Connect联运服务协议》）

(2)新增应用

1） 选择"生态服务"下的"海外应用服务"；

2） 点击"新建"，创建新的应用；

![选择新建](/static/md/console/honor_create_new_app_1.png）

3） 填写"应用名称"，选择"应用分类"和"默认语言"。点击确定后，该新应用会被添加到自己的应用列表当中（如您选择分发全球，默认语言请选择通用语言-英语。如您的应用有特定分发国家/地区，默认语言选择对应分发国家/地区语言即可）。

（3）填写应用信息

1） 在自己的应用列表中，选择需要发布的应用，点击"发布"，即可进入"应用信息"页面开始配置应用基本信息（此信息用于该应用在应用商店客户端部分展示，任何更改将在提交版本信息后生效）。

2) 配置应用语言

默认显示创建应用时设置的默认语言。如需为当前应用添加其他语言，点击"管理语言列表"，在"语言选择"弹窗中勾选语言，点击"确定"。

当前系统支持的语言：中文、英文、俄文、马来文、阿拉伯语、法语、德语、意大利语、西班牙语等七十多种语言。

如配置了多种语言，您需要在"语言"下拉列表中切换已添加的语言，分别为每种语言完善对应的可本地化基础信息。如果您没有为各语言版本添加本地化图片文件，则系统将使用默认语言版本的图片文件。

3) 填写应用名称、应用介绍、应用一句话介绍、新版本特性。

项目	说明
应用名称	必填，默认为创建应用时设置的应用名称。请填写上传应用的官方全称
应用介绍	必填，简单描述该应用的功能、产品定位、使用场景等
应用一句话介绍	选填但建议填写，简要介绍该应用，80字以内。为了更好的界面展示效果，建议此处第一句应突出能吸引用户的应用主要特色，可帮助提升应用下载率
新版本特性	选填，500字以内描述新版本的特性，将在应用商店客户端更新页中展示，可帮助提升应用下载量

4） 上传应用图标、应用截图和视频

说明:

1）图片请提供直角图；

2）应用截图图片之间保证搭配和谐，避免图片风格各不相同；

3）若有手机截屏画面，机型必须与荣耀保持一致；

4）上传的所有素材严禁涉黄涉暴等违反中外发行地法律法规的不良表述及画面。

5) 选择应用分类

6） 配置开发者信息

开发者服务信息会向您应用发布区域的用户公开，请确保您提供的信息都是可公开对外的。该行为的目的是保证用户知情权，便于用户了解更多应用信息，以及用于接收用户反馈和意见等。

（4）填写版本信息

1） 在自己的应用列表中，选择需要发布的应用，点击"发布"，即可进入"版本信息>准备提交"页面。

2） 设置发布国家或地区

您可在下拉框里勾选您的应用需要发布的国家或地区。

审核人员在审核应用时，会检查您的应用是否符合对应国家或地区的政策、宗教文化等要求，如不符合，审核人员会将该国家或地区从您应用的分发国家或地区中去除 。应用审核通过后，您可在对应的应用版本信息界面的"分发国家及区域"位置查看最终分发范围。

3） 是否设置为开放式测试版本

目前应用商店不支持开放式测试，请选择"否"（发布正式版本）。

4） 上传软件包

发布普通APK应用时，支持为该应用上传1个APK软件包，且需满足如下要求 ：

注意 软件包大小在4GB以内；应用包名未被已上架的应用占用。

单击"软件包管理"，在如下页面点击"上传"，可上传应用软件包；

安装包与其他应用包名不可重复，如果遇到重复提示，请在应用列表选择"应用认领"或"重新上传"。

5) 设置应用付费情况

下载安装付费：

当前荣耀应用商店只支持"完全免费"，即您的应用为免费应用，用户可以直接从荣耀应用商店下载安装您的应用。

应用内资费：

请选择您应用内包含的项目。

6) 设置内容分级

将用于标识您的应用适宜用户的年龄段，且告知消费者，并依法在特定区域或特定用户屏蔽或过滤您的内容。请确保您提供的信息的真实性，并且当您应用提供的内容发生变化时，应立即重新进行内容分级。荣耀有权对应用分级制度、年龄分级标准进行调整并通知开发者。

点击"设置"，根据应用内容选择合适的年龄分级。

7） 设置隐私声明

填写隐私政策网址(必填)，供应用上架审核使用。如果您的应用涉及收集、处理用户信息，请提供隐私政策声明的网页链接地址。该网址会在应用的详情页面添加隐私政策跳转，可帮助用户清楚地了解您如何处理敏感的用户数据和设备数据。您的隐私政策必须完整说明您的应用如何收集、使用和分享用户数据，包含但不限于如下情况建议提供：面向儿童的App；包含帐户注册或需要访问用户的现有帐户，或由法律另行规定；对于收集用户或设备相关数据的App。

8） 上传版权信息

电子版权证书：可选。可上传应用的PDF格式"电子版权证书"，大小不超过5MB。如果您上传了非PDF格式的文件或是将非PDF格式的文件的扩展名改为PDF，均会弹出错误提示；

应用版权证书或代理证书：可选。支持JPG、PNG、BMP格式，单个图片最大不能超过15MB。您可上传相关资质文件。

9） 上传版号信息（仅针对游戏类应用）

版号信息：必选，您需要向相关单位申请游戏版号；

版号证明：必选，需上传"版号批文"或"版号授权书"，图片格式支持JPG、JPEG、PNG，不超过4MB。若您在"版号授权书"中上传了版号授权书，您还需填写"授权书有效期"。

10） 应用信息审核

如果您的应用部分功能需要用户进行身份验证后才能使用，请提供测试帐号信息，该测试帐号会被审核员使用，以便完成登录、查看、购买等功能的审核。

![应用审核](/static/md/console/honor_app_check.png）

11) 设置应用上架时间

两种时间可供选择：审核通过立即上架；指定时间：是您的本地时间。

(5) 提交审核

1) 点击提交审核，我们将于3-5个工作日内告知您应用审核结果

2） 再次确定版本信息

4.申请push服务

（1）开放平台首页-管理中心-推送服务

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

6.将荣耀的APP信息ppID、AppKey和AppSecret，保存到百度云推送的应用配置中，如下图所示：

温馨提示

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

推送回执接入

1.开通回执权益: 登录AppGallery Connect 网站 ，选择"管理中心 > 生态服务 > 开发服务 > 推送服务",进入推送服务页面

2.选择需要配置回执的应用，点击 应用回执 ，进入应用回执页面

3.点击新增回执 ，进入回执配置页面

4.进入回执配置页面，需要配置如下参数，*为必填项，如有回执密钥，则需填写

(1)配置消息回执名称:业务自定义，长度不能超过50

(2)配置回调地址:https://iosack.tuisong.baidu.com/honorack