本文档主要介绍启用小米推送的步骤,以帮助开发者更快速的完成小米推送的接入。
使用小米推送服务前,请先阅读《小米推送隐私政策》。
一、注册小米开发者账号
如果您已经拥有小米开发者账号,可忽略本节,直接阅读“2. 启用推送”。
如果您没有小米开发者账号,请参照《开发者账号注册流程》,访问小米澎湃OS开发者平台完成开发者账号的注册。
开发者账号的审核一般需要1-3个工作日,您可以通过小米澎湃OS开发者平台登录查询结果。
二、启用推送
使用小米开发者账号登录小米澎湃OS开发者平台,在管理中心选择“消息推送”,进入应用列表页。
管理中心页面
推送服务应用列表
应用列表包括该开发者账号下的已有APP(包括Android手机/平板应用、Android TV应用)。
点击“未启用”状态APP的“启用推送”,可以进入消息推送启用页面。
启用推送
启用推送前,您须先阅读《消息分类介绍及运营规范》、《推送消息违规处理办法》、《小米推送技术服务协议》、《小米推送技术服务数据保护附录》。勾选同意接受后,点击右上方按钮进入下一步。
为您的应用创建所需的通知类别:
第一步:点击选择分类,详细的消息分类描述参考《小米推送消息分类新规》;
第二步:按如上要求完整填写相应信息;
第三步:提交审核。
该环节您最多可同时创建8个不同分类的通知类别,我们会在3-5个工作日内完成审核。后续您可在“推送运营平台-消息分类管理”中维护应用的通知类别。
创建应用
如果你想使用的应用不在应用列表内,点击“创建应用”,选择创建手机/平板应用或电视应用。
选择操作系统、填写应用名和包名、选择应用分类,单击“创建”,创建一个新应用。
完成应用创建后,就可以启用该应用的推送服务了。
启用推送服务后,在“应用管理-应用信息”页面可查看该应用对应的AppId、AppKey和 AppSecret。
其中AppId和AppKey是客户端的身份标识,在客户端SDK初始化时使用;AppSecret是服务器端的身份标识,在使用服务端SDK向客户端发送消息时使用。
三、接入PUSH SDK
如果您选定的应用分发/服务的国家是中华人民共和国(不包括中国香港、中国澳门或中国台湾),则需要集成中国大陆版PUSH客户端SDK。
SDK获取方式:
请访问SDK下载页,下载最新版Android客户端SDK。
接入指南:点击查看
四、推送消息
集成PUSH客户端SDK后,您便可以使用推送服务推送消息了,包括三种方式:
- 服务端Java SDK推送:请参见《服务端Java SDK文档》
- 服务端API推送:请参见《服务器API地址以及参数》
- 运营平台推送:请参见《运营平台使用指南》