即时通信 IM 小米

本文将介绍如何完成小米离线推送服务厂商配置。
前提条件
开始前，请确认您已具备以下条件：
条件
说明
小米开发者账号
已拥有或准备注册小米开发者账号；启用 PUSH 服务前需完成账号认证，认证可能需要 1-3 个工作日。
已上架小米应用商店的应用
正式使用通知栏推送要求应用已在小米应用商店上架，并满足小米通知类别审核要求。
Android App 包名
小米开放平台中的应用包名必须与 Android 工程的 applicationId 保持一致。
腾讯云账号和即时通信 IM 应用权限
用于在腾讯云控制台添加小米厂商证书。
小米开放平台配置
提示：
本文配置流程可对照小米官方 推送配置指南 操作。
注册小米开发者账号
1. 进入 小米开放平台，注册小米开发者账号并启用推送服务。
2. 使用小米开发者账号登录 小米澎湃 OS 开发者平台，进入管理中心。
﻿
3. 左侧导航栏选择 PUSH 服务，进入应用列表页。
﻿
4. 进入推送服务应用列表。应用列表包括该开发者账号下的已有 App（包括 Android 手机/平板应用、Android TV 应用）。
﻿
5. 单击未启用状态 App 的启用推送，可以进入消息推送启用页面。
启用推送
1. 启用推送前，您须先阅读《消息分类介绍及运营规范》、《推送消息违规处理办法》、《小米推送技术服务协议》、《小米推送技术服务数据保护附录》。勾选同意接受后，点击右上方按钮进入下一步。
﻿
2. 为您的应用创建所需的通知类别：
3. 点击选择分类，详细的消息类型说明请参考《小米推送消息分类新规》。
4. 按新规要求完整填写相应信息。
5. 提交审核。该环节您最多可同时创建 8 个不同分类的通知类别，小米开放平台会在 3-5 个工作日内完成审核。后续您可在推送运营平台 > 消息分类管理中维护应用的通知类别。
﻿
创建应用
1. 如果您想使用的应用不在应用列表内，点击创建应用，选择创建手机/平板应用或创建电视应用。
﻿
2. 选择操作系统，填写应用名称和应用包名，选择应用分类，单击创建，创建一个新应用。
﻿
3. 完成应用创建后，就可以启用该应用的推送服务了。
4. 启用推送服务后，在左侧导航栏选择应用管理 > 应用信息，可查看该应用对应的 AppId、AppKey 和 AppSecret。
其中 AppId 和 AppKey 是客户端的身份标识，在客户端 SDK 初始化时使用；AppSecret 是服务器端的身份标识，在使用服务端 SDK 向客户端发送消息时使用。
﻿
5. 应用列表包括该开发者账号下的已有 App（包括 Android 手机/平板应用、Android TV 应用）。
﻿
查看获取应用信息
进入推送运营平台的应用信息页面，查看应用信息。
﻿
﻿
配置推送证书
登录腾讯云 即时通信 IM 控制台，在推送服务 Push > 推送设置 > 厂商配置中添加小米厂商证书，并按控制台要求填写厂商参数。其中"应用内指定界面"请使用控制台默认配置。
厂商推送平台
IM 控制台配置
﻿
﻿
消息分类限制对推送效果的影响
小米通知消息主要分为私信消息和公信消息。未接入分类的应用会走默认通道（按公信场景配置，但限额更严格）。消息分类会影响推送数量和展示效果，IM 聊天、订单变化、交易提醒等需要及时触达的消息，建议按 小米推送消息分类新规 申请并使用私信消息能力。
警告：
未接入消息分类的应用走默认通道，单设备单日仅可推送 1 条，超出后消息不会下发，是用户反馈"收不到离线推送"的最常见原因。IM 类应用上线前必须完成私信消息接入。具体限额参见 小米推送消息限制说明。
消息类型
推送影响
适用建议
私信消息
通常不限量。
适用于聊天消息、个人订单变化、快递通知、交易提醒、IoT 系统通知等用户有明确预期的消息。
注意：如果将营销、广告等非即时消息配置为私信消息，可能被厂商判定为违规，影响账号或通道权限。
公信消息
按通知开启有效用户数 × 倍数计算单日总量（无许可证 2 倍、有许可证 3 倍）；单设备单日 5-8 条。
适用于热点新闻、新品推广、平台公告、社区话题、有奖活动等普适性内容。
默认通道（未接入分类）
单设备单日仅 1 条，超出后消息不会下发；性质上按公信场景配置，但限额远低于正式公信通道。
IM 类消息必须接入私信消息，禁止长期使用默认通道。
配置消息分类时，请在小米平台完成 Channel 申请及接入；后续可在推送运营平台 > 消息分类管理中维护 Channel。完成小米平台和腾讯云控制台配置后，后续发送离线推送时可在 SDK API 或腾讯云控制台默认配置中设置小米 channelID。具体 API 使用方式请参见 Android SDK 接入文档中的 配置消息分类（可选）。
配置完成检查
完成本篇配置后，请按顺序检查：
检查项
预期结果
应用上架状态
已确认目标应用的小米应用商店上架状态，并满足正式推送和通知类别审核要求。
包名一致性
小米开放平台应用包名与 Android 工程 applicationId 完全一致。
PUSH 服务状态
小米 PUSH 服务已启用，通知类别已创建，并已确认审核状态；正式使用前需审核通过。
应用参数
已记录 AppID、AppKey 和 AppSecret。
腾讯云厂商证书
已在腾讯云控制台添加小米证书，并填写正确参数。
消息分类配置
IM 类消息已申请并接入私信消息 Channel，并已在 API 或腾讯云控制台默认 channelID 中完成配置。未接入时默认通道单设备单日仅 1 条，超出后消息不会下发，会导致大量推送丢失。
下一步请前往 Android SDK 接入，集成 TIMPush。
﻿

