vivo游戏中心下载怎样下载到sdk
点击联系发帖人
时间：2015-02-13 03:02
我手机VIVO S6T 下载游戏内存满了 可扩展内存没东西 我想把游戏下载到扩展内存上怎么做啊_百度知道
我手机VIVO S6T 下载游戏内存满了 可扩展内存没东西 我想把游戏下载到扩展内存上怎么做啊
提问者采纳
你把手机内存的移到sd卡里就可以了，点我的手机。也可以在电脑上下个360手机助手，应用程序-里面就会出现很多软件，点我的应用，在左上有个移植sd卡点设置，点管理应用
提问者评价
其他类似问题
///zhidao/pic//c/guanjia" title="/zhidao/wh%3D600%2C800/sign=ce0aaad6eddc451da68bed4f1b4fd;更多问题去电脑管家企业平台提问吧啊.hiphotos！ ，然后下载游戏的话.baidu你好，你可以试试使用电脑管家来将游戏安装到SD卡的.jpg" target="_blank" title="点击查看大图" class="ikqb_img_alink"><img class="ikqb_img" src="http
已回答238928
响应时间&3小时
扩展内存的相关知识
按默认排序
其他1条回答
你下载一个QQ安全那个玩意，他有一个功能是把下载的东西转移到卡上的很好用的哦，再有就是下载完事东西 把机器开关机一下 让它从新收索一下
您可能关注的推广
等待您来回答
下载知道APP
随时随地咨询
出门在外也不愁vivos6的手机怎样直接把软件和游戏下载到SD卡_百度知道
vivos6的手机怎样直接把软件和游戏下载到SD卡
为什么在91下载一个游戏还会显示没有内存在通用中的SD卡和手机储存中显示SD卡还有3G多的容量？要怎样直接把游戏软件下载到SD卡，然后我在通用中的首选安装位置里设置的是SD卡优先，手机储存只有不到200MB
提问者采纳
包含小挂件的程序，影响软件运行。3。2您好、手机、软件商店的程序;进入：默认，当手机内存小于45M默认安装到SD卡，可自行选择安装的位置，通过手机文件管理安装、其它地方下载的程序，小的系统程序可以安装到手机内存中：1、待机类程序,移动到SD卡;已安装的程序"、SD卡：当手机内存大于45M按默认安装到手机、输入法类程序默认安装到手机内存且安装后不能移到SD卡。程序在安装的规则如下，有三个选项，为减少因软件占用太多手机内存，建议大型游戏或程序安装到TF卡中。安装后可以进入设置-通用-应用程序-已安装中点击"
提问者评价
已回答225008
响应时间&9小时
其他类似问题
sd卡的相关知识
按默认排序
其他1条回答
只要在百信手机下载中心就可以下载了。
您可能关注的推广
等待您来回答
下载知道APP
随时随地咨询
出门在外也不愁帖子很冷清，卤煮很失落！求安慰
驰为V99X最新固件下载（SDK 2.0）
2374浏览 / 11回复
沙发支持哦
楼主怎么没有附件啊？？
楼主忽悠人
怎么什么都没有呀
有没有啊，等待着
怎么什么都没有！！
：驰为V99X最新固件下载……
您需要登录后才可以回帖&&&|&&&&&
用户名/注册邮箱/注册手机号
其他第三方号登录手机游戏下载排行_安卓游戏下载网 - vivo手机软件
手机游戏下载排行_安卓游戏下载网 - vivo手机软件
手机游戏下载排行_安卓游戏下载网 - vivo手机软件
手机客户端 方案
杭州结婚网小米推送服务Server端SDK (MiPushServiceSDK for server) | 小米应用开发者文档
升级新版本v2.1
升级新版本v2.2
增加一些扩展功能，如自定义消息铃声、开启/关闭app在前台时的通知弹出、预定义通知栏通知的点击行为。
2014-07 增加对IOS的支持
在集成过程中遇到任何问题，请联系我们：。您也可以添加QQ群： ，群中会有工程师解答您的问题。
1. 如何接入ServerSDK
开发者需要登录开发者网站，申请AppID, AppKey,
AppSecret。
从开发者网站下载SDK，将MiPush_SDK_Sever目录下的jar文件加入到自己的服务端项目中。Jar文件包括MiPush_SDK_Sever_1_2.jar文件和json-simple-1.1.1.jar。
在开发者网站上，下载并解压MiPush_SDK_V1.2.zip；
将ServerSDK文件夹下的MiPush_SDK_Sever_1_2.jar文件和json-simple-1.1.1.jar文件放入项目工程的libs目录；
刷新工程，确保文件出现在libs目录下。如果没有的话请手动添加；
选择环境。
在正式环境下使用push服务，启动时需要调用如下代码：
Constants.useOfficial();
在测试环境下使用push服务，启动时需要调用如下代码：
Constants.useSandbox();
在测试环境中使用push服务不会影响线上用户。
注：测试环境只提供对IOS支持，不支持Android。
2. 服务端SDK说明
2.1. 服务端SDK类的介绍
表 1. Server SDK类的简介
构建要发送的消息内容。
构建发送给Android设备的Message对象。
IOSBuilder
构建发送给IOS设备的Message对象。
TargetedMessage
构建要发送的消息内容和消息的发送目标。
MiPush消息发送类。
Sender发送消息后，服务器返回的结果。
获取发送的消息统计数据。
追踪消息状态。
Subscription
订阅/取消订阅标签。
获取反馈信息，比如失效的regId列表。注：目前仅支持安卓设备。
常量定义。
Sender发送消息后，返回的错误类型。
2.1.1. Message
Message是MiPush推送服务系统中的消息，开发者可以用它构建要发送的消息体。注:
Message的实例是不可变对象(immutable)，由Builder或IOSBuilder来构建。
java.lang.Object
?com.xiaomi.xmpush.server.Message
2.1.2. Builder
构建发送给Android设备的Message对象。
java.lang.Object
?com.xiaomi.xmpush.server.Message.Builder
表 2. Message.Builder类的方法列表
建立Builder对象，用来构造消息。
payload(String payload)
设置要发送的消息内容payload，不允许全是空白字符，长度小于4K，中英文均以一个计算。
title(String title)
设置在通知栏展示的通知的标题，不允许全是空白字符，长度小于16，中英文均以一个计算。
description(String description)
设置在通知栏展示的通知的描述，不允许全是空白字符，长度小于128，中英文均以一个计算。
passThrough(int passThrough)
设置消息是否通过透传的方式送给app，1表示透传消息，0表示通知栏消息。
notifyType(Integer type)
设置通知类型，type的值可以是DEFAULT_ALL或者以下其他几种的OR组合：
DEFAULT_ALL = -1;
DEFAULT_SOUND
// 使用默认提示音提示
DEFAULT_VIBRATE = 2;
// 使用默认震动提示
DEFAULT_LIGHTS = 4;
// 使用默认led灯光提示
restrictedPackageName(String packageName)
设置app的包名packageName。packageName必须和开发者网站上申请的结果一致。
timeToLive(int milliseconds)
可选项。如果用户离线，设置消息在服务器保存的时间，单位：ms。服务器默认最长保留两周。
timeToSend(long timeToSend)
可选项。定时发送消息。timeToSend是用自日以来00:00:00.0
UTC时间表示（以毫秒为单位的时间）。注：仅支持七天内的定时消息。
notifyId(Integer id)
可选项。默认情况下，通知栏只显示一条推送消息。如果通知栏要显示多条推送消息，需要针对不同的消息设置不同的notify_id（相同notify_id的通知栏消息会覆盖之前的）。
enableFlowControl(boolean needFlowControl)
可选项。控制消息是否需要进行平缓发送（qps less 1000/second）。默认不支持。
extra(String key, String value)
可选项，对app提供一些扩展的功能，请参考2.2。除了这些扩展功能，开发者还可以定义一些key和value来控制客户端的行为。注：key和value的字符数不能超过1024，至多可以设置10个key-value键值对。
根据前面的属性，生成message对象。
private Message buildMessage() throws Exception {
String PACKAGENAME = "com.xiaomi.mipushdemo";
String messagePayload = “This is a message”;
String title = “notification title”;
String description = “notification description”;
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.passThrough(1)
//消息使用透传方式
.notifyType(1)
// 使用默认提示音提示
2.1.3. IOSBuilder
构建发送给IOS设备的Message对象。
java.lang.Object
?com.xiaomi.xmpush.server.Message.IOSBuilder
表 3. Message.IOSBuilder类的方法列表
IOSBuilder()
建立IOSBuilder对象，用来构造消息。APNs消息体为256个字符。
description(String description)
设置在通知栏展示的通知的描述。
timeToLive(int milliseconds)
可选项。如果用户离线，设置消息在服务器保存的时间，单位：ms。服务器默认最长保留两周。
timeToSend(long timeToSend)
可选项。定时发送消息。timeToSend是用自日以来00:00:00.0
UTC时间表示（以毫秒为单位的时间）。注：仅支持七天内的定时消息。
soundURL(String url)
可选项，自定义消息铃声。
badge(int badge)
可选项，自定义通知数字角标。
category(String category)
可选项，iOS8推送消息快速回复类别。
extra(String key, String value)
可选项，自定义键值对。控制客户端的行为。注：至多可以设置10个key-value键值对。
根据前面的属性，生成message对象。
private Message buildMessage() throws Exception {
String description = “notification description”;
Message message = new Message.IOSBuilder()
.description(description)
.soundURL(“default”)
// 消息铃声
// 数字角标
.category("action")
// 快速回复类别
.extra("key", "value")
// 自定义键值对
2.1.4. TargetedMessage
TargetedMessage封装了MiPush推送服务系统中的消息Message对象，和该Message对象所要发送到的目标。
java.lang.Object
?com.xiaomi.xmpush.server.TargetedMessage
表 4. TargetedMessage方法列表
TargetedMessage()
构造函数。
setTarget(int targetType, String target)
设置消息的发送目标。
targetType表示目标类型，目前支持TargetedMessage.TARGET_TYPE_REGID和TargetedMessage.TARGET_TYPE_ALIAS两种类型。当targetType是TARGET_TYPE_REGID时，target需要设置为regid；当targetType是TARGET_TYPE_ALIAS时，target需要设置为alias。
setMessage(Message message)
设置消息。
注意：下面函数返回的List中所有 TargetedMessage对象的targetType必须相同：全是
TargetedMessage.TARGET_TYPE_REGID，或者全是TargetedMessage.TARGET_TYPE_ALIAS。
private List&TargetedMessage& buildMessages() throws Exception {
List&TargetedMessage& messages = new ArrayList&TargetdMessage&();
TargetedMessage message1 = new TargetedMessage();
message1.setTarget(TargetedMessage.TARGET_TYPE_ALIAS, “alias1”);
message1.setMessage(buildMessage());
messages.add(message1);
TargetedMessage message2 = new TargetedMessage();
message2.setTarget(TargetedMessage.TARGET_TYPE_ALIAS, “alias2”);
message2.setMessage(buildMessage());
messages.add(message2);
2.1.5. Sender
MiPush消息发送类。
java.lang.Object
?com.xiaomi.xmpush.server.Sender
表 5. Sender方法列表
Sender(String appSecret)
构造Sender对象。appSecret是在开发者网站上注册时生成的, 可在应用详情下查看。
send(Message message, String registrationId,int retries)
根据registrationId，发送消息到指定设备上，retries为发送失败之后重试的次数。
send(Message message, List&String& regIds, int retries)
根据regIds，发送消息到指定的一组设备上，retries为发送失败之后重试的次数。
send(List&TargetedMessage&messages, int retries)
发送一组消息。其中TargetedMessage类中封装了Message对象和该Message所要发送的目标。注意：messages内所有TargetedMessage对象的targetType必须相同，
不支持在一个调用中同时给regid和alias发送消息。
send(List&TargetedMessage& messages, int retries, long
timeToSend)
定时发送一组消息。timeToSend是用自日以来00:00:00.0 UTC时间表示（以毫秒为单位的时间）。
注：仅支持七天内的定时消息。
sendToAlias(Message message, String alias, int retries)
根据alias，发送消息到指定设备上，retries为发送失败之后重试的次数。alias不允许全是空白字符，不能包含逗号，长度小于128，中英文均以一个计算。
sendToAlias(Message message, List&String& aliasList, int
根据aliasList，发送消息到指定的一组设备上，retries为发送失败之后重试的次数。aliasList中的每个元素不允许全是空白字符，不能包含逗号，长度小于128，中英文均以一个计算；元素的个数不得超过1000个。
broadcast(Message message, String topic, int retries)
根据topic，发送消息到指定一组设备上，retries为发送失败之后重试的次数。topic不允许全是空白字符，长度小于128，中英文均以一个计算。
broadcastAll(Message message, int retries)
向所有设备发送消息，retries为发送失败之后重试的次数。
multiTopicBroadcast(Message message, List&String& topics,
BROADCAST_TOPIC_OP topicOp, int retries)
向多个topic广播消息，支持topic间的交集、并集或差集（如果只有一个topic请用单topic版本）。
其中，BROADCAST_TOPIC_OP是一个枚举类型，指定了发送广播消息时多个topic之间的运算关系。
public enum BROADCAST_TOPIC_OP {
INTERSECTION, // 交集
例如：topics的列表元素是[A, B, C, D]，则并集结果是A∪B∪C∪D，交集的结果是A ∩B ∩C
∩D，差集的结果是A-B-C-D
注：发送广播消息时topic的数量不能超过5。
checkScheduleJobExist(String msgId)
检测定时消息的任务是否存在。
deleteScheduleJob(String msgId)
删除指定的定时消息。
private void sendMessage() throws Exception {
Constants.useOfficial();
Sender sender = new Sender(APP_SECRET_KEY);
String messagePayload= “This is a message”;
String title = “notification title”;
String description = “notification description”;
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.notifyType(1)
// 使用默认提示音提示
sender.send(message, regId, 0); //根据regID，发送消息到指定设备上，不重试。
private void sendMessages() throws Exception {
Constants.useOfficial();
Sender sender = new Sender(APP_SECRET_KEY);
List&TargetedMessage& messages = new ArrayList&TargetdMessage&();
TargetedMessage targetedMessage1 = new TargetedMessage();
targetedMessage1.setTarget(TargetedMessage.TARGET_TYPE_ALIAS, “alias1”);
String messagePayload1= “This is a message1”;
String title1 = “notification title1”;
String description1 = “notification description1”;
Message message1 = new Message.Builder()
.title(title1)
.description(description1).payload(messagePayload1)
.restrictedPackageName(MY_PACKAGE_NAME)
.notifyType(1)
// 使用默认提示音提示
targetedMessage1.setMessage(message1);
messages.add(targetedMessage1);
TargetedMessage targetedMessage2 = new TargetedMessage();
targetedMessage1.setTarget(TargetedMessage.TARGET_TYPE_ALIAS, “alias2”);
String messagePayload2= “This is a message2”;
String title2 = “notification title2”;
String description2 = “notification description2”;
Message message2 = new Message.Builder()
.title(title2)
.description(description2).payload(messagePayload2)
.restrictedPackageName(MY_PACKAGE_NAME)
.notifyType(1)
// 使用默认提示音提示
targetedMessage2.setMessage(message2);
messages.add(targetedMessage2);
sender.send(messages, 0); //根据alias，发送消息到指定设备上，不重试。
private void sendMessageToAlias() throws Exception {
Constants.useOfficial();
Sender sender = new Sender(APP_SECRET_KEY);
String messagePayload = “This is a message”;
String title = “notification title”;
String description = “notification description”;
String alias = “testAlias”;
//alias非空白，不能包含逗号，长度小于128。
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.notifyType(1)
// 使用默认提示音提示
sender.sendToAlias(message, alias, 0); //根据alias，发送消息到指定设备上，不重试。
private void sendMessageToAliases() throws Exception {
Constants.useOfficial();
Sender sender = new Sender(APP_SECRET_KEY);
String messagePayload = “This is a message”;
String title = “notification title”;
String description = “notification description”;
List&String& aliasList = new ArrayList&String&();
aliasList.add(“testAlias1”);
//alias非空白，不能包含逗号，长度小于128。
aliasList.add(“testAlias2”);
//alias非空白，不能包含逗号，长度小于128。
aliasList.add(“testAlias3”);
//alias非空白，不能包含逗号，长度小于128。
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.notifyType(1)
// 使用默认提示音提示
sender.sendToAlias(message, aliasList, 0); //根据aliasList，发送消息到指定设备上，不重试。
private void sendBroadcast() throws Exception {
Constants.useOfficial();
Sender sender = new Sender(APP_SECRET_KEY);
String messagePayload = “This is a message”;
String title = “notification title”;
String description = “notification description”;
String topic = “testTopic”;
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.notifyType(1)
// 使用默认提示音提示
sender.broadcast(message, topic, 0); //根据topic，发送消息到指定一组设备上，不重试。
2.1.6. Result
Sender发送消息给服务器之后，服务器返回的结果
java.lang.Object
?com.xiaomi.xmpush.server.Result
表 6. Result方法列表
String getMessageId()
如果消息发送成功，服务器返回消息的ID；如果发送失败，返回null。
ErrorCode getErrorCode()
发送消息返回的错误码，如果返回ErrorCode.Success表示发送成功，其他表示发送失败。
String getReason()
如果消息发送失败，服务器返回错误原因的文字描述；如果发送成功，返回null。
Result对于sendToAlias()，broadcast()和send()使用方式完全一样。
private void sendMessage() throws Exception {
Constants.useOfficial();
Sender sender = new Sender(APP_SECRET_KEY);
String messagePayload = “This is a message”;
String title = “notification title”;
String description = “notification description”;
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.notifyType(1)
// 使用默认提示音提示
Result result = sender.send(message, regId, 0); //Result对于sendToAlias()，broadcast()和send()调用方式完全一样
Log.v("Server response: ", "MessageId: " + result.getMessageId()
+ " ErrorCode: " + result.getErrorCode().toString()
+ " Reason: " + result.getReason());
2.1.7. Stats
获取发送的消息统计数据。
com.xiaomi.xmpush.server.HttpBase
?com.xiaomi.xmpush.server.Stats
表 7. Stats方法列表
Stats(String appSecret)
构造Stats对象。appSecret是在开发者网站上注册时生成的, 可在应用详情下查看。
String getStats(String startDate, String endDate, String
restrictedPackageName, int retries)
获取指定日期范围内的日统计数据（如果日期范围包含今日，则今日数据为从今天00：00开始到现在的累计量)。
开始日期和结束日期必须符合yyyyMMdd的格式，并且时间跨度小于30天。
start_date表示开始日期，如
end_date表示结束日期 ，如
restrictedPackageName。
Android设备，传入App的包名
IOS设备，传入App的Bundle Id
retries表示重试的次数
返回值说明
返回的是json格式的字符串。
如果成功，则返回的字符串格式如下。
{“result”:”ok”,”reason”:”成功”,”description”:”成功”,”data”:{“data”:”[{"date":"yyyyMMdd","single_recipients":XXXX,"broadcast_recipients":XX,"received":XXXX,"click":XXXX}...{"date":"yyyyMMdd","single_recipients":XXXX,"broadcast_recipients":XX,"received":XXXX,"click":XXXX}]“},”code”:0}
其中，single_recipients表示的是单发（发送到指定的regid或者alias）消息量，broadcast_recipients表示的是群发（发送到指定的topic）消息量，received表示的是消息的接受量（包括单发消息和群发消息），click表示通知栏消息的点击量。
如果失败，则返回的字符串格式如下。
{“result”:”error”,”reason”:”XXXXXXXXX”,”description”:”XXXX”,”code”:XXXX}
private void getStatsData() throws Exception {
Constants.useOfficial();
Stats stats = new Stats(APP_SECRET_KEY);
String result = stats.getStats("", "", PACKAGE_NAME, 0);
2.1.8. Tracer
追踪消息状态。
com.xiaomi.xmpush.server.HttpBase
?com.xiaomi.xmpush.server.Tracer
表 8. Tracer方法列表
Tracer(String appSecret)
构造Tracer对象。appSecret是在开发者网站上注册时生成的, 可在应用详情下查看。
String getMessageStatus(String msgId, int retries)
获取指定ID的消息状态。
String getMessageStatus(long beginTime, long endTime, int retries)
获取某个时间间隔内所有消息的状态。
beginTime表示开始时间戳，单位ms。
endTime表示结束时间戳，单位ms。
retries表示重试的次数。
返回值说明
如果成功，则返回的字符串格式如下。
{“result”:”ok”,”reason”:”成功”,”description”:”成功”,”data”:[{"data":"
{"id\":XXXX,"delivery_rate":XXXX,"delivered":XXXX,"resolved":XXXX,"msg_type":XXXX,
"create_time":XXXX,"time_to_live":XXXX,"click":XXXX,"click_rate":XXXX},....]“},”code”:0}
表示单条消息的id，delivered表示消息的送达数，resolved表示消息的计划送达数，delivery_rate表示送达率，click表示消息的点击数，click_rate表示消息的点击率，create_time表示消息的发送时间，time_to_live表示消息的有效期，msg_type表示该消息发送的方式(msg_type分为Common、BatchRegId、Alias、BatchAlias、Topic)。
如果失败，则返回的字符串格式如下。
{“result”:”error”,”reason”:”XXXXXXXXX”,”description”:”XXXX”,”code”:XXXX}
如果该时间区间内的消息数大于100条，则返回最接近结束时间的100条。
开始时间和结束时间之间的跨度不能大于7天。
public void getTrace() throws Exception {
Tracer tracer = new Tracer(APP_SECRET_KEY); // 使用AppSecretKey创建一个Tracer对象
// 获取单条消息的送达状态， 参数： msgId, retry次数
String messageStatus = tracer.getMessageStatus("s7636237jB", 0);
System.out.println(messageStatus);
// 获取一个时间区间内的消息的送达状态， 参数：开始时间， 结束时间， retry次数
String messageStatus2 = tracer.getMessageStatus(System.currentTimeMillis() - 1000, System.currentTimeMillis(), 0);
System.out.println(messageStatus2);
2.1.9. Subscription
订阅/取消订阅标签。
com.xiaomi.xmpush.server.HttpBase
?com.xiaomi.xmpush.server.Subscription
表 9. Subscription方法列表
Subscription(String appSecret)
构造Subscription对象。appSecret是在开发者网站上注册时生成的, 可在应用详情下查看。
subscribeTopic(List&String& regIds, String topic, String category, int
给一组regid列表订阅标签。其中，retries表示重试的次数，catergory可以使用null。
subscribeTopic(String regId, String topic, String category, int
给某个regid订阅标签。
unsubscribeTopic(List&String& regIds, String topic, String category, int
取消一组regid列表的标签。
unsubscribeTopic(String regId, String topic, String category, int
取消某个regid的标签。
subscribeTopicByAlias（String topic, List&String& aliases, String
category, int retries）
给一组alias列表订阅标签。
unsubscribeTopicByAlias（String topic, List&String& aliases, String
category, int retries）
取消一组alias列表的标签。
2.1.10. Feedback
获取反馈信息。
注：目前仅支持安卓设备。
com.xiaomi.xmpush.server.HttpBase
?com.xiaomi.xmpush.server.Subscription
表 10. Feedback方法列表
Feedback(String appSecret)
构造Feedback对象。appSecret是在开发者网站上注册时生成的, 可在应用详情下查看。
getInvalidRegIds(int retries)
获取失效的regId列表。
该API两点说明：
获取失效的regId列表，每次请求最多返回1000个regId。
每次请求之后，成功返回的失效的regId将会从MiPush数据库删除。
返回的是json格式的字符串，分为以下三种情况。
存在失效的regid
{“result”:”ok”,”description”:”成功”,”data”:{“list”:["regid1","regid2","regid3"]},”code”:0}
不存在失效的regid
{“result”:”ok”,”description”:”成功”,”data”:{“list”:[]},”code”:0}
请求存在异常
{“result”:”error”,”reason”:”Invalid application
secret.”,”description”:”认证失败”,”code&#}
2.1.11. Constants
系统常量定义
java.lang.Object
?com.xiaomi.xmpush.server.Constants
如果需要在测试环境(Sandbox)和正式环境切换,
可以调用Constants.useSandbox()切换到开发环境上，使用测试环境(Sandbox)不会影响到线上的在线用户；开发完成后，再切换到正式环境。
注：测试环境只提供对IOS支持，不支持Android。
Constants.useOfficial(); //使用正式环境
Constants.useSandbox(); //使用开发环境
2.1.12. ErrorCode
java.lang.Object
com.xiaomi.push.sdk.ErrorCode
该类是服务器返回的错误码类
2.2. 针对Android设备提供的扩展功能
在利用Message.Builder构造Message对象时，通过调用extra(String key, String
value)方法设置key和value，可以自定义app的扩展功能。
2.2.1. 自定义消息铃声
调用Message.Builder类的extra(String key, String
value)方法将key设置为Constants.EXTRA_PARAM_SOUND_URI，value设置为铃声的URI。
铃声只能使用当前app内的资源，URI格式满足 android.resource://your packagename/XXX/XXX。
铃声文件放在Android app的raw目录下。
只适用于通知栏消息。
private Message buildMessage() throws Exception {
String PACKAGENAME = "com.xiaomi.mipushdemo";
String messagePayload = “This is a message”;
String title = “notification title”;
String description = “notification description”;
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.passThrough(0)
//消息使用通知栏方式
.notifyType(1)
.extra(Constants.EXTRA_PARAM_SOUND_URI, "android.resource://" + PACKAGENAME + "/raw/shaking")
2.2.2. 开启/关闭app在前台时的通知弹出
当app在前台时，默认情况下服务端向客户端发送通知栏消息，app会弹出通知；如果开发者不想让客户端弹出通知，需要调用Message.Builder类的extra(String
key, String value)方法将key设置为Constants.EXTRA_PARAM_NOTIFY_FOREGROUND，value设置为+。
注：只适用于通知栏消息。
private Message buildMessage() throws Exception {
String PACKAGENAME = "com.xiaomi.mipushdemo";
String messagePayload = “This is a message”;
String title = “notification title”;
String description = “notification description”;
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.passThrough(0)
//消息使用通知栏方式
.notifyType(1)
.extra(Constants.EXTRA_PARAM_NOTIFY_FOREGROUND, "0")
2.2.3. 预定义通知栏通知的点击行为
目前支持三种预定义点击行为。
通过调用Message.Builder类的extra(String key, String value)方法，将key设置为Constants.EXTRA_PARAM_NOTIFY_EFFECT，value设置为Constants.NOTIFY_LAUNCHER_ACTIVITY、Constants.NOTIFY_ACTIVITY或Constants.NOTIFY_WEB以得到不同的预定义行为。
Constants.NOTIFY_LAUNCHER_ACTIVITY：打开当前app对应的Launcher Activity。
Constants.ACTIVITY：打开当前app内的任意一个Activity。
Constants.NOTIFY_WEB：打开网页。
app打开相应的Activity后，可以调用Intent的getSerializableExtra（PushMessageHelper.KEY_MESSAGE）方法得到MiPushMessage对象。
客户端参考代码如下：
MiPushMessage message = (MiPushMessage) intent.getSerializableExtra（PushMessageHelper.KEY_MESSAGE）;
注：用户点击预定义通知栏消息后，小米推送安卓客户端SDK会利用Intent将消息传到相应的Activity而不是通过调用onReceiveMessage(Context
context, MiPushMessage message)方法传过去。
2.2.3.1. 打开当前app对应的Launcher Activity
调用Message.Builder类的extra(String key, String
value)方法将key设置为Constants.EXTRA_PARAM_NOTIFY_EFFECT，value设置为Constants.NOTIFY_LAUNCHER_ACTIVITY。
private Message buildMessage() throws Exception {
String PACKAGENAME = "com.xiaomi.mipushdemo";
String messagePayload = “This is a message”;
String title = “notification title”;
String description = “notification description”;
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.passThrough(0)
//消息使用通知栏方式
.notifyType(1)
.extra(Constants.EXTRA_PARAM_NOTIFY_EFFECT, Constants.NOTIFY_LAUNCHER_ACTIVITY)
2.2.3.2. 打开当前app内的任意一个Activity
调用Message.Builder类的extra(String key, String
value)方法将key设置为Constants.EXTRA_PARAM_NOTIFY_EFFECT，value设置为Constants.NOTIFY_ACTIVITY；再次调用extra(String
key, String value)方法，将key设置为Constants.EXTRA_PARAM_INTENT_URI，value设置为要启动Activity的intent
获取Intent URI的具体步骤是：
在安卓客户端的工程的AndroidManifest.xml里定义一个Activity。例如下面是一个展示新闻的Activity：
&activity android:name=".NewsActivity"/&
定义一个Intent来启动该Activity。例如要打开 1.
中定义的NewsActivity可定义Intent为：
Intent intent = new Intent(context, NewsActivity.class);
把Intent转换成Intent URI字符串；转换得到的Intent URI的格式是：
intent:#Icomponent=com.yourpackage/.YourAend
例如转换２.中的intent为uri：
String uriString = intent.toUri(Intent.URI_INTENT_SCHEME);//该uriString就是Constants.EXTRA_PARAM_INTENT_URI对应的值
返回值是：
intent:#Icomponent=com.xiaomi.mipushdemo/.NewsAend
如果你希望在Intent URI 中携带数据，注意一个限制：Intent.toUri(Intent.URI_INTENT_SCHEME) 返回的结果不会携带除基本类型（boolean, byte,
short, int, long, float, double, String）以外的数据类型，例如数组和HashMap。
获取了Intent URI之后，在服务端的工程里（需要引用推送服务器SDK），把uriString
设置进的Message.Builder.extra()，对应的key是Constants.EXTRA_PARAM_INTENT_URI.
private Message buildMessage() throws Exception {
String PACKAGENAME = "com.xiaomi.mipushdemo";
String messagePayload = “This is a message”;
String title = “notification title”;
String description = “notification description”;
return new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.passThrough(0)
//消息使用通知栏方式
.notifyType(1)
.extra(Constants.EXTRA_PARAM_NOTIFY_EFFECT, Constants.NOTIFY_ACTIVITY)
.extra(Constants.EXTRA_PARAM_INTENT_URI,
"intent:#Icomponent=com.xiaomi.mipushdemo/.NewsAend")
2.2.3.3. 打开网页
调用Message.Builder类的extra(String key, String
value)方法将key设置为Constants.EXTRA_PARAM_NOTIFY_EFFECT，value设置为Constants.NOTIFY_WEB；再次调用extra(String
key, String value)方法，将key设置为Constants.EXTRA_PARAM_WEB_URI，value设置为要打开网页的URI。
private Message buildMessage() throws Exception {
String PACKAGENAME = "com.xiaomi.mipushdemo";
String messagePayload = “This is a message”;
String title = “notification title”;
String description = “notification description”;
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.passThrough(0)
//消息使用通知栏方式
.notifyType(1)
.extra(Constants.EXTRA_PARAM_NOTIFY_EFFECT, Constants.NOTIFY_WEB)
.extra(Constants.EXTRA_PARAM_WEB_URI, "")
2.2.4. 使用自定义通知栏样式
如果系统默认的通知栏样式不满足需求，开发者可以自定义通知栏样式。SDK根据推送消息中指定的layout文件和填充内容，自由定制展示样式。
注意，在MIUI中，通知展示由系统通道负责，需要MIUI升级后才支持自定义通知。具体使用方法如下：
layout文件中只能包含以下控件: FrameLayout, LinearLayout, RelativeLayout, Button, ImageButton, ImageView, ProgressBar, TextView
调用Message.Builder类的extra(String key, String
value)方法将以“layout_name”为key，value设置为客户端要展示的layout文件名；
以“layout_value”为key，指定layout中各控件展示的内容，其value为一个Json。
其格式为{“text”:{“txt_res_name1”:”txt_value1”, “txt_res_name2”:”txt_value2”…},
“image”:{“img_res_name1”:”img_value1”, “img_res_name2”:”img_value2”…},
“time”:{“time_res_name”:”format_value”}}，
txt_res_name为layout文件中的控件名字，txt_value为控件上需要展示的文本内容。
img_res_name为layout中需要展示图片资源的控件名字，img_value为程序中对应的资源名。
time_res_name为layout文件中的控件名字，format_value为控件上需要展示的时间format样式。默认 yy-MM-dd
Demo:以下消息，将指定以custom_notify为通知栏样式，将其中的titleText设置为“我是标题”，descText设置为“我是描述”；将iconImage设置为icon对应的图片。
private Message buildMessage() throws Exception {
String PACKAGENAME = "com.xiaomi.mipushdemo";
String messagePayload = “This is a message”;
String title = “notification title”;
String description = “notification description”;
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.passThrough(0)
//消息使用通知栏方式
.notifyType(1)
.extra("layout_name","custom_notify")
.extra("layout_value", "{\"text\":{\"titleText\":\"标题\"},\"image\": {\"iconImage\": \"icon\"},
\"time\": {\"timeText\": \"HH:mm\"}}")
2.2.5. 指定消息的过滤规则
开发者通过调用Message.Builder类的extra(String key, String
value)来指定消息的过滤规则。另外，过滤规则能够支持所有的消息。
表 11. 消息的过滤规则
可以接收消息的设备的语言范围，用逗号分隔。
当前设备的local的获取方法：
Locale.getDefault().toString()
比如，中国大陆用”zh_CN”表示。
locale_not_in
无法收到消息的设备的语言范围，逗号分隔。
model支持三种用法。
可以收到消息的设备的机型范围，逗号分隔。
当前设备的model的获取方法：
Build.MODEL
比如，小米手机4移动版用”MI 4LTE”表示。
可以收到消息的设备的品牌范围，逗号分割。
比如，三星手机用”samsung”表示。 （目前覆盖42个主流品牌，对应关系见附录”品牌表”）
可以收到消息的设备的价格范围，逗号分隔。
比如，0-999价格的设备用&#″表示。 （目前覆盖4个价格区间，对应关系见附录”价格表”）
model_not_in
无法收到消息的设备的机型范围，逗号分隔。
app_version
可以接收消息的app版本号，用逗号分割。
安卓app版本号来源于manifest文件中的”android:versionName”的值。
注：目前支持MiPush_SDK_Client_2_2_12_sdk.jar（及以后）的版本。
app_version_not_in
无法接收消息的app版本号，用逗号分割。
指定在特定的网络环境下才能接收到消息。
目前仅支持指定”wifi”。
private Message buildMessage() throws Exception {
String PACKAGENAME = "com.xiaomi.mipushdemo";
String messagePayload = “This is a message”;
String title = “notification title”;
String description = “notification description”;
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.passThrough(0)
//消息使用通知栏方式
.notifyType(1)
.extra("locale","zh_CN")
2.2.6. 开启消息的送达回执
调用Message.Builder类的extra(String key, String
value)方法将key设置为”callback”，value设置为第三方接收回执的http接口。
小米推送服务器每隔1s将已送达的消息ID和对应设备的regid或alias通过调用第三方http接口传给开发者。（每次调用后，小米推送服务器会清空这些数据，下次传给开发者将是新一拨数据。）
注：消息的送达回执只支持单发消息。
第三方接收消息回执的http接口协议定义如下：
表 12. 消息回执接口http协议
一个json字符串，形如：
{“axxxxxx”:”alias6,alias7,alias9″,
“sxxxxxx”:”regId0,regId1,regId2,regId3,regId4,regId5,regId8″}，
表示axxxxxx这个消息已经有alias6， alias7，
alias9收到，sxxxxxx这条消息已经有regId[0,1,2,3,4,5,8]收到。
支持regId消息和alias消息，可通过msgId判断该消息是regId消息还是alias消息。
多个regId或者alias之间用逗号隔开。
一个json字符串，形如：{“code” : 0, “reason” : “succ”}。
code等于0表示成功，此时reason可以不填，否则表示失败，reason表示失败的具体原因。
如果的发送失败，推送服务器不会重试。
private Message buildMessage() throws Exception {
String PACKAGENAME = "com.xiaomi.mipushdemo";
String messagePayload = “This is a message”;
String title = “notification title”;
String description = “notification description”;
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.passThrough(0)
//消息使用通知栏方式
.notifyType(1)
.extra("callback", "/msgcallback")
2.2.7. 使用推送批次（JobKey）功能聚合消息
开发者在发送消息时可以设置消息的组ID（JobKey），带有相同的组ID的消息会被聚合为一个消息组。系统支持按照消息组展示消息详情以及计划推送／送达数量／送达曲线等统计信息。另外，相同JobKey的消息在客户端会进行去重，只展示其中的第一条。这样如果发送时同JobKey中不慎有重复的设备也不用担心用户会收到重复的通知。
设置消息的组ID 的方法是调用Message.Builder类的extra(String key, String
value)方法将key设置为”jobkey”，value设置为消息组的ID。合法的消息组ID由数字（[0-9]），大小写字母（[a-zA-Z]），下划线（_）和中划线（-）组成，长度不大于8个字符。
private Message buildMessage() throws Exception {
String PACKAGENAME = "com.xiaomi.mipushdemo";
String messagePayload = “This is a message with job key.”;
String title = “notification title”;
String description = “notification description”;
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.passThrough(0)
//消息使用通知栏方式
.notifyType(1)
.extra("jobkey", "")
2.2.8. 开启通知消息在状态栏滚动显示
调用Message.Builder类的extra(String key, String
value)方法将key设置为”ticker”，value设置为状态栏滚动显示的内容。
private Message buildMessage() throws Exception {
String PACKAGENAME = "com.xiaomi.mipushdemo";
String messagePayload = “This is a message with job key.”;
String title = “notification title”;
String description = “notification description”;
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.passThrough(0)
//消息使用通知栏方式
.notifyType(1)
.extra("ticker", "This is a ticker text.")
2.3. 服务器API地址以及参数
如果用户期望开发其它平台的ServerSDK，下面提供的API地址和参数也许会有帮助。
注：sandbox API只提供对IOS支持，不支持Android。
推送单条消息
向某个regid或一组regid列表推送某条消息
https://api./v2/message/regid
向某个alias或一组alias列表推送某条消息
https://api./v2/message/alias
向某个topic推送某条消息
https://api./v2/message/topic
向多个topic推送单条消息
https://api./v2/message/multi_topic
向所有设备推送某条消息
https://api./v2/message/all
向某个regid或一组regid列表推送某条消息
https://sandbox./v2/message/regid
向某个alias或一组alias列表推送某条消息
https://sandbox./v2/message/alias
向某个topic推送某条消息
https://sandbox./v2/message/topic
向多个topic推送单条消息
https://sandbox./v2/message/multi_topic
向所有设备推送某条消息
https://sandbox./v2/message/all
HTTP请求方法：POST
添加HEADER字段Authorization，用于身份验证。格式是 key=&APP_SECRET&。
APP_SECRET是从开发者网站申请得到。
注意：字符key必须小写
Authorization: key=YOUR_APP_SECRET
表 13. Android POST参数说明:
消息的内容。（注意：需要对payload字符串做urlencode处理）
restricted_package_name
App的包名。
pass_through
pass_through的值可以为：
0 表示通知栏消息
1 表示透传消息
通知栏展示的通知的标题。
description
通知栏展示的通知的描述。
notify_type
notify_type的值可以是DEFAULT_ALL或者以下其他几种的OR组合：
DEFAULT_ALL = -1;
DEFAULT_SOUND
// 使用默认提示音提示；
DEFAULT_VIBRATE = 2;
// 使用默认震动提示；
DEFAULT_LIGHTS = 4;
// 使用默认led灯光提示；
time_to_live
可选项。如果用户离线，设置消息在服务器保存的时间，单位：ms。服务器默认最长保留两周。
time_to_send
可选项。定时发送消息。用自日以来00:00:00.0 UTC时间表示（以毫秒为单位的时间）。
注：仅支持七天内的定时消息。
可选项。默认情况下，通知栏只显示一条推送消息。如果通知栏要显示多条推送消息，需要针对不同的消息设置不同的notify_id（相同notify_id的通知栏消息会覆盖之前的）。
extra.sound_uri
可选项，自定义通知栏消息铃声。extra.sound_uri的值设置为铃声的URI。参考2.2.1
注：铃声文件放在Android app的raw目录下。
extra.ticker
可选项，开启通知消息在状态栏滚动显示。
extra.notify_foreground
可选项，开启/关闭app在前台时的通知弹出。当extra.notify_foreground值为+时，app会弹出通知栏消息；当extra.notify_foreground值为+时，app不会弹出通知栏消息。注：默认情况下会弹出通知栏消息。参考2.2.2
extra.notify_effect
可选项，预定义通知栏消息的点击行为。通过设置extra.notify_effect的值以得到不同的预定义点击行为。
+：通知栏点击后打开app的Launcher Activity。
+：通知栏点击后打开app的任一Activity（开发者还需要传入extra.intent_uri）。
+：通知栏点击后打开网页（开发者还需要传入extra.web_uri）。
extra.intent_uri
可选项，打开当前app的任一组件。参考2.2.3.2
extra.web_uri
可选项，打开某一个网页。参考2.2.3.3
extra.flow_control
可选项，控制是否需要进行平缓发送（qps less 1000/second）。默认不支持。
0 表示不支持平缓发送
1 表示支持平缓发送
extra.layout_name
可选项，自定义通知栏样式，设置为客户端要展示的layout文件名。接口协议请参考2.2.4
extra.layout_value
可选项，自定义通知栏样式，必须与layout_name一同使用，指定layout中各控件展示的内容。接口协议请参考2.2.4。
extra.jobkey
可选项，使用推送批次（JobKey）功能聚合消息。客户端会按照jobkey去重，即相同jobkey的消息只展示第一条，其他的消息会被忽略。合法的jobkey由数字（[0-9]），大小写字母（[a-zA-Z]），下划线（_）和中划线（-）组成，长度不大于8个字符。
extra.callback
可选项，开启消息的送达回执。将extra.callback的值设置为第三方接收回执的http接口。
接口协议请参考2.2.5。
extra.locale
可选项，可以接收消息的设备的语言范围，用逗号分隔。
当前设备的local的获取方法：
Locale.getDefault().toString()
比如，中国大陆用zh_CN表示。
extra.locale_not_in
可选项，无法收到消息的设备的语言范围，逗号分隔。
extra.model
可选项，model支持三种用法。
可以收到消息的设备的机型范围，逗号分隔。
当前设备的model的获取方法：
Build.MODEL
比如，小米手机4移动版用”MI 4LTE”表示。
可以收到消息的设备的品牌范围，逗号分割。
比如，三星手机用”samsung”表示。 （目前覆盖42个主流品牌，对应关系见附录”品牌表”）
可以收到消息的设备的价格范围，逗号分隔。
比如，0-999价格的设备用&#″表示。 （目前覆盖4个价格区间，对应关系见附录”价格表”）
extra.model_not_in
可选项，无法收到消息的设备的机型范围，逗号分隔。
extra.app_version
可以接收消息的app版本号，用逗号分割。
安卓app版本号来源于manifest文件中的”android:versionName”的值。
注：目前支持MiPush_SDK_Client_2_2_12_sdk.jar（及以后）的版本。
extra.app_version_not_in
无法接收消息的app版本号，用逗号分割。
extra.connpt
可选项，指定在特定的网络环境下才能接收到消息。
目前仅支持指定”wifi”。
以上参数适用于所有推送消息的HTTP API。
registration_id
根据registration_id，发送消息到指定设备上。可以提供多个registration_id，发送给一组设备，不同的registration_id之间用“,”分割。
参数仅适用于“/message/regid”HTTP API。
根据alias，发送消息到指定的设备。可以提供多个alias，发送给一组设备，不同的alias之间用“,”分割。
参数仅适用于“/message/alias”HTTP API。
根据topic，发送消息给订阅了该topic的所有设备。
参数仅适用于“/message/topic”HTTP API。
topic列表，使用;$;分割。
注: topics参数需要和topic_op参数配合使用。
参数仅适用于“/message/multi_topic”HTTP API。
topic之间的操作关系。支持以下三种：
INTERSECTION
topics的列表元素是[A, B, C, D]，则并集结果是A∪B∪C∪D，具体用法可以参考”Demo 8″，交集的结果是A ∩B ∩C
∩D，差集的结果是A-B-C-D。
参数仅适用于“/message/multi_topic”HTTP API。
表 14. IOS POST参数说明:
description
通知栏展示的通知的描述。
time_to_live
可选项。如果用户离线，设置消息在服务器保存的时间，单位：ms。服务器默认最长保留两周。
time_to_send
可选项。定时发送消息。用自日以来00:00:00.0 UTC时间表示（以毫秒为单位的时间）。
注：仅支持七天内的定时消息。
extra.sound_url
可选项，自定义消息铃声。当值为空时为无声，default为系统默认声音。
extra.badge
可选项。通知角标。
extra.category
可选项。iOS8推送消息快速回复类别。
以上参数适用于所有推送消息的HTTP API。
registration_id
根据registration_id，发送消息到指定设备上。可以提供多个registration_id，发送给一组设备，不同的registration_id之间用“,”分割。
参数仅适用于“/message/regid”HTTP API。
根据alias，发送消息到指定的设备。可以提供多个alias，发送给一组设备，不同的alias之间用“,”分割。
参数仅适用于“/message/alias”HTTP API。
根据topic，发送消息给订阅了该topic的所有设备。注：不同提供多个topic。
参数仅适用于“/message/topic”HTTP API。
topic列表，使用;$;分割。
注: topics参数需要和topic_op参数配合使用。
参数仅适用于“/message/multi_topic”HTTP API。
topic之间的操作关系。支持以下三种：
INTERSECTION
topics的列表元素是[A, B, C, D]，则并集结果是A∪B∪C∪D，交集的结果是A ∩B ∩C
∩D，差集的结果是A-B-C-D。
参数仅适用于“/message/multi_topic”HTTP API。
参数附加说明：
服务器端还可以定义一些以”extra.”开头的POST参数，POST参数形式如：extra.key=value。注：至多可以设置10个key-value键值对。
利用v2/message/all可以向所有设备发送消息。参数跟向topic发送消息类似，不需要额外提供topic域。
参数规范与Message类和Sender类中的描述相同。alias，topic，registration_id三者不能同时出现，alias可以有多个，表示向这些alias指定的设备发送消息。
返回的是json格式的字符串，包括以下几个字段。
“result”: string，”ok” 表示成功, “error” 表示失败。
“description”: string， 对发送消息失败原因的解释。
“data”: string，本身就是一个json字符串（其中id字段的值就是消息的Id）。
“code”: integer，0表示成功，非0表示失败。
“info”: string，详细信息。
{"result":"ok","description":"成功","data":{"id":""},"code":0,"info":"Received push messages for 1 regid"}
{"result":"error","reason":"payload参数不能为空","description":"缺失必选参数","code":10016}
向”alias1”，“alias2”，“alias3” 三个别名指定的设备发送消息。
https://api./v2/message/alias
?alias=alias1，alias2，alias3
&description=notification description
&payload=this+is+xiaomi+push
&restricted_package_name=com.xiaomi.mipushdemo
&title=notification title
¬ify_type=2
&time_to_live=1000
&pass_through=0
&extra.sound_uri=android.resource://com.xiaomi.mipushdemo/raw/shaking
向registration_id为123指定的设备发送消息。
https://api./v2/message/regid
?description=notification description
&payload=this+is+xiaomi+push
&restricted_package_name=com.xiaomi.mipushdemo
®istration_id=123
&title=notification title
¬ify_type=2
&time_to_live=1000
¬ify_id=0
向订阅了my_topic的所有设备发送消息。
https://api./v2/message/topic
?description=notification description
&payload=this+is+xiaomi+push
&restricted_package_name=com.xiaomi.mipushdemo
&topic=my_topic
&title=notification title
¬ify_type=2
&time_to_live=1000
自定义点击行为：打开app的Launcher Activity
https://api./v2/message/alias
?alias=test_alias1
&description=notification description
&payload=this+is+xiaomi+push
&restricted_package_name=com.xiaomi.mipushdemo
&title=notification title
¬ify_type=2
&time_to_live=1000
&pass_through=0
&extra.notify_effect=1
自定义点击行为：打开app的任一组件
https://api./v2/message/alias
?alias=test_alias1
&description=notification description
&payload=this+is+xiaomi+push
&restricted_package_name=com.xiaomi.mipushdemo
&title=notification title
¬ify_type=2
&time_to_live=1000
&pass_through=0
&extra.notify_effect=2
&extra.intent_uri=intent:#Iaction=com.a.b.end
自定义点击行为：打开网页
https://api./v2/message/alias
?alias=test_alias1
&description=notification description
&restricted_package_name=com.xiaomi.mipushdemo
&title=notification title
¬ify_type=2
&time_to_live=1000
&pass_through=0
&extra.notify_effect=3
&extra.web_uri=
自定义通知栏样式：
https://api./v2/message/alias
?alias=test_alias1
&description=notification description
&restricted_package_name=com.xiaomi.mipushdemo
&title=notification title
¬ify_type=2
&time_to_live=1000
&pass_through=0
&extra.layout_name=custom_notify
&extra.layout_value={\"text\":{\"titleText\":\"我是标题\"},\"image\": {\"iconImage\": \"icon\"},\"time\": {\"timetext\": \"HH:mm\"}}
向订阅了[A,B,C,D]集合中任一标签的设备发送消息。
https://api./v2/message/multi_topic
?description=notification description
&payload=this+is+xiaomi+push
&restricted_package_name=com.xiaomi.mipushdemo
&topics=A;$;B;$;C;$;D
&topic_op=UNION
&title=notification title
¬ify_type=2
&time_to_live=1000
推送多条消息
针对不同的regid推送不同的消息
https://api./v2/multi_messages/regids
针对不同的alias推送不同的消息
https://api./v2/multi_messages/aliases
针对不同的regid推送不同的消息
https://sandbox./v2/multi_messages/regids
针对不同的alias推送不同的消息
https://sandbox./v2/multi_messages/aliases
HTTP请求方法：POST
添加HEADER字段Authorization，用于身份验证。格式是 key=&APP_SECRET&。
APP_SECRET是从开发者网站申请得到。
注意：字符key必须小写
Authorization: key=YOUR_APP_SECRET
表 15. Android POST参数说明:
发送的消息。messages是json格式的字符串。（注意：需要对messages字符串做urlencode处理）
对于extra.sound_uri、extra.notify_foreground、extra.notify_effect、extra.intent_uri、extra.web_uri等以extra为前缀的Post参数，需要将它们定义成一个json字符串，格式如下：
"extra":{"sound_uri":"XXX","notify_effect":"XX"....}
当使用https://sandbox./v2/multi_messages/regids时，格式满足：
{"target":"regid1","message":{"payload":"your content","restricted_package_name":
"your packagename","pass_through":XXX,"notify_type":XXX,"description":"XXX",
"title":"XXX","time_to_live":XXX,"notify_id":XXX，"extra":{"sound_uri":"XXX","notify_effect":"XX"....}}},
{"target":"regids2","message":{......}},
{"target":"regidsN","message":{......}}
当使用https://sandbox./v2/multi_messages/aliases时，格式满足：
{"target":"alias1","message":{"payload":"your content","restricted_package_name":
"your packagename","pass_through":XXX,"notify_type":XXX,"description":"XXX",
"title":"XXX","time_to_live":XXX,"notify_id":XXX，"extra":{"sound_uri":"XXX","notify_effect":"XX"....}}},
{"target":"alias2","message":{......}},
{"target":"aliasN","message":{......}}
time_to_send
可选项，定时发送批量消息。用自日以来00:00:00.0 UTC时间表示（以毫秒为单位的时间）。
定时发送批量消息，不需要针对每条消息设置time_to_send。
仅支持七天内的定时消息。
表 16. IOS POST参数说明
发送的消息。messages是json格式的字符串。（注意：需要对messages字符串做urlencode处理）
对于extra.sound_url、extra.badge、extra.category等以extra为前缀的Post参数，需要将它们定义成一个json字符串，格式如下：
"extra":{"sound_url":"XXX","badge":"XXX"....,"category":"XXX"}
当使用https://sandbox./v2/multi_messages/regids时，格式满足：
{"target":"regid1","message":{"description":"XXX","time_to_live":XXX，"extra":{"sound_url":"XXX","badge":"XXX","category":"XXX"....}}},
{"target":"regids2","message":{......}},
{"target":"regidsN","message":{......}}
当使用https://sandbox./v2/multi_messages/aliases时，格式满足：
{"target":"alias1","message":{"description":"XXX","time_to_live":XXX,"extra":{"sound_url":"XXX","badge":"XXX","category":"XXX"....}}},
{"target":"alias2","message":{......}},
{"target":"aliasN","message":{......}}
time_to_send
可选项，定时发送批量消息。用自日以来00:00:00.0 UTC时间表示（以毫秒为单位的时间）。
定时发送批量消息，不需要针对每条消息设置time_to_send。
仅支持七天内的定时消息。
返回的是json格式的字符串，包括以下几个字段。
“result”: string，”ok” 表示成功, “error” 表示失败。
“description”: string， 对发送消息失败原因的解释。
“data”: string，本身就是一个json字符串（其中id字段的值就是消息的Id）。
“code”: integer，0表示成功，非0表示失败。
“info”: string，详细信息。
注意：为了将json数据的格式看得比较清晰，我们没有做urlencode处理。但是，实际开发中必须对json数据做urlencode处理。
向不同的regid发送不同的消息
https://api./v2/multi_messages/regids
?messages=[{"target":"regid1","message":
{"payload":"send message to regid1","restricted_package_name":"com.xiaomi.mipushdemo","pass_through":1,
"notify_type":1,"description":"description1","title":"title1","time_to_live":100000，
"extra":{"sound_uri":"android.resource://com.xiaomi.mipushdemo/raw/shaking"}}},
{"target":"regid2","message":
{"payload":"send message to regid2","restricted_package_name":"com.xiaomi.mipushdemo","pass_through":1,
"notify_type":2,"description":"description2","title":"title2","time_to_live":20000}}]
向不同的alias发送不同的消息
https://api./v2/multi_messages/aliases
?messages=[{"target":"alias1","message":
{"payload":"send message to alias1","restricted_package_name":"com.xiaomi.mipushdemo","pass_through":1,
"notify_type":1,"description":"description1","title":"title1","time_to_live":100000}},
{"target":"alias2","message":
{"payload":"send message to alias2","restricted_package_name":"com.xiaomi.mipushdemo","pass_through":1,
"notify_type":2,"description":"description2","title":"title2","time_to_live":20000}}]
获取消息的统计数据
正式环境API地址：
https://api./v1/stats/message/counters
HTTP请求方法：GET
添加HEADER字段Authorization，用于身份验证。格式是 key=&APP_SECRET&。
APP_SECRET是从开发者网站申请得到。
注意：字符key必须小写
Authorization: key=YOUR_APP_SECRET
表 17. GET参数说明:
start_date
表示开始日期，必须符合yyyyMMdd的格式。
表示结束日期，必须符合yyyyMMdd的格式。开始日期和结束日期之间的跨度小于30天。
restricted_package_name
Android设备，传入App的包名。
IOS设备，传入App的Bundle Id。
返回的是json格式的字符串。
如果成功，则返回的字符串格式如下。
{“result”:”ok”,”description”:”成功”,”data”:{“data”:”[{"date":"yyyyMMdd","single_recipients":XXXX,"broadcast_recipients":XX,"received":XXXX,"click":XXXX}...{"date":"yyyyMMdd","single_recipients":XXXX,"broadcast_recipients":XX,"received":XXXX,"click":XXXX}]“},”code”:0}
其中，single_recipients表示的是单发（发送到指定的regid或者alias）消息量，broadcast_recipients表示的是群发（发送到指定的topic）消息量，received表示的是消息的接受量（包括单发消息和群发消息），click表示通知栏消息的点击量。
如果失败，则返回的字符串格式如下。
{“result”:”error”,”reason”:”XXXXXXXXX”,”description”:”XXXX”,”code”:XXXX}
https://api./v1/stats/message/counters
?start_date=
&end_date=
&restricted_package_name=com.xiaomi.mipushdemo
{"result":"ok","description":"成功","data":{"data":"[
{\"date\":\"\",\"single_recipients\":0,\"broadcast_recipients\":7689,\"received\":7026,\"click\":1703},
{\"date\":\"\",\"single_recipients\":0,\"broadcast_recipients\":5129,\"received\":4642,\"click\":1256}
]"},"code":0}
追踪消息状态
正式环境API地址：
追踪单条消息
https://api./v1/trace/message/status
追踪某个时间区域内的消息
https://api./v1/trace/messages/status
HTTP请求方法：GET
添加HEADER字段Authorization，用于身份验证。格式是 key=&APP_SECRET&。
APP_SECRET是从开发者网站申请得到。
注意：字符key必须小写
Authorization: key=YOUR_APP_SECRET
表 18. 追踪单条消息的GET参数说明:
表示消息的Id。
返回的是json格式的字符串。
{"result":"ok","description":"成功","data":{"data":"
{\"id\":\"s7636237jB\",\"delivery_rate\":\"100%\",\"delivered\":1,\"resolved\":1,
\"msg_type\":\"BatchRegId\",\"create_time\":\" 21:07:16\",\"time_to_live\":\"1209600s\",
\"click\":0,\"click_rate\":\"0%\"}"},"code":0}
表示单条消息的id，delivered表示消息的送达数，resolved表示消息的计划送达数，delivery_rate表示送达率，click表示消息的点击数，click_rate表示消息的点击率，create_time表示消息的发送时间，time_to_live表示消息的有效期，msg_type表示该消息发送的方式(msg_type分为Common、BatchRegId、Alias、BatchAlias、Topic)。
表 19. 追踪某个时间区域内消息的GET参数说明:
begin_time
表示开始时间戳，单位ms。
表示结束时间戳，单位ms。
返回的是json格式的字符串。
{"result":"ok","description":"成功","data":{"data":"[
{\"id\":\"a0283940fp\",\"delivery_rate\":\"100%\",\"delivered\":2,\"resolved\":2,
\"msg_type\":\"BatchAlias\",\"create_time\":\" 16:44:43\",\"time_to_live\":\"109s\",
\"create_timestamp\":1,\"click\":0,\"click_rate\":\"0%\"},
{\"id\":\"s0247716NA\",\"delivery_rate\":\"100%\",\"delivered\":2,\"resolved\":2,
\"msg_type\":\"BatchRegId\",\"create_time\":\" 16:44:07\",\"time_to_live\":\"109s\",
\"create_timestamp\":7,\"click\":0,\"click_rate\":\"0%\"},
{\"id\":\"a0207789dJ\",\"delivery_rate\":\"0%\",\"delivered\":0,\"resolved\":1,
\"msg_type\":\"Alias\",\"create_time\":\" 16:43:27\",\"time_to_live\":\"1209600s\",
\"create_timestamp\":9,\"click\":0,\"click_rate\":\"0%\"},
{\"id\":\"t0155849Ek\",\"delivery_rate\":\"100%\",\"delivered\":2,\"resolved\":2,
\"msg_type\":\"Topic\",\"create_time\":\" 16:42:35\",\"time_to_live\":\"109s\",
\"create_timestamp\":9,\"click\":0,\"click_rate\":\"0%\"},
{\"id\":\"si\",\"delivery_rate\":\"0%\",\"delivered\":0,\"resolved\":1,
\"msg_type\":\"Common\",\"create_time\":\" 16:42:11\",\"time_to_live\":\"1209600s\",
\"create_timestamp\":2,\"click\":0,\"click_rate\":\"0%\"}]"},"code":0}
订阅/取消订阅标签
订阅RegId的标签
https://api./v2/topic/subscribe
取消订阅RegId的标签
https://api./v2/topic/unsubscribe
订阅alias的标签
https://api./v2/topic/subscribe/alias
取消订阅alias的标签
https://api./v2/topic/unsubscribe/alias
订阅RegId的标签
https://sandbox./v2/topic/subscribe
取消订阅RegId的标签
https://sandbox./v2/topic/unsubscribe
订阅alias的标签
https://sandbox./v2/topic/subscribe/alias
取消订阅alias的标签
https://sandbox./v2/topic/unsubscribe/alias
HTTP请求方法：POST
添加HEADER字段Authorization，用于身份验证。格式是 key=&APP_SECRET&。
APP_SECRET是从开发者网站申请得到。
注意：字符key必须小写
Authorization: key=YOUR_APP_SECRET
针对/v2/topic/subscribe和/v2/topic/unsubscribe的参数说明：
表 20. 订阅/取消订阅RegId的标签的GET参数说明:
registration_id
设备regid列表，逗号分隔，必填。
标签，必填。
https://api./v2/topic/subscribe
?registration_id=abc
针对/v2/topic/subscribe/alias和/v2/topic/unsubscribe/alias的参数说明：
表 21. 订阅/取消订阅alias的标签的GET参数说明:
各个alias之间用逗号分割，最多不能超过1000个alias。
标签，必填。
https://api./v2/topic/subscribe/alias
?aliases=a1
获取失效的regId列表
正式环境API地址：
https://feedback./v1/feedback/fetch_invalid_regids
HTTP请求方法：GET
添加HEADER字段Authorization，用于身份验证。格式是 key=&APP_SECRET&。
APP_SECRET是从开发者网站申请得到。
注：字符key必须小写。另外，目前仅支持安卓设备。
Authorization: key=YOUR_APP_SECRET
该HTTP请求的几点说明：
获取失效的regId列表不需要传递任何HTTP参数。
获取失效的regId列表，每次请求最多返回1000个regId。
每次请求之后，成功返回的失效的regId将会从MiPush数据库删除。
返回的是json格式的字符串，分为以下三种情况。
存在失效的regid
{“result”:”ok”,”description”:”成功”,”data”:{“list”:["regid1","regid2","regid3"]},”code”:0}
不存在失效的regid
{“result”:”ok”,”description”:”成功”,”data”:{“list”:[]},”code”:0}
请求存在异常
{“result”:”error”,”reason”:”Invalid application
secret.”,”description”:”认证失败”,”code&#}
检测/删除定时任务
正式环境API地址：
检测定时任务是否存在
https://api./v2/schedule_job/exist
删除定时任务
https://api./v2/schedule_job/delete
HTTP请求方法：GET
添加HEADER字段Authorization，用于身份验证。格式是 key=&APP_SECRET&。
APP_SECRET是从开发者网站申请得到。
注：字符key必须小写。另外，目前仅支持安卓设备。
Authorization: key=YOUR_APP_SECRET
表 22. 参数列表
表示消息的Id。
返回的是json格式的字符串。
code是0,表示成功；否则表示失败，reason表示失败的原因。
表 23. 品牌表
中兴努比亚
china mobile
kubimofang
xiaolajiao
表 24. 价格表
This entry was posted in}
我手机VIVO S6T 下载游戏内存满了 可扩展内存没东西 我想把游戏下载到扩展内存上怎么做啊
提问者采纳
你把手机内存的移到sd卡里就可以了，点我的手机。也可以在电脑上下个360手机助手，应用程序-里面就会出现很多软件，点我的应用，在左上有个移植sd卡点设置，点管理应用
提问者评价
其他类似问题
///zhidao/pic//c/guanjia" title="/zhidao/wh%3D600%2C800/sign=ce0aaad6eddc451da68bed4f1b4fd;更多问题去电脑管家企业平台提问吧啊.hiphotos！ ，然后下载游戏的话.baidu你好，你可以试试使用电脑管家来将游戏安装到SD卡的.jpg" target="_blank" title="点击查看大图" class="ikqb_img_alink"><img class="ikqb_img" src="http
已回答238928
响应时间&3小时
扩展内存的相关知识
按默认排序
其他1条回答
你下载一个QQ安全那个玩意，他有一个功能是把下载的东西转移到卡上的很好用的哦，再有就是下载完事东西 把机器开关机一下 让它从新收索一下
您可能关注的推广
等待您来回答
下载知道APP
随时随地咨询
出门在外也不愁vivos6的手机怎样直接把软件和游戏下载到SD卡_百度知道
vivos6的手机怎样直接把软件和游戏下载到SD卡
为什么在91下载一个游戏还会显示没有内存在通用中的SD卡和手机储存中显示SD卡还有3G多的容量？要怎样直接把游戏软件下载到SD卡，然后我在通用中的首选安装位置里设置的是SD卡优先，手机储存只有不到200MB
提问者采纳
包含小挂件的程序，影响软件运行。3。2您好、手机、软件商店的程序;进入：默认，当手机内存小于45M默认安装到SD卡，可自行选择安装的位置，通过手机文件管理安装、其它地方下载的程序，小的系统程序可以安装到手机内存中：1、待机类程序,移动到SD卡;已安装的程序"、SD卡：当手机内存大于45M按默认安装到手机、输入法类程序默认安装到手机内存且安装后不能移到SD卡。程序在安装的规则如下，有三个选项，为减少因软件占用太多手机内存，建议大型游戏或程序安装到TF卡中。安装后可以进入设置-通用-应用程序-已安装中点击"
提问者评价
已回答225008
响应时间&9小时
其他类似问题
sd卡的相关知识
按默认排序
其他1条回答
只要在百信手机下载中心就可以下载了。
您可能关注的推广
等待您来回答
下载知道APP
随时随地咨询
出门在外也不愁帖子很冷清，卤煮很失落！求安慰
驰为V99X最新固件下载（SDK 2.0）
2374浏览 / 11回复
沙发支持哦
楼主怎么没有附件啊？？
楼主忽悠人
怎么什么都没有呀
有没有啊，等待着
怎么什么都没有！！
：驰为V99X最新固件下载……
您需要登录后才可以回帖&&&|&&&&&
用户名/注册邮箱/注册手机号
其他第三方号登录手机游戏下载排行_安卓游戏下载网 - vivo手机软件
手机游戏下载排行_安卓游戏下载网 - vivo手机软件
手机游戏下载排行_安卓游戏下载网 - vivo手机软件
手机客户端 方案
杭州结婚网小米推送服务Server端SDK (MiPushServiceSDK for server) | 小米应用开发者文档
升级新版本v2.1
升级新版本v2.2
增加一些扩展功能，如自定义消息铃声、开启/关闭app在前台时的通知弹出、预定义通知栏通知的点击行为。
2014-07 增加对IOS的支持
在集成过程中遇到任何问题，请联系我们：。您也可以添加QQ群： ，群中会有工程师解答您的问题。
1. 如何接入ServerSDK
开发者需要登录开发者网站，申请AppID, AppKey,
AppSecret。
从开发者网站下载SDK，将MiPush_SDK_Sever目录下的jar文件加入到自己的服务端项目中。Jar文件包括MiPush_SDK_Sever_1_2.jar文件和json-simple-1.1.1.jar。
在开发者网站上，下载并解压MiPush_SDK_V1.2.zip；
将ServerSDK文件夹下的MiPush_SDK_Sever_1_2.jar文件和json-simple-1.1.1.jar文件放入项目工程的libs目录；
刷新工程，确保文件出现在libs目录下。如果没有的话请手动添加；
选择环境。
在正式环境下使用push服务，启动时需要调用如下代码：
Constants.useOfficial();
在测试环境下使用push服务，启动时需要调用如下代码：
Constants.useSandbox();
在测试环境中使用push服务不会影响线上用户。
注：测试环境只提供对IOS支持，不支持Android。
2. 服务端SDK说明
2.1. 服务端SDK类的介绍
表 1. Server SDK类的简介
构建要发送的消息内容。
构建发送给Android设备的Message对象。
IOSBuilder
构建发送给IOS设备的Message对象。
TargetedMessage
构建要发送的消息内容和消息的发送目标。
MiPush消息发送类。
Sender发送消息后，服务器返回的结果。
获取发送的消息统计数据。
追踪消息状态。
Subscription
订阅/取消订阅标签。
获取反馈信息，比如失效的regId列表。注：目前仅支持安卓设备。
常量定义。
Sender发送消息后，返回的错误类型。
2.1.1. Message
Message是MiPush推送服务系统中的消息，开发者可以用它构建要发送的消息体。注:
Message的实例是不可变对象(immutable)，由Builder或IOSBuilder来构建。
java.lang.Object
?com.xiaomi.xmpush.server.Message
2.1.2. Builder
构建发送给Android设备的Message对象。
java.lang.Object
?com.xiaomi.xmpush.server.Message.Builder
表 2. Message.Builder类的方法列表
建立Builder对象，用来构造消息。
payload(String payload)
设置要发送的消息内容payload，不允许全是空白字符，长度小于4K，中英文均以一个计算。
title(String title)
设置在通知栏展示的通知的标题，不允许全是空白字符，长度小于16，中英文均以一个计算。
description(String description)
设置在通知栏展示的通知的描述，不允许全是空白字符，长度小于128，中英文均以一个计算。
passThrough(int passThrough)
设置消息是否通过透传的方式送给app，1表示透传消息，0表示通知栏消息。
notifyType(Integer type)
设置通知类型，type的值可以是DEFAULT_ALL或者以下其他几种的OR组合：
DEFAULT_ALL = -1;
DEFAULT_SOUND
// 使用默认提示音提示
DEFAULT_VIBRATE = 2;
// 使用默认震动提示
DEFAULT_LIGHTS = 4;
// 使用默认led灯光提示
restrictedPackageName(String packageName)
设置app的包名packageName。packageName必须和开发者网站上申请的结果一致。
timeToLive(int milliseconds)
可选项。如果用户离线，设置消息在服务器保存的时间，单位：ms。服务器默认最长保留两周。
timeToSend(long timeToSend)
可选项。定时发送消息。timeToSend是用自日以来00:00:00.0
UTC时间表示（以毫秒为单位的时间）。注：仅支持七天内的定时消息。
notifyId(Integer id)
可选项。默认情况下，通知栏只显示一条推送消息。如果通知栏要显示多条推送消息，需要针对不同的消息设置不同的notify_id（相同notify_id的通知栏消息会覆盖之前的）。
enableFlowControl(boolean needFlowControl)
可选项。控制消息是否需要进行平缓发送（qps less 1000/second）。默认不支持。
extra(String key, String value)
可选项，对app提供一些扩展的功能，请参考2.2。除了这些扩展功能，开发者还可以定义一些key和value来控制客户端的行为。注：key和value的字符数不能超过1024，至多可以设置10个key-value键值对。
根据前面的属性，生成message对象。
private Message buildMessage() throws Exception {
String PACKAGENAME = "com.xiaomi.mipushdemo";
String messagePayload = “This is a message”;
String title = “notification title”;
String description = “notification description”;
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.passThrough(1)
//消息使用透传方式
.notifyType(1)
// 使用默认提示音提示
2.1.3. IOSBuilder
构建发送给IOS设备的Message对象。
java.lang.Object
?com.xiaomi.xmpush.server.Message.IOSBuilder
表 3. Message.IOSBuilder类的方法列表
IOSBuilder()
建立IOSBuilder对象，用来构造消息。APNs消息体为256个字符。
description(String description)
设置在通知栏展示的通知的描述。
timeToLive(int milliseconds)
可选项。如果用户离线，设置消息在服务器保存的时间，单位：ms。服务器默认最长保留两周。
timeToSend(long timeToSend)
可选项。定时发送消息。timeToSend是用自日以来00:00:00.0
UTC时间表示（以毫秒为单位的时间）。注：仅支持七天内的定时消息。
soundURL(String url)
可选项，自定义消息铃声。
badge(int badge)
可选项，自定义通知数字角标。
category(String category)
可选项，iOS8推送消息快速回复类别。
extra(String key, String value)
可选项，自定义键值对。控制客户端的行为。注：至多可以设置10个key-value键值对。
根据前面的属性，生成message对象。
private Message buildMessage() throws Exception {
String description = “notification description”;
Message message = new Message.IOSBuilder()
.description(description)
.soundURL(“default”)
// 消息铃声
// 数字角标
.category("action")
// 快速回复类别
.extra("key", "value")
// 自定义键值对
2.1.4. TargetedMessage
TargetedMessage封装了MiPush推送服务系统中的消息Message对象，和该Message对象所要发送到的目标。
java.lang.Object
?com.xiaomi.xmpush.server.TargetedMessage
表 4. TargetedMessage方法列表
TargetedMessage()
构造函数。
setTarget(int targetType, String target)
设置消息的发送目标。
targetType表示目标类型，目前支持TargetedMessage.TARGET_TYPE_REGID和TargetedMessage.TARGET_TYPE_ALIAS两种类型。当targetType是TARGET_TYPE_REGID时，target需要设置为regid；当targetType是TARGET_TYPE_ALIAS时，target需要设置为alias。
setMessage(Message message)
设置消息。
注意：下面函数返回的List中所有 TargetedMessage对象的targetType必须相同：全是
TargetedMessage.TARGET_TYPE_REGID，或者全是TargetedMessage.TARGET_TYPE_ALIAS。
private List&TargetedMessage& buildMessages() throws Exception {
List&TargetedMessage& messages = new ArrayList&TargetdMessage&();
TargetedMessage message1 = new TargetedMessage();
message1.setTarget(TargetedMessage.TARGET_TYPE_ALIAS, “alias1”);
message1.setMessage(buildMessage());
messages.add(message1);
TargetedMessage message2 = new TargetedMessage();
message2.setTarget(TargetedMessage.TARGET_TYPE_ALIAS, “alias2”);
message2.setMessage(buildMessage());
messages.add(message2);
2.1.5. Sender
MiPush消息发送类。
java.lang.Object
?com.xiaomi.xmpush.server.Sender
表 5. Sender方法列表
Sender(String appSecret)
构造Sender对象。appSecret是在开发者网站上注册时生成的, 可在应用详情下查看。
send(Message message, String registrationId,int retries)
根据registrationId，发送消息到指定设备上，retries为发送失败之后重试的次数。
send(Message message, List&String& regIds, int retries)
根据regIds，发送消息到指定的一组设备上，retries为发送失败之后重试的次数。
send(List&TargetedMessage&messages, int retries)
发送一组消息。其中TargetedMessage类中封装了Message对象和该Message所要发送的目标。注意：messages内所有TargetedMessage对象的targetType必须相同，
不支持在一个调用中同时给regid和alias发送消息。
send(List&TargetedMessage& messages, int retries, long
timeToSend)
定时发送一组消息。timeToSend是用自日以来00:00:00.0 UTC时间表示（以毫秒为单位的时间）。
注：仅支持七天内的定时消息。
sendToAlias(Message message, String alias, int retries)
根据alias，发送消息到指定设备上，retries为发送失败之后重试的次数。alias不允许全是空白字符，不能包含逗号，长度小于128，中英文均以一个计算。
sendToAlias(Message message, List&String& aliasList, int
根据aliasList，发送消息到指定的一组设备上，retries为发送失败之后重试的次数。aliasList中的每个元素不允许全是空白字符，不能包含逗号，长度小于128，中英文均以一个计算；元素的个数不得超过1000个。
broadcast(Message message, String topic, int retries)
根据topic，发送消息到指定一组设备上，retries为发送失败之后重试的次数。topic不允许全是空白字符，长度小于128，中英文均以一个计算。
broadcastAll(Message message, int retries)
向所有设备发送消息，retries为发送失败之后重试的次数。
multiTopicBroadcast(Message message, List&String& topics,
BROADCAST_TOPIC_OP topicOp, int retries)
向多个topic广播消息，支持topic间的交集、并集或差集（如果只有一个topic请用单topic版本）。
其中，BROADCAST_TOPIC_OP是一个枚举类型，指定了发送广播消息时多个topic之间的运算关系。
public enum BROADCAST_TOPIC_OP {
INTERSECTION, // 交集
例如：topics的列表元素是[A, B, C, D]，则并集结果是A∪B∪C∪D，交集的结果是A ∩B ∩C
∩D，差集的结果是A-B-C-D
注：发送广播消息时topic的数量不能超过5。
checkScheduleJobExist(String msgId)
检测定时消息的任务是否存在。
deleteScheduleJob(String msgId)
删除指定的定时消息。
private void sendMessage() throws Exception {
Constants.useOfficial();
Sender sender = new Sender(APP_SECRET_KEY);
String messagePayload= “This is a message”;
String title = “notification title”;
String description = “notification description”;
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.notifyType(1)
// 使用默认提示音提示
sender.send(message, regId, 0); //根据regID，发送消息到指定设备上，不重试。
private void sendMessages() throws Exception {
Constants.useOfficial();
Sender sender = new Sender(APP_SECRET_KEY);
List&TargetedMessage& messages = new ArrayList&TargetdMessage&();
TargetedMessage targetedMessage1 = new TargetedMessage();
targetedMessage1.setTarget(TargetedMessage.TARGET_TYPE_ALIAS, “alias1”);
String messagePayload1= “This is a message1”;
String title1 = “notification title1”;
String description1 = “notification description1”;
Message message1 = new Message.Builder()
.title(title1)
.description(description1).payload(messagePayload1)
.restrictedPackageName(MY_PACKAGE_NAME)
.notifyType(1)
// 使用默认提示音提示
targetedMessage1.setMessage(message1);
messages.add(targetedMessage1);
TargetedMessage targetedMessage2 = new TargetedMessage();
targetedMessage1.setTarget(TargetedMessage.TARGET_TYPE_ALIAS, “alias2”);
String messagePayload2= “This is a message2”;
String title2 = “notification title2”;
String description2 = “notification description2”;
Message message2 = new Message.Builder()
.title(title2)
.description(description2).payload(messagePayload2)
.restrictedPackageName(MY_PACKAGE_NAME)
.notifyType(1)
// 使用默认提示音提示
targetedMessage2.setMessage(message2);
messages.add(targetedMessage2);
sender.send(messages, 0); //根据alias，发送消息到指定设备上，不重试。
private void sendMessageToAlias() throws Exception {
Constants.useOfficial();
Sender sender = new Sender(APP_SECRET_KEY);
String messagePayload = “This is a message”;
String title = “notification title”;
String description = “notification description”;
String alias = “testAlias”;
//alias非空白，不能包含逗号，长度小于128。
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.notifyType(1)
// 使用默认提示音提示
sender.sendToAlias(message, alias, 0); //根据alias，发送消息到指定设备上，不重试。
private void sendMessageToAliases() throws Exception {
Constants.useOfficial();
Sender sender = new Sender(APP_SECRET_KEY);
String messagePayload = “This is a message”;
String title = “notification title”;
String description = “notification description”;
List&String& aliasList = new ArrayList&String&();
aliasList.add(“testAlias1”);
//alias非空白，不能包含逗号，长度小于128。
aliasList.add(“testAlias2”);
//alias非空白，不能包含逗号，长度小于128。
aliasList.add(“testAlias3”);
//alias非空白，不能包含逗号，长度小于128。
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.notifyType(1)
// 使用默认提示音提示
sender.sendToAlias(message, aliasList, 0); //根据aliasList，发送消息到指定设备上，不重试。
private void sendBroadcast() throws Exception {
Constants.useOfficial();
Sender sender = new Sender(APP_SECRET_KEY);
String messagePayload = “This is a message”;
String title = “notification title”;
String description = “notification description”;
String topic = “testTopic”;
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.notifyType(1)
// 使用默认提示音提示
sender.broadcast(message, topic, 0); //根据topic，发送消息到指定一组设备上，不重试。
2.1.6. Result
Sender发送消息给服务器之后，服务器返回的结果
java.lang.Object
?com.xiaomi.xmpush.server.Result
表 6. Result方法列表
String getMessageId()
如果消息发送成功，服务器返回消息的ID；如果发送失败，返回null。
ErrorCode getErrorCode()
发送消息返回的错误码，如果返回ErrorCode.Success表示发送成功，其他表示发送失败。
String getReason()
如果消息发送失败，服务器返回错误原因的文字描述；如果发送成功，返回null。
Result对于sendToAlias()，broadcast()和send()使用方式完全一样。
private void sendMessage() throws Exception {
Constants.useOfficial();
Sender sender = new Sender(APP_SECRET_KEY);
String messagePayload = “This is a message”;
String title = “notification title”;
String description = “notification description”;
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.notifyType(1)
// 使用默认提示音提示
Result result = sender.send(message, regId, 0); //Result对于sendToAlias()，broadcast()和send()调用方式完全一样
Log.v("Server response: ", "MessageId: " + result.getMessageId()
+ " ErrorCode: " + result.getErrorCode().toString()
+ " Reason: " + result.getReason());
2.1.7. Stats
获取发送的消息统计数据。
com.xiaomi.xmpush.server.HttpBase
?com.xiaomi.xmpush.server.Stats
表 7. Stats方法列表
Stats(String appSecret)
构造Stats对象。appSecret是在开发者网站上注册时生成的, 可在应用详情下查看。
String getStats(String startDate, String endDate, String
restrictedPackageName, int retries)
获取指定日期范围内的日统计数据（如果日期范围包含今日，则今日数据为从今天00：00开始到现在的累计量)。
开始日期和结束日期必须符合yyyyMMdd的格式，并且时间跨度小于30天。
start_date表示开始日期，如
end_date表示结束日期 ，如
restrictedPackageName。
Android设备，传入App的包名
IOS设备，传入App的Bundle Id
retries表示重试的次数
返回值说明
返回的是json格式的字符串。
如果成功，则返回的字符串格式如下。
{“result”:”ok”,”reason”:”成功”,”description”:”成功”,”data”:{“data”:”[{"date":"yyyyMMdd","single_recipients":XXXX,"broadcast_recipients":XX,"received":XXXX,"click":XXXX}...{"date":"yyyyMMdd","single_recipients":XXXX,"broadcast_recipients":XX,"received":XXXX,"click":XXXX}]“},”code”:0}
其中，single_recipients表示的是单发（发送到指定的regid或者alias）消息量，broadcast_recipients表示的是群发（发送到指定的topic）消息量，received表示的是消息的接受量（包括单发消息和群发消息），click表示通知栏消息的点击量。
如果失败，则返回的字符串格式如下。
{“result”:”error”,”reason”:”XXXXXXXXX”,”description”:”XXXX”,”code”:XXXX}
private void getStatsData() throws Exception {
Constants.useOfficial();
Stats stats = new Stats(APP_SECRET_KEY);
String result = stats.getStats("", "", PACKAGE_NAME, 0);
2.1.8. Tracer
追踪消息状态。
com.xiaomi.xmpush.server.HttpBase
?com.xiaomi.xmpush.server.Tracer
表 8. Tracer方法列表
Tracer(String appSecret)
构造Tracer对象。appSecret是在开发者网站上注册时生成的, 可在应用详情下查看。
String getMessageStatus(String msgId, int retries)
获取指定ID的消息状态。
String getMessageStatus(long beginTime, long endTime, int retries)
获取某个时间间隔内所有消息的状态。
beginTime表示开始时间戳，单位ms。
endTime表示结束时间戳，单位ms。
retries表示重试的次数。
返回值说明
如果成功，则返回的字符串格式如下。
{“result”:”ok”,”reason”:”成功”,”description”:”成功”,”data”:[{"data":"
{"id\":XXXX,"delivery_rate":XXXX,"delivered":XXXX,"resolved":XXXX,"msg_type":XXXX,
"create_time":XXXX,"time_to_live":XXXX,"click":XXXX,"click_rate":XXXX},....]“},”code”:0}
表示单条消息的id，delivered表示消息的送达数，resolved表示消息的计划送达数，delivery_rate表示送达率，click表示消息的点击数，click_rate表示消息的点击率，create_time表示消息的发送时间，time_to_live表示消息的有效期，msg_type表示该消息发送的方式(msg_type分为Common、BatchRegId、Alias、BatchAlias、Topic)。
如果失败，则返回的字符串格式如下。
{“result”:”error”,”reason”:”XXXXXXXXX”,”description”:”XXXX”,”code”:XXXX}
如果该时间区间内的消息数大于100条，则返回最接近结束时间的100条。
开始时间和结束时间之间的跨度不能大于7天。
public void getTrace() throws Exception {
Tracer tracer = new Tracer(APP_SECRET_KEY); // 使用AppSecretKey创建一个Tracer对象
// 获取单条消息的送达状态， 参数： msgId, retry次数
String messageStatus = tracer.getMessageStatus("s7636237jB", 0);
System.out.println(messageStatus);
// 获取一个时间区间内的消息的送达状态， 参数：开始时间， 结束时间， retry次数
String messageStatus2 = tracer.getMessageStatus(System.currentTimeMillis() - 1000, System.currentTimeMillis(), 0);
System.out.println(messageStatus2);
2.1.9. Subscription
订阅/取消订阅标签。
com.xiaomi.xmpush.server.HttpBase
?com.xiaomi.xmpush.server.Subscription
表 9. Subscription方法列表
Subscription(String appSecret)
构造Subscription对象。appSecret是在开发者网站上注册时生成的, 可在应用详情下查看。
subscribeTopic(List&String& regIds, String topic, String category, int
给一组regid列表订阅标签。其中，retries表示重试的次数，catergory可以使用null。
subscribeTopic(String regId, String topic, String category, int
给某个regid订阅标签。
unsubscribeTopic(List&String& regIds, String topic, String category, int
取消一组regid列表的标签。
unsubscribeTopic(String regId, String topic, String category, int
取消某个regid的标签。
subscribeTopicByAlias（String topic, List&String& aliases, String
category, int retries）
给一组alias列表订阅标签。
unsubscribeTopicByAlias（String topic, List&String& aliases, String
category, int retries）
取消一组alias列表的标签。
2.1.10. Feedback
获取反馈信息。
注：目前仅支持安卓设备。
com.xiaomi.xmpush.server.HttpBase
?com.xiaomi.xmpush.server.Subscription
表 10. Feedback方法列表
Feedback(String appSecret)
构造Feedback对象。appSecret是在开发者网站上注册时生成的, 可在应用详情下查看。
getInvalidRegIds(int retries)
获取失效的regId列表。
该API两点说明：
获取失效的regId列表，每次请求最多返回1000个regId。
每次请求之后，成功返回的失效的regId将会从MiPush数据库删除。
返回的是json格式的字符串，分为以下三种情况。
存在失效的regid
{“result”:”ok”,”description”:”成功”,”data”:{“list”:["regid1","regid2","regid3"]},”code”:0}
不存在失效的regid
{“result”:”ok”,”description”:”成功”,”data”:{“list”:[]},”code”:0}
请求存在异常
{“result”:”error”,”reason”:”Invalid application
secret.”,”description”:”认证失败”,”code&#}
2.1.11. Constants
系统常量定义
java.lang.Object
?com.xiaomi.xmpush.server.Constants
如果需要在测试环境(Sandbox)和正式环境切换,
可以调用Constants.useSandbox()切换到开发环境上，使用测试环境(Sandbox)不会影响到线上的在线用户；开发完成后，再切换到正式环境。
注：测试环境只提供对IOS支持，不支持Android。
Constants.useOfficial(); //使用正式环境
Constants.useSandbox(); //使用开发环境
2.1.12. ErrorCode
java.lang.Object
com.xiaomi.push.sdk.ErrorCode
该类是服务器返回的错误码类
2.2. 针对Android设备提供的扩展功能
在利用Message.Builder构造Message对象时，通过调用extra(String key, String
value)方法设置key和value，可以自定义app的扩展功能。
2.2.1. 自定义消息铃声
调用Message.Builder类的extra(String key, String
value)方法将key设置为Constants.EXTRA_PARAM_SOUND_URI，value设置为铃声的URI。
铃声只能使用当前app内的资源，URI格式满足 android.resource://your packagename/XXX/XXX。
铃声文件放在Android app的raw目录下。
只适用于通知栏消息。
private Message buildMessage() throws Exception {
String PACKAGENAME = "com.xiaomi.mipushdemo";
String messagePayload = “This is a message”;
String title = “notification title”;
String description = “notification description”;
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.passThrough(0)
//消息使用通知栏方式
.notifyType(1)
.extra(Constants.EXTRA_PARAM_SOUND_URI, "android.resource://" + PACKAGENAME + "/raw/shaking")
2.2.2. 开启/关闭app在前台时的通知弹出
当app在前台时，默认情况下服务端向客户端发送通知栏消息，app会弹出通知；如果开发者不想让客户端弹出通知，需要调用Message.Builder类的extra(String
key, String value)方法将key设置为Constants.EXTRA_PARAM_NOTIFY_FOREGROUND，value设置为+。
注：只适用于通知栏消息。
private Message buildMessage() throws Exception {
String PACKAGENAME = "com.xiaomi.mipushdemo";
String messagePayload = “This is a message”;
String title = “notification title”;
String description = “notification description”;
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.passThrough(0)
//消息使用通知栏方式
.notifyType(1)
.extra(Constants.EXTRA_PARAM_NOTIFY_FOREGROUND, "0")
2.2.3. 预定义通知栏通知的点击行为
目前支持三种预定义点击行为。
通过调用Message.Builder类的extra(String key, String value)方法，将key设置为Constants.EXTRA_PARAM_NOTIFY_EFFECT，value设置为Constants.NOTIFY_LAUNCHER_ACTIVITY、Constants.NOTIFY_ACTIVITY或Constants.NOTIFY_WEB以得到不同的预定义行为。
Constants.NOTIFY_LAUNCHER_ACTIVITY：打开当前app对应的Launcher Activity。
Constants.ACTIVITY：打开当前app内的任意一个Activity。
Constants.NOTIFY_WEB：打开网页。
app打开相应的Activity后，可以调用Intent的getSerializableExtra（PushMessageHelper.KEY_MESSAGE）方法得到MiPushMessage对象。
客户端参考代码如下：
MiPushMessage message = (MiPushMessage) intent.getSerializableExtra（PushMessageHelper.KEY_MESSAGE）;
注：用户点击预定义通知栏消息后，小米推送安卓客户端SDK会利用Intent将消息传到相应的Activity而不是通过调用onReceiveMessage(Context
context, MiPushMessage message)方法传过去。
2.2.3.1. 打开当前app对应的Launcher Activity
调用Message.Builder类的extra(String key, String
value)方法将key设置为Constants.EXTRA_PARAM_NOTIFY_EFFECT，value设置为Constants.NOTIFY_LAUNCHER_ACTIVITY。
private Message buildMessage() throws Exception {
String PACKAGENAME = "com.xiaomi.mipushdemo";
String messagePayload = “This is a message”;
String title = “notification title”;
String description = “notification description”;
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.passThrough(0)
//消息使用通知栏方式
.notifyType(1)
.extra(Constants.EXTRA_PARAM_NOTIFY_EFFECT, Constants.NOTIFY_LAUNCHER_ACTIVITY)
2.2.3.2. 打开当前app内的任意一个Activity
调用Message.Builder类的extra(String key, String
value)方法将key设置为Constants.EXTRA_PARAM_NOTIFY_EFFECT，value设置为Constants.NOTIFY_ACTIVITY；再次调用extra(String
key, String value)方法，将key设置为Constants.EXTRA_PARAM_INTENT_URI，value设置为要启动Activity的intent
获取Intent URI的具体步骤是：
在安卓客户端的工程的AndroidManifest.xml里定义一个Activity。例如下面是一个展示新闻的Activity：
&activity android:name=".NewsActivity"/&
定义一个Intent来启动该Activity。例如要打开 1.
中定义的NewsActivity可定义Intent为：
Intent intent = new Intent(context, NewsActivity.class);
把Intent转换成Intent URI字符串；转换得到的Intent URI的格式是：
intent:#Icomponent=com.yourpackage/.YourAend
例如转换２.中的intent为uri：
String uriString = intent.toUri(Intent.URI_INTENT_SCHEME);//该uriString就是Constants.EXTRA_PARAM_INTENT_URI对应的值
返回值是：
intent:#Icomponent=com.xiaomi.mipushdemo/.NewsAend
如果你希望在Intent URI 中携带数据，注意一个限制：Intent.toUri(Intent.URI_INTENT_SCHEME) 返回的结果不会携带除基本类型（boolean, byte,
short, int, long, float, double, String）以外的数据类型，例如数组和HashMap。
获取了Intent URI之后，在服务端的工程里（需要引用推送服务器SDK），把uriString
设置进的Message.Builder.extra()，对应的key是Constants.EXTRA_PARAM_INTENT_URI.
private Message buildMessage() throws Exception {
String PACKAGENAME = "com.xiaomi.mipushdemo";
String messagePayload = “This is a message”;
String title = “notification title”;
String description = “notification description”;
return new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.passThrough(0)
//消息使用通知栏方式
.notifyType(1)
.extra(Constants.EXTRA_PARAM_NOTIFY_EFFECT, Constants.NOTIFY_ACTIVITY)
.extra(Constants.EXTRA_PARAM_INTENT_URI,
"intent:#Icomponent=com.xiaomi.mipushdemo/.NewsAend")
2.2.3.3. 打开网页
调用Message.Builder类的extra(String key, String
value)方法将key设置为Constants.EXTRA_PARAM_NOTIFY_EFFECT，value设置为Constants.NOTIFY_WEB；再次调用extra(String
key, String value)方法，将key设置为Constants.EXTRA_PARAM_WEB_URI，value设置为要打开网页的URI。
private Message buildMessage() throws Exception {
String PACKAGENAME = "com.xiaomi.mipushdemo";
String messagePayload = “This is a message”;
String title = “notification title”;
String description = “notification description”;
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.passThrough(0)
//消息使用通知栏方式
.notifyType(1)
.extra(Constants.EXTRA_PARAM_NOTIFY_EFFECT, Constants.NOTIFY_WEB)
.extra(Constants.EXTRA_PARAM_WEB_URI, "")
2.2.4. 使用自定义通知栏样式
如果系统默认的通知栏样式不满足需求，开发者可以自定义通知栏样式。SDK根据推送消息中指定的layout文件和填充内容，自由定制展示样式。
注意，在MIUI中，通知展示由系统通道负责，需要MIUI升级后才支持自定义通知。具体使用方法如下：
layout文件中只能包含以下控件: FrameLayout, LinearLayout, RelativeLayout, Button, ImageButton, ImageView, ProgressBar, TextView
调用Message.Builder类的extra(String key, String
value)方法将以“layout_name”为key，value设置为客户端要展示的layout文件名；
以“layout_value”为key，指定layout中各控件展示的内容，其value为一个Json。
其格式为{“text”:{“txt_res_name1”:”txt_value1”, “txt_res_name2”:”txt_value2”…},
“image”:{“img_res_name1”:”img_value1”, “img_res_name2”:”img_value2”…},
“time”:{“time_res_name”:”format_value”}}，
txt_res_name为layout文件中的控件名字，txt_value为控件上需要展示的文本内容。
img_res_name为layout中需要展示图片资源的控件名字，img_value为程序中对应的资源名。
time_res_name为layout文件中的控件名字，format_value为控件上需要展示的时间format样式。默认 yy-MM-dd
Demo:以下消息，将指定以custom_notify为通知栏样式，将其中的titleText设置为“我是标题”，descText设置为“我是描述”；将iconImage设置为icon对应的图片。
private Message buildMessage() throws Exception {
String PACKAGENAME = "com.xiaomi.mipushdemo";
String messagePayload = “This is a message”;
String title = “notification title”;
String description = “notification description”;
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.passThrough(0)
//消息使用通知栏方式
.notifyType(1)
.extra("layout_name","custom_notify")
.extra("layout_value", "{\"text\":{\"titleText\":\"标题\"},\"image\": {\"iconImage\": \"icon\"},
\"time\": {\"timeText\": \"HH:mm\"}}")
2.2.5. 指定消息的过滤规则
开发者通过调用Message.Builder类的extra(String key, String
value)来指定消息的过滤规则。另外，过滤规则能够支持所有的消息。
表 11. 消息的过滤规则
可以接收消息的设备的语言范围，用逗号分隔。
当前设备的local的获取方法：
Locale.getDefault().toString()
比如，中国大陆用”zh_CN”表示。
locale_not_in
无法收到消息的设备的语言范围，逗号分隔。
model支持三种用法。
可以收到消息的设备的机型范围，逗号分隔。
当前设备的model的获取方法：
Build.MODEL
比如，小米手机4移动版用”MI 4LTE”表示。
可以收到消息的设备的品牌范围，逗号分割。
比如，三星手机用”samsung”表示。 （目前覆盖42个主流品牌，对应关系见附录”品牌表”）
可以收到消息的设备的价格范围，逗号分隔。
比如，0-999价格的设备用&#″表示。 （目前覆盖4个价格区间，对应关系见附录”价格表”）
model_not_in
无法收到消息的设备的机型范围，逗号分隔。
app_version
可以接收消息的app版本号，用逗号分割。
安卓app版本号来源于manifest文件中的”android:versionName”的值。
注：目前支持MiPush_SDK_Client_2_2_12_sdk.jar（及以后）的版本。
app_version_not_in
无法接收消息的app版本号，用逗号分割。
指定在特定的网络环境下才能接收到消息。
目前仅支持指定”wifi”。
private Message buildMessage() throws Exception {
String PACKAGENAME = "com.xiaomi.mipushdemo";
String messagePayload = “This is a message”;
String title = “notification title”;
String description = “notification description”;
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.passThrough(0)
//消息使用通知栏方式
.notifyType(1)
.extra("locale","zh_CN")
2.2.6. 开启消息的送达回执
调用Message.Builder类的extra(String key, String
value)方法将key设置为”callback”，value设置为第三方接收回执的http接口。
小米推送服务器每隔1s将已送达的消息ID和对应设备的regid或alias通过调用第三方http接口传给开发者。（每次调用后，小米推送服务器会清空这些数据，下次传给开发者将是新一拨数据。）
注：消息的送达回执只支持单发消息。
第三方接收消息回执的http接口协议定义如下：
表 12. 消息回执接口http协议
一个json字符串，形如：
{“axxxxxx”:”alias6,alias7,alias9″,
“sxxxxxx”:”regId0,regId1,regId2,regId3,regId4,regId5,regId8″}，
表示axxxxxx这个消息已经有alias6， alias7，
alias9收到，sxxxxxx这条消息已经有regId[0,1,2,3,4,5,8]收到。
支持regId消息和alias消息，可通过msgId判断该消息是regId消息还是alias消息。
多个regId或者alias之间用逗号隔开。
一个json字符串，形如：{“code” : 0, “reason” : “succ”}。
code等于0表示成功，此时reason可以不填，否则表示失败，reason表示失败的具体原因。
如果的发送失败，推送服务器不会重试。
private Message buildMessage() throws Exception {
String PACKAGENAME = "com.xiaomi.mipushdemo";
String messagePayload = “This is a message”;
String title = “notification title”;
String description = “notification description”;
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.passThrough(0)
//消息使用通知栏方式
.notifyType(1)
.extra("callback", "/msgcallback")
2.2.7. 使用推送批次（JobKey）功能聚合消息
开发者在发送消息时可以设置消息的组ID（JobKey），带有相同的组ID的消息会被聚合为一个消息组。系统支持按照消息组展示消息详情以及计划推送／送达数量／送达曲线等统计信息。另外，相同JobKey的消息在客户端会进行去重，只展示其中的第一条。这样如果发送时同JobKey中不慎有重复的设备也不用担心用户会收到重复的通知。
设置消息的组ID 的方法是调用Message.Builder类的extra(String key, String
value)方法将key设置为”jobkey”，value设置为消息组的ID。合法的消息组ID由数字（[0-9]），大小写字母（[a-zA-Z]），下划线（_）和中划线（-）组成，长度不大于8个字符。
private Message buildMessage() throws Exception {
String PACKAGENAME = "com.xiaomi.mipushdemo";
String messagePayload = “This is a message with job key.”;
String title = “notification title”;
String description = “notification description”;
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.passThrough(0)
//消息使用通知栏方式
.notifyType(1)
.extra("jobkey", "")
2.2.8. 开启通知消息在状态栏滚动显示
调用Message.Builder类的extra(String key, String
value)方法将key设置为”ticker”，value设置为状态栏滚动显示的内容。
private Message buildMessage() throws Exception {
String PACKAGENAME = "com.xiaomi.mipushdemo";
String messagePayload = “This is a message with job key.”;
String title = “notification title”;
String description = “notification description”;
Message message = new Message.Builder()
.title(title)
.description(description).payload(messagePayload)
.restrictedPackageName(MY_PACKAGE_NAME)
.passThrough(0)
//消息使用通知栏方式
.notifyType(1)
.extra("ticker", "This is a ticker text.")
2.3. 服务器API地址以及参数
如果用户期望开发其它平台的ServerSDK，下面提供的API地址和参数也许会有帮助。
注：sandbox API只提供对IOS支持，不支持Android。
推送单条消息
向某个regid或一组regid列表推送某条消息
https://api./v2/message/regid
向某个alias或一组alias列表推送某条消息
https://api./v2/message/alias
向某个topic推送某条消息
https://api./v2/message/topic
向多个topic推送单条消息
https://api./v2/message/multi_topic
向所有设备推送某条消息
https://api./v2/message/all
向某个regid或一组regid列表推送某条消息
https://sandbox./v2/message/regid
向某个alias或一组alias列表推送某条消息
https://sandbox./v2/message/alias
向某个topic推送某条消息
https://sandbox./v2/message/topic
向多个topic推送单条消息
https://sandbox./v2/message/multi_topic
向所有设备推送某条消息
https://sandbox./v2/message/all
HTTP请求方法：POST
添加HEADER字段Authorization，用于身份验证。格式是 key=&APP_SECRET&。
APP_SECRET是从开发者网站申请得到。
注意：字符key必须小写
Authorization: key=YOUR_APP_SECRET
表 13. Android POST参数说明:
消息的内容。（注意：需要对payload字符串做urlencode处理）
restricted_package_name
App的包名。
pass_through
pass_through的值可以为：
0 表示通知栏消息
1 表示透传消息
通知栏展示的通知的标题。
description
通知栏展示的通知的描述。
notify_type
notify_type的值可以是DEFAULT_ALL或者以下其他几种的OR组合：
DEFAULT_ALL = -1;
DEFAULT_SOUND
// 使用默认提示音提示；
DEFAULT_VIBRATE = 2;
// 使用默认震动提示；
DEFAULT_LIGHTS = 4;
// 使用默认led灯光提示；
time_to_live
可选项。如果用户离线，设置消息在服务器保存的时间，单位：ms。服务器默认最长保留两周。
time_to_send
可选项。定时发送消息。用自日以来00:00:00.0 UTC时间表示（以毫秒为单位的时间）。
注：仅支持七天内的定时消息。
可选项。默认情况下，通知栏只显示一条推送消息。如果通知栏要显示多条推送消息，需要针对不同的消息设置不同的notify_id（相同notify_id的通知栏消息会覆盖之前的）。
extra.sound_uri
可选项，自定义通知栏消息铃声。extra.sound_uri的值设置为铃声的URI。参考2.2.1
注：铃声文件放在Android app的raw目录下。
extra.ticker
可选项，开启通知消息在状态栏滚动显示。
extra.notify_foreground
可选项，开启/关闭app在前台时的通知弹出。当extra.notify_foreground值为+时，app会弹出通知栏消息；当extra.notify_foreground值为+时，app不会弹出通知栏消息。注：默认情况下会弹出通知栏消息。参考2.2.2
extra.notify_effect
可选项，预定义通知栏消息的点击行为。通过设置extra.notify_effect的值以得到不同的预定义点击行为。
+：通知栏点击后打开app的Launcher Activity。
+：通知栏点击后打开app的任一Activity（开发者还需要传入extra.intent_uri）。
+：通知栏点击后打开网页（开发者还需要传入extra.web_uri）。
extra.intent_uri
可选项，打开当前app的任一组件。参考2.2.3.2
extra.web_uri
可选项，打开某一个网页。参考2.2.3.3
extra.flow_control
可选项，控制是否需要进行平缓发送（qps less 1000/second）。默认不支持。
0 表示不支持平缓发送
1 表示支持平缓发送
extra.layout_name
可选项，自定义通知栏样式，设置为客户端要展示的layout文件名。接口协议请参考2.2.4
extra.layout_value
可选项，自定义通知栏样式，必须与layout_name一同使用，指定layout中各控件展示的内容。接口协议请参考2.2.4。
extra.jobkey
可选项，使用推送批次（JobKey）功能聚合消息。客户端会按照jobkey去重，即相同jobkey的消息只展示第一条，其他的消息会被忽略。合法的jobkey由数字（[0-9]），大小写字母（[a-zA-Z]），下划线（_）和中划线（-）组成，长度不大于8个字符。
extra.callback
可选项，开启消息的送达回执。将extra.callback的值设置为第三方接收回执的http接口。
接口协议请参考2.2.5。
extra.locale
可选项，可以接收消息的设备的语言范围，用逗号分隔。
当前设备的local的获取方法：
Locale.getDefault().toString()
比如，中国大陆用zh_CN表示。
extra.locale_not_in
可选项，无法收到消息的设备的语言范围，逗号分隔。
extra.model
可选项，model支持三种用法。
可以收到消息的设备的机型范围，逗号分隔。
当前设备的model的获取方法：
Build.MODEL
比如，小米手机4移动版用”MI 4LTE”表示。
可以收到消息的设备的品牌范围，逗号分割。
比如，三星手机用”samsung”表示。 （目前覆盖42个主流品牌，对应关系见附录”品牌表”）
可以收到消息的设备的价格范围，逗号分隔。
比如，0-999价格的设备用&#″表示。 （目前覆盖4个价格区间，对应关系见附录”价格表”）
extra.model_not_in
可选项，无法收到消息的设备的机型范围，逗号分隔。
extra.app_version
可以接收消息的app版本号，用逗号分割。
安卓app版本号来源于manifest文件中的”android:versionName”的值。
注：目前支持MiPush_SDK_Client_2_2_12_sdk.jar（及以后）的版本。
extra.app_version_not_in
无法接收消息的app版本号，用逗号分割。
extra.connpt
可选项，指定在特定的网络环境下才能接收到消息。
目前仅支持指定”wifi”。
以上参数适用于所有推送消息的HTTP API。
registration_id
根据registration_id，发送消息到指定设备上。可以提供多个registration_id，发送给一组设备，不同的registration_id之间用“,”分割。
参数仅适用于“/message/regid”HTTP API。
根据alias，发送消息到指定的设备。可以提供多个alias，发送给一组设备，不同的alias之间用“,”分割。
参数仅适用于“/message/alias”HTTP API。
根据topic，发送消息给订阅了该topic的所有设备。
参数仅适用于“/message/topic”HTTP API。
topic列表，使用;$;分割。
注: topics参数需要和topic_op参数配合使用。
参数仅适用于“/message/multi_topic”HTTP API。
topic之间的操作关系。支持以下三种：
INTERSECTION
topics的列表元素是[A, B, C, D]，则并集结果是A∪B∪C∪D，具体用法可以参考”Demo 8″，交集的结果是A ∩B ∩C
∩D，差集的结果是A-B-C-D。
参数仅适用于“/message/multi_topic”HTTP API。
表 14. IOS POST参数说明:
description
通知栏展示的通知的描述。
time_to_live
可选项。如果用户离线，设置消息在服务器保存的时间，单位：ms。服务器默认最长保留两周。
time_to_send
可选项。定时发送消息。用自日以来00:00:00.0 UTC时间表示（以毫秒为单位的时间）。
注：仅支持七天内的定时消息。
extra.sound_url
可选项，自定义消息铃声。当值为空时为无声，default为系统默认声音。
extra.badge
可选项。通知角标。
extra.category
可选项。iOS8推送消息快速回复类别。
以上参数适用于所有推送消息的HTTP API。
registration_id
根据registration_id，发送消息到指定设备上。可以提供多个registration_id，发送给一组设备，不同的registration_id之间用“,”分割。
参数仅适用于“/message/regid”HTTP API。
根据alias，发送消息到指定的设备。可以提供多个alias，发送给一组设备，不同的alias之间用“,”分割。
参数仅适用于“/message/alias”HTTP API。
根据topic，发送消息给订阅了该topic的所有设备。注：不同提供多个topic。
参数仅适用于“/message/topic”HTTP API。
topic列表，使用;$;分割。
注: topics参数需要和topic_op参数配合使用。
参数仅适用于“/message/multi_topic”HTTP API。
topic之间的操作关系。支持以下三种：
INTERSECTION
topics的列表元素是[A, B, C, D]，则并集结果是A∪B∪C∪D，交集的结果是A ∩B ∩C
∩D，差集的结果是A-B-C-D。
参数仅适用于“/message/multi_topic”HTTP API。
参数附加说明：
服务器端还可以定义一些以”extra.”开头的POST参数，POST参数形式如：extra.key=value。注：至多可以设置10个key-value键值对。
利用v2/message/all可以向所有设备发送消息。参数跟向topic发送消息类似，不需要额外提供topic域。
参数规范与Message类和Sender类中的描述相同。alias，topic，registration_id三者不能同时出现，alias可以有多个，表示向这些alias指定的设备发送消息。
返回的是json格式的字符串，包括以下几个字段。
“result”: string，”ok” 表示成功, “error” 表示失败。
“description”: string， 对发送消息失败原因的解释。
“data”: string，本身就是一个json字符串（其中id字段的值就是消息的Id）。
“code”: integer，0表示成功，非0表示失败。
“info”: string，详细信息。
{"result":"ok","description":"成功","data":{"id":""},"code":0,"info":"Received push messages for 1 regid"}
{"result":"error","reason":"payload参数不能为空","description":"缺失必选参数","code":10016}
向”alias1”，“alias2”，“alias3” 三个别名指定的设备发送消息。
https://api./v2/message/alias
?alias=alias1，alias2，alias3
&description=notification description
&payload=this+is+xiaomi+push
&restricted_package_name=com.xiaomi.mipushdemo
&title=notification title
¬ify_type=2
&time_to_live=1000
&pass_through=0
&extra.sound_uri=android.resource://com.xiaomi.mipushdemo/raw/shaking
向registration_id为123指定的设备发送消息。
https://api./v2/message/regid
?description=notification description
&payload=this+is+xiaomi+push
&restricted_package_name=com.xiaomi.mipushdemo
®istration_id=123
&title=notification title
¬ify_type=2
&time_to_live=1000
¬ify_id=0
向订阅了my_topic的所有设备发送消息。
https://api./v2/message/topic
?description=notification description
&payload=this+is+xiaomi+push
&restricted_package_name=com.xiaomi.mipushdemo
&topic=my_topic
&title=notification title
¬ify_type=2
&time_to_live=1000
自定义点击行为：打开app的Launcher Activity
https://api./v2/message/alias
?alias=test_alias1
&description=notification description
&payload=this+is+xiaomi+push
&restricted_package_name=com.xiaomi.mipushdemo
&title=notification title
¬ify_type=2
&time_to_live=1000
&pass_through=0
&extra.notify_effect=1
自定义点击行为：打开app的任一组件
https://api./v2/message/alias
?alias=test_alias1
&description=notification description
&payload=this+is+xiaomi+push
&restricted_package_name=com.xiaomi.mipushdemo
&title=notification title
¬ify_type=2
&time_to_live=1000
&pass_through=0
&extra.notify_effect=2
&extra.intent_uri=intent:#Iaction=com.a.b.end
自定义点击行为：打开网页
https://api./v2/message/alias
?alias=test_alias1
&description=notification description
&restricted_package_name=com.xiaomi.mipushdemo
&title=notification title
¬ify_type=2
&time_to_live=1000
&pass_through=0
&extra.notify_effect=3
&extra.web_uri=
自定义通知栏样式：
https://api./v2/message/alias
?alias=test_alias1
&description=notification description
&restricted_package_name=com.xiaomi.mipushdemo
&title=notification title
¬ify_type=2
&time_to_live=1000
&pass_through=0
&extra.layout_name=custom_notify
&extra.layout_value={\"text\":{\"titleText\":\"我是标题\"},\"image\": {\"iconImage\": \"icon\"},\"time\": {\"timetext\": \"HH:mm\"}}
向订阅了[A,B,C,D]集合中任一标签的设备发送消息。
https://api./v2/message/multi_topic
?description=notification description
&payload=this+is+xiaomi+push
&restricted_package_name=com.xiaomi.mipushdemo
&topics=A;$;B;$;C;$;D
&topic_op=UNION
&title=notification title
¬ify_type=2
&time_to_live=1000
推送多条消息
针对不同的regid推送不同的消息
https://api./v2/multi_messages/regids
针对不同的alias推送不同的消息
https://api./v2/multi_messages/aliases
针对不同的regid推送不同的消息
https://sandbox./v2/multi_messages/regids
针对不同的alias推送不同的消息
https://sandbox./v2/multi_messages/aliases
HTTP请求方法：POST
添加HEADER字段Authorization，用于身份验证。格式是 key=&APP_SECRET&。
APP_SECRET是从开发者网站申请得到。
注意：字符key必须小写
Authorization: key=YOUR_APP_SECRET
表 15. Android POST参数说明:
发送的消息。messages是json格式的字符串。（注意：需要对messages字符串做urlencode处理）
对于extra.sound_uri、extra.notify_foreground、extra.notify_effect、extra.intent_uri、extra.web_uri等以extra为前缀的Post参数，需要将它们定义成一个json字符串，格式如下：
"extra":{"sound_uri":"XXX","notify_effect":"XX"....}
当使用https://sandbox./v2/multi_messages/regids时，格式满足：
{"target":"regid1","message":{"payload":"your content","restricted_package_name":
"your packagename","pass_through":XXX,"notify_type":XXX,"description":"XXX",
"title":"XXX","time_to_live":XXX,"notify_id":XXX，"extra":{"sound_uri":"XXX","notify_effect":"XX"....}}},
{"target":"regids2","message":{......}},
{"target":"regidsN","message":{......}}
当使用https://sandbox./v2/multi_messages/aliases时，格式满足：
{"target":"alias1","message":{"payload":"your content","restricted_package_name":
"your packagename","pass_through":XXX,"notify_type":XXX,"description":"XXX",
"title":"XXX","time_to_live":XXX,"notify_id":XXX，"extra":{"sound_uri":"XXX","notify_effect":"XX"....}}},
{"target":"alias2","message":{......}},
{"target":"aliasN","message":{......}}
time_to_send
可选项，定时发送批量消息。用自日以来00:00:00.0 UTC时间表示（以毫秒为单位的时间）。
定时发送批量消息，不需要针对每条消息设置time_to_send。
仅支持七天内的定时消息。
表 16. IOS POST参数说明
发送的消息。messages是json格式的字符串。（注意：需要对messages字符串做urlencode处理）
对于extra.sound_url、extra.badge、extra.category等以extra为前缀的Post参数，需要将它们定义成一个json字符串，格式如下：
"extra":{"sound_url":"XXX","badge":"XXX"....,"category":"XXX"}
当使用https://sandbox./v2/multi_messages/regids时，格式满足：
{"target":"regid1","message":{"description":"XXX","time_to_live":XXX，"extra":{"sound_url":"XXX","badge":"XXX","category":"XXX"....}}},
{"target":"regids2","message":{......}},
{"target":"regidsN","message":{......}}
当使用https://sandbox./v2/multi_messages/aliases时，格式满足：
{"target":"alias1","message":{"description":"XXX","time_to_live":XXX,"extra":{"sound_url":"XXX","badge":"XXX","category":"XXX"....}}},
{"target":"alias2","message":{......}},
{"target":"aliasN","message":{......}}
time_to_send
可选项，定时发送批量消息。用自日以来00:00:00.0 UTC时间表示（以毫秒为单位的时间）。
定时发送批量消息，不需要针对每条消息设置time_to_send。
仅支持七天内的定时消息。
返回的是json格式的字符串，包括以下几个字段。
“result”: string，”ok” 表示成功, “error” 表示失败。
“description”: string， 对发送消息失败原因的解释。
“data”: string，本身就是一个json字符串（其中id字段的值就是消息的Id）。
“code”: integer，0表示成功，非0表示失败。
“info”: string，详细信息。
注意：为了将json数据的格式看得比较清晰，我们没有做urlencode处理。但是，实际开发中必须对json数据做urlencode处理。
向不同的regid发送不同的消息
https://api./v2/multi_messages/regids
?messages=[{"target":"regid1","message":
{"payload":"send message to regid1","restricted_package_name":"com.xiaomi.mipushdemo","pass_through":1,
"notify_type":1,"description":"description1","title":"title1","time_to_live":100000，
"extra":{"sound_uri":"android.resource://com.xiaomi.mipushdemo/raw/shaking"}}},
{"target":"regid2","message":
{"payload":"send message to regid2","restricted_package_name":"com.xiaomi.mipushdemo","pass_through":1,
"notify_type":2,"description":"description2","title":"title2","time_to_live":20000}}]
向不同的alias发送不同的消息
https://api./v2/multi_messages/aliases
?messages=[{"target":"alias1","message":
{"payload":"send message to alias1","restricted_package_name":"com.xiaomi.mipushdemo","pass_through":1,
"notify_type":1,"description":"description1","title":"title1","time_to_live":100000}},
{"target":"alias2","message":
{"payload":"send message to alias2","restricted_package_name":"com.xiaomi.mipushdemo","pass_through":1,
"notify_type":2,"description":"description2","title":"title2","time_to_live":20000}}]
获取消息的统计数据
正式环境API地址：
https://api./v1/stats/message/counters
HTTP请求方法：GET
添加HEADER字段Authorization，用于身份验证。格式是 key=&APP_SECRET&。
APP_SECRET是从开发者网站申请得到。
注意：字符key必须小写
Authorization: key=YOUR_APP_SECRET
表 17. GET参数说明:
start_date
表示开始日期，必须符合yyyyMMdd的格式。
表示结束日期，必须符合yyyyMMdd的格式。开始日期和结束日期之间的跨度小于30天。
restricted_package_name
Android设备，传入App的包名。
IOS设备，传入App的Bundle Id。
返回的是json格式的字符串。
如果成功，则返回的字符串格式如下。
{“result”:”ok”,”description”:”成功”,”data”:{“data”:”[{"date":"yyyyMMdd","single_recipients":XXXX,"broadcast_recipients":XX,"received":XXXX,"click":XXXX}...{"date":"yyyyMMdd","single_recipients":XXXX,"broadcast_recipients":XX,"received":XXXX,"click":XXXX}]“},”code”:0}
其中，single_recipients表示的是单发（发送到指定的regid或者alias）消息量，broadcast_recipients表示的是群发（发送到指定的topic）消息量，received表示的是消息的接受量（包括单发消息和群发消息），click表示通知栏消息的点击量。
如果失败，则返回的字符串格式如下。
{“result”:”error”,”reason”:”XXXXXXXXX”,”description”:”XXXX”,”code”:XXXX}
https://api./v1/stats/message/counters
?start_date=
&end_date=
&restricted_package_name=com.xiaomi.mipushdemo
{"result":"ok","description":"成功","data":{"data":"[
{\"date\":\"\",\"single_recipients\":0,\"broadcast_recipients\":7689,\"received\":7026,\"click\":1703},
{\"date\":\"\",\"single_recipients\":0,\"broadcast_recipients\":5129,\"received\":4642,\"click\":1256}
]"},"code":0}
追踪消息状态
正式环境API地址：
追踪单条消息
https://api./v1/trace/message/status
追踪某个时间区域内的消息
https://api./v1/trace/messages/status
HTTP请求方法：GET
添加HEADER字段Authorization，用于身份验证。格式是 key=&APP_SECRET&。
APP_SECRET是从开发者网站申请得到。
注意：字符key必须小写
Authorization: key=YOUR_APP_SECRET
表 18. 追踪单条消息的GET参数说明:
表示消息的Id。
返回的是json格式的字符串。
{"result":"ok","description":"成功","data":{"data":"
{\"id\":\"s7636237jB\",\"delivery_rate\":\"100%\",\"delivered\":1,\"resolved\":1,
\"msg_type\":\"BatchRegId\",\"create_time\":\" 21:07:16\",\"time_to_live\":\"1209600s\",
\"click\":0,\"click_rate\":\"0%\"}"},"code":0}
表示单条消息的id，delivered表示消息的送达数，resolved表示消息的计划送达数，delivery_rate表示送达率，click表示消息的点击数，click_rate表示消息的点击率，create_time表示消息的发送时间，time_to_live表示消息的有效期，msg_type表示该消息发送的方式(msg_type分为Common、BatchRegId、Alias、BatchAlias、Topic)。
表 19. 追踪某个时间区域内消息的GET参数说明:
begin_time
表示开始时间戳，单位ms。
表示结束时间戳，单位ms。
返回的是json格式的字符串。
{"result":"ok","description":"成功","data":{"data":"[
{\"id\":\"a0283940fp\",\"delivery_rate\":\"100%\",\"delivered\":2,\"resolved\":2,
\"msg_type\":\"BatchAlias\",\"create_time\":\" 16:44:43\",\"time_to_live\":\"109s\",
\"create_timestamp\":1,\"click\":0,\"click_rate\":\"0%\"},
{\"id\":\"s0247716NA\",\"delivery_rate\":\"100%\",\"delivered\":2,\"resolved\":2,
\"msg_type\":\"BatchRegId\",\"create_time\":\" 16:44:07\",\"time_to_live\":\"109s\",
\"create_timestamp\":7,\"click\":0,\"click_rate\":\"0%\"},
{\"id\":\"a0207789dJ\",\"delivery_rate\":\"0%\",\"delivered\":0,\"resolved\":1,
\"msg_type\":\"Alias\",\"create_time\":\" 16:43:27\",\"time_to_live\":\"1209600s\",
\"create_timestamp\":9,\"click\":0,\"click_rate\":\"0%\"},
{\"id\":\"t0155849Ek\",\"delivery_rate\":\"100%\",\"delivered\":2,\"resolved\":2,
\"msg_type\":\"Topic\",\"create_time\":\" 16:42:35\",\"time_to_live\":\"109s\",
\"create_timestamp\":9,\"click\":0,\"click_rate\":\"0%\"},
{\"id\":\"si\",\"delivery_rate\":\"0%\",\"delivered\":0,\"resolved\":1,
\"msg_type\":\"Common\",\"create_time\":\" 16:42:11\",\"time_to_live\":\"1209600s\",
\"create_timestamp\":2,\"click\":0,\"click_rate\":\"0%\"}]"},"code":0}
订阅/取消订阅标签
订阅RegId的标签
https://api./v2/topic/subscribe
取消订阅RegId的标签
https://api./v2/topic/unsubscribe
订阅alias的标签
https://api./v2/topic/subscribe/alias
取消订阅alias的标签
https://api./v2/topic/unsubscribe/alias
订阅RegId的标签
https://sandbox./v2/topic/subscribe
取消订阅RegId的标签
https://sandbox./v2/topic/unsubscribe
订阅alias的标签
https://sandbox./v2/topic/subscribe/alias
取消订阅alias的标签
https://sandbox./v2/topic/unsubscribe/alias
HTTP请求方法：POST
添加HEADER字段Authorization，用于身份验证。格式是 key=&APP_SECRET&。
APP_SECRET是从开发者网站申请得到。
注意：字符key必须小写
Authorization: key=YOUR_APP_SECRET
针对/v2/topic/subscribe和/v2/topic/unsubscribe的参数说明：
表 20. 订阅/取消订阅RegId的标签的GET参数说明:
registration_id
设备regid列表，逗号分隔，必填。
标签，必填。
https://api./v2/topic/subscribe
?registration_id=abc
针对/v2/topic/subscribe/alias和/v2/topic/unsubscribe/alias的参数说明：
表 21. 订阅/取消订阅alias的标签的GET参数说明:
各个alias之间用逗号分割，最多不能超过1000个alias。
标签，必填。
https://api./v2/topic/subscribe/alias
?aliases=a1
获取失效的regId列表
正式环境API地址：
https://feedback./v1/feedback/fetch_invalid_regids
HTTP请求方法：GET
添加HEADER字段Authorization，用于身份验证。格式是 key=&APP_SECRET&。
APP_SECRET是从开发者网站申请得到。
注：字符key必须小写。另外，目前仅支持安卓设备。
Authorization: key=YOUR_APP_SECRET
该HTTP请求的几点说明：
获取失效的regId列表不需要传递任何HTTP参数。
获取失效的regId列表，每次请求最多返回1000个regId。
每次请求之后，成功返回的失效的regId将会从MiPush数据库删除。
返回的是json格式的字符串，分为以下三种情况。
存在失效的regid
{“result”:”ok”,”description”:”成功”,”data”:{“list”:["regid1","regid2","regid3"]},”code”:0}
不存在失效的regid
{“result”:”ok”,”description”:”成功”,”data”:{“list”:[]},”code”:0}
请求存在异常
{“result”:”error”,”reason”:”Invalid application
secret.”,”description”:”认证失败”,”code&#}
检测/删除定时任务
正式环境API地址：
检测定时任务是否存在
https://api./v2/schedule_job/exist
删除定时任务
https://api./v2/schedule_job/delete
HTTP请求方法：GET
添加HEADER字段Authorization，用于身份验证。格式是 key=&APP_SECRET&。
APP_SECRET是从开发者网站申请得到。
注：字符key必须小写。另外，目前仅支持安卓设备。
Authorization: key=YOUR_APP_SECRET
表 22. 参数列表
表示消息的Id。
返回的是json格式的字符串。
code是0,表示成功；否则表示失败，reason表示失败的原因。
表 23. 品牌表
中兴努比亚
china mobile
kubimofang
xiaolajiao
表 24. 价格表
This entry was posted in}
我要回帖
更多关于 vivo游戏下载 的文章
更多推荐
- ·2024.5.27号上午9:05分2021年9月27号出生的男宝宝好吗，男宝八字什么格局？ 是否贵格
- ·潘玮柏在46届台湾台湾历届金钟奖得主获得什么奖
- ·雪熊雪中悍刀行怎么样这本书的作者是谁?
- ·李采潭出演过哪些电影？
- ·王大陆王牌对王牌康熙剧组重聚是哪一集来了哪一期
- ·atthemonment绿茶婊是什么意思思
- ·请专家预测2015年2015考研国家线预测线
- ·英国伯明翰时间大学硕士研究生专业目录
- ·角平分线定理上的点到角两边的距离不是相等的吗，为什么在这里DA≠DF
- ·penci1一in case是什么意思思
- ·沈北新区招聘网二一三煤矿棚户区
- ·缅甸为什么迁都会发现鲸鱼
- ·黄帝称云裳广场舞牧马少年童子为天师让你想起孔子的名言
- ·用什么鉴定纤维素酶活性测定的纯度
- ·how does it feela cat have fut的回答
- ·用9颗棋子摆图形,要求每条线上有4颗棋子围棋共有多少个棋子几种摆法
- ·刘博庆结婚视频快手号是多少
- ·鹿晗吴亦凡春晚后台台采访牛鹿晗
- ·以正方形abcd的边bc中,e,f分别是bc,cd的中点,连接ac,ae交bf于m,n点,求mn:nf=
- ·vivo游戏中心下载怎样下载到sdk
- ·iPad上的carnivores age.of.ice 字幕age怎么玩
- ·oracle jdeveloper 清除bpm缓存，每次修改nginx wsdl缓存服务地址后，总是前一个旧地址
- ·2015印花衬衫倪妮，微博上面的街拍微博。
- ·befour-befour disco加快快版本
- ·酷牌t 1为什么晚上会笔记本开机自动关机机,扣电池后才能重新开机
- ·奇瑞手动变速箱e3变速杆怎么拆卸
- ·伊春市桃南锡太公路好走吗现在好走吗？
- ·不要的照片处理软件怎么处理好？听说不能烧掉。
- ·请鉴定新百伦论坛 真假鉴定580真假，谢谢
- ·刘朝瑞老婆现况如何，有人浣说被抓了真的吗！
- ·菲律宾卡卡湾在哪里工贸部在哪里，中国公民可以注册个体营业部吗，需要那些资料
- ·企业党员自我评价范文50字数
- ·为何相同产品在水洗皮时设定织物米重不同会影响产品的ph值
- ·去中枢的意思思
- ·慈溪方家河头村村一年级的成绩