条件	说明
小米开发者账号	已拥有或准备注册小米开发者账号；启用 PUSH 服务前需完成账号认证，认证可能需要 1-3 个工作日。
已上架小米应用商店的应用	正式使用通知栏推送要求应用已在小米应用商店上架，并满足小米通知类别审核要求。
Android App 包名	小米开放平台中的应用包名必须与 Android 工程的 `applicationId` 保持一致。
腾讯云账号和即时通信 IM 应用权限	用于在腾讯云控制台添加小米厂商证书。

消息类型	推送影响	适用建议
私信消息	通常不限量。	适用于聊天消息、个人订单变化、快递通知、交易提醒、IoT 系统通知等用户有明确预期的消息。注意：如果将营销、广告等非即时消息配置为私信消息，可能被厂商判定为违规，影响账号或通道权限。
公信消息	按通知开启有效用户数 × 倍数计算单日总量（无许可证 2 倍、有许可证 3 倍）；单设备单日 5-8 条。	适用于热点新闻、新品推广、平台公告、社区话题、有奖活动等普适性内容。
默认通道（未接入分类）	单设备单日仅 1 条，超出后消息不会下发；性质上按公信场景配置，但限额远低于正式公信通道。	IM 类消息必须接入私信消息，禁止长期使用默认通道。

检查项	预期结果
应用上架状态	已确认目标应用的小米应用商店上架状态，并满足正式推送和通知类别审核要求。
包名一致性	小米开放平台应用包名与 Android 工程 `applicationId` 完全一致。
PUSH 服务状态	小米 PUSH 服务已启用，通知类别已创建，并已确认审核状态；正式使用前需审核通过。
应用参数	已记录 AppID、AppKey 和 AppSecret。
腾讯云厂商证书	已在腾讯云控制台添加小米证书，并填写正确参数。
消息分类配置	IM 类消息已申请并接入私信消息 Channel，并已在 API 或腾讯云控制台默认 `channelID` 中完成配置。未接入时默认通道单设备单日仅 1 条，超出后消息不会下发，会导致大量推送丢失。

厂商推送平台	IM 控制台配置

小米

本页目录：

前提条件

小米开放平台配置

注册小米开发者账号

启用推送

创建应用

查看获取应用信息

配置推送证书

消息分类限制对推送效果的影响

配置完成检查