接口类型定义
1. 执行对个推的请求
1.1 IGtPush
代表在个推注册的一个app，调用该类实例的方法来执行对个推的请求， 构造函数说明如下：
推送os域名, host可选填，如果host不填程序自动检测用户网络，选择最快的域名连接下发。（服务端SDK版本号3.4.0.0及以上版本支持该功能）
用于鉴定身份是否合法
masterSecret
第三方客户端个推集成鉴权码，用于验证第三方合法性。在服务端推送鉴权时使用
是否使用https接口调用：true 使用https连接，false使用http连接；默认使用http。（服务端SDK版本号4.0.1.0及以上版本支持该功能）
1.2 接口调用方法
IGtPush push = new IGtPush(appkey,masterSecret);
IGtPush push = new IGtPush(appkey,masterSecret,false);
IGtPush push = new IGtPush(getui_http_host, appkey,masterSecret);
比如getui_http_host为"http://sdk.open./apiex.htm"
IGtPush push = new IGtPush(appkey,masterSecret,true);
IGtPush push = new IGtPush(getui_https_host, appkey,masterSecret);
比如getui_https_host为"/apiex.htm"
1.3 包含接口
推送任务接口
pushMessageToSingle
对单个用户推送消息
getContentId
获取taskid，和pushMessageToList配套使用
CancelContentId
取消taskid，和pushMessageToList配套使用
pushMessageToList
对指定用户列表推送消息
pushMessageToApp
对指定应用群推送消息
iOS推送特定接口
pushAPNMessageToSingle
对单个ios用户推送消息
getAPNContentId
获取apn消息的taskid，和pushAPNMessageToList配套使用
pushAPNMessageToList
对指定ios用户列表推送消息
批量上传接口
返回一个IBatch实例通过批量推送调用
停止推送接口
停止任务发送
Bade设置接口(仅iOS)
设置iOS用户应用icon上显示的数字
标签设置接口
setClientTag
设置用户tag属性
getUserTags
获取用户tags
别名功能接口
单个cid绑定别名
多个cid绑定别名（和单个的传参不一样）
queryClientId
根据别名获取cid
queryAlias
根据cid获取别名
unBindAliasAll
所有cid和别名解绑
unBindAlias
单个cid和别名解绑
查询功能接口
getClientIdStatus
通过CID查询用户状态
getPushResult
通过taskId获取推送结果数据
queryAppUserDataByDate
通过日期，获取App维度的用户数据
queryAppPushDataByDate
通过日期，获取App维度的推送数据
getPushResultByGroupName
根据任务组名获取推送结果数据
getLast24HoursOnlineUserStatistics
获取24小时内在线用户数
getPersonaTags
获取用户画像标签
queryUserCount
获取用户总数
2.1 Message
Message，定义消息推送方式
SingleMessage
单推消息的消息体
ListMessage
列表推送消息的消息体
AppMessage
指定应用群推送消息的消息体
2.1.1 SingleMessage
单推消息的消息体
成员和方法名
推送消息消息内容
setPriority
消息体的优先级
setOffline
消息离线是否存储
setOfflineExpireTime
消息离线存储多久，单位为毫秒，
setPushNetWorkType
1：wifi推送；0：不限制推送方式
2.1.2 ListMessage
列表推送消息的消息体
成员和方法名
推送消息消息内容
setPriority
消息体的优先级
setOffline
消息离线是否存储
setOfflineExpireTime
消息离线存储多久，单位为毫秒，
setPushNetWorkType
1：仅wifi推送；0：不限联网方式
2.1.3 AppMessage
指定应用群推送消息的消息体
成员和方法名
推送消息消息内容
setOffline
消息离线是否存储
setOfflineExpireTime
消息离线存储多久，单位为毫秒，
setAppIdList
指定推送的应用列表
setPhoneTypeList
setProvinceList
设置省份或城市。可以是省份名称，也可以是城市编号，详见按城市推送接口
setTagList
设置标签内容
setPushNetWorkType
1：wifi推送；0：不限制推送方式
setConditions
AppConditions
限定推送用户的条件
3. 推送目标
3.1 Target
注意：setClientId和setAlias其中一项必填
定义一个推送目标
成员和方法名
设置客户端所属应用唯一ID
setClientId
设置客户端身份ID
设置客户端所属用户别名
4. 推送结果
4.1 IPushResult
定义推送接口返回结果。通过该接口调用者可以获得 调用推送接口的结果码，生成的任务ID以及消息ID等信息。
getResponse
获取推送返回结果
4.2 推送结果返回值
successed_online
result=ok，状态在线下发
successed_offline
result=ok，状态离线转入离线消息
用户离线时返回，用户最近一次登录时间戳
有效可下发总数
msgProcess
消息回执总数
用户点击数
successed_ignore
无效用户，消息丢弃
将cid列表加入黑名单失败
invalidCidList
无效的cid列表
StopTaskError
停止任务失败
NotInDealRange
该任务不在停止任务的范围内
请求信息填写有误
AppidError
clientid绑定的appid与推送的appid不符
AppKeyError
Appkey填写错误
sign_error
Appkey与ClientId不匹配，鉴权失败
domain_error
填写的域名错误或者无法解析
action_error
未找到对应的action动作
PushTotalNumOverLimit
推送消息个数总数超限
TokenMD5NoUsers
在系统中未查找到用户
TargetListIsNullOrSizeIs0
目标用户列表为空
taskIdNullError
任务Id为空
ServiceError！
service错误
AppidNoAppSecret
appId没有对应的appSecret
AppidNoMatchAppKey
appid未找到对应的appkey
TaskIdNotMatchAppKey
taskId找不到对应的appKey
NullMsgCommon
未找到消息公共体
PushMsgToListTimesOverLimit
群推消息次数超限
PushMsgToAppTimesOverLimit
群推消息次数超限
TokenMD5NoUsers
在系统中未查找到用户
消息发送失败
SynSendError
报文发送错误
cid未绑定appid
FlowExceeded
接口消息推送流量已超限
BlackAppId
appId为黑名单
TokenMD5Error
cid填写错误
TagsNoUsers
标签找不到对应用户
AppIdNoUsers
appid下找不到对应用户
PushTotalNumOverLimit
推送总数超限
NoSuchTaskId
无效contentid
每个clientId在24小时内只能设置一次
ParsePushInfoError
pushinfo消息格式有误
DeviceTokenError
无效devicetoken
NoTargetDeviceToken
没有填写devicetoken
TaskIdNotMatchAppKey
taskId找不到对应的appKey
没有推送目标
TagInvalidOrNoAuth
无效的变迁或没鉴权
AliasNotBind
别名没有绑定
OtherError
未知错误，无法判定错误类型
GroupNumOverLimit
直播间超过套餐值
GroupCidNumOverLimit
单个直播间的cid数超过套餐值
PushTooFrequency
直播间推送过频
PushTotalOverLimit
直播间当天推送总数超限
AppidOrGroupidErr
直播间查询传入的appid和groupid不对应
5. 批量操作
5.1 IBatch
定义批量上传
5.1.1 submit
上传消息到服务器，返回IPushResult结果
SingleMessage
推送消息方式
推送用户目标
5.1.3 retry
submit失败后，可以再次提交，返回IPushResult结果
Documentation built with .
From here you can search these documents. Enter
your search terms below.【图文】模块与接口规范_百度文库
两大类热门资源免费畅读
续费一年阅读会员，立省24元！
评价文档：
模块与接口规范
上传于|0|0|暂无简介
大小：654.50KB
登录百度文库，专享文档复制特权，财富值每天免费拿！
你可能喜欢简介；MII是英文MediumIndependentI；MII接口：；TXD(TransmitData)[3:0]：数；RXD(ReceiveData)[3:0]：数据；TX_ER(TransmitError)：发送数；RX_ER(ReceiveError)：接收数据；TX_EN(TransmitEnable)：发送；RX_CLK：接收数据参考时钟，100M
MII是英文Medium Independent Interface的缩写，翻译成中文是“介质独立接口”，该接口一般应用于以太网硬件平台的MAC层和PHY层之间，MII接口的类型有很多，常用的有MII、RMII、SMII、SSMII、SSSMII、GMII、RGMII、SGMII、TBI、RTBI、XGMII、XAUI、XLAUI等。下面对它们进行一一介绍。
TXD(Transmit Data)[3:0]：数据发送信号，共4根信号线；
RXD(Receive Data)[3:0]：数据接收信号，共4根信号线；
TX_ER(Transmit Error)：
发送数据错误提示信号，同步于TX_CLK，高电平有效，表示TX_ER有效期内传输的数据无效。对于10Mbps速率下，TX_ER不起作用；
RX_ER(Receive Error)：
接收数据错误提示信号，同步于RX_CLK，高电平有效，表示RX_ER有效期内传输的数据无效。对于10Mbps速率下，RX_ER不起作用；
TX_EN(Transmit Enable)： 发送使能信号，只有在TX_EN有效期内传的数据才有效； RX_DV(Reveive Data Valid)： 接收数据有效信号，作用类型于发送通道的TX_EN； TX_CLK：发送参考时钟，100Mbps速率下，时钟频率为25MHz，10Mbps速率下，时钟频率为2.5MHz。注意，TX_CLK时钟的方向是从PHY侧指向MAC侧的，因此此时钟是由PHY提供的。
RX_CLK：接收数据参考时钟，100Mbps速率下，时钟频率为25MHz，10Mbps速率下，时钟频率为2.5MHz。RX_CLK也是由PHY侧提供的。
CRS：Carrier Sense，载波侦测信号，不需要同步于参考时钟，只要有数据传输，CRS就有效，另外，CRS只有PHY在半双工模式下有效；
COL：Collision Detectd，冲突检测信号，不需要同步于参考时钟，只有PHY在半双工模式下有效。
MII接口一共有16根线。
RMII接口：
RMII即Reduced MII，是MII的简化板，连线数量由MII的16根减少为8根。 TXD[1:0]：数据发送信号线，数据位宽为2，是MII接口的一半；
RXD[1:0]：数据接收信号线，数据位宽为2，是MII接口的一半；
TX_EN(Transmit Enable)：数据发送使能信号，与MII接口中的该信号线功能一样； RX_ER(Receive Error)：数据接收错误提示信号，与MII接口中的该信号线功能一样； CLK_REF：是由外部时钟源提供的50MHz参考时钟，与MII接口不同，MII接口中的接收时钟和发送时钟是分开的，而且都是由PHY芯片提供给MAC芯片的。这里需要注意的是，由于数据接收时钟是由外部晶振提供而不是由载波信号提取的，所以在PHY层芯片内的数据接收部分需要设计一个FIFO，用来协调两个不同的时钟,在发送接收的数据时提供缓冲。PHY层芯片的发送部分则不需要FIFO，它直接将接收到的数据发送到MAC就可以了。 CRS_DV：此信号是由MII接口中的RX_DV和CRS两个信号合并而成。当介质不空闲时，CRS_DV和RE_CLK相异步的方式给出。当CRS比RX_DV早结束时(即载波消失而队列中还有数据要传输时)，就会出现CRS_DV在半位元组的边界以25MHz/2.5MHz的频率在0、1之间的来回切换。因此，MAC能够从 CRS_DV中精确的恢复出RX_DV和CRS。 在100Mbps速率时，TX/RX每个时钟周期采样一个数据；在10Mbps速率时，TX/RX每隔10个周期采样一个数据，因而TX/RX数据需要在数据线上保留10个周期，相当于一个数据发送10次。
当PHY层芯片收到有效的载波信号后，CRS_DV信号变为有效，此时如果FIFO中还没有数据，则它会发送出全0的数据给MAC，然后当FIFO中填入有效的数据帧，数据帧的开头是“101010---”交叉的前导码，当数据中出现“01”的比特时，代表正式数据传输开始，MAC芯片检测到这一变化，从而开始接收数据。
当外部载波信号消失后，CRS_DV会变为无效，但如果FIFO中还有数据要发送时，CRS_DV在下一周期又会变为有效，然后再无效再有效，直到FIFO中数据发送完为止。在接收过程中如果出现无效的载波信号或者无效的数据编码，则RX_ER会变为有效，表示物理层芯片接收出错。
SMII接口：
SMII即Serial MII，串行MII的意思，跟RMII相比，连线进一步减少到4根；
TXD：发送数据信号，位宽为1；
RXD：接收数据信号，位宽为1；
SYNC：收发数据同步信号，每10个时钟周期置1次高电平，指示同步。
CLK_REF：所有端口共用的一个参考时钟，频率为125MHz，为什么100Mbps速率要用125MHz时钟？因为在每8位数据中会插入2位控制信号，请看下面介绍。
TXD/RXD以10比特为一组，以SYNC为高电平来指示一组数据的开始，在SYNC变高后的10个时钟周期内，TXD上依次输出的数据是：TXD[7:0]、TX_EN、TX_ER，控制信号的含义与MII接口中的相同；RXD上依次输出的数据是：RXD[7:0]、RX_DV、CRS，RXD[7:0]的含义与RX_DV有关，当RX_DV为有效时(高电平)，RXD[7:0]上传输的是物理层接收的数据。当RX_DV为无效时(低电平)，RXD[7:0]上传输的是物理层的状态信息数据。见下表：
当速率为10Mbps时，每一组数据要重复10次，MAC/PHY芯片每10个周期采样一次。 MAC/PHY芯片在接收到数据后会进行串/并转换。
SSMII接口：
SSMII即Serial Sync MII，叫串行同步接口，跟SMII接口很类似，只是收发使用独立的参考时钟和同步时钟，不再像SMII那样收发共用参考时钟和同步时钟，传输距离比SMII更远。
SSSMII接口：
SSSMII即Source Sync Serial MII，叫源同步串行MII接口，SSSMII与SSMII的区别在于参考时钟和同步时钟的方向，SSMII的TX/RX参考时钟和同步时钟都是由PHY芯片提供的，而SSSMII的TX参考时钟和同步时钟是由MAC芯片提供的，RX参考时钟和同步时钟是由PHY芯片提供的，所以顾名思义叫源同步串行。
GMII接口：
与MII接口相比，GMII的数据宽度由4位变为8位，GMII接口中的控制信号如TX_ER、TX_EN、RX_ER、RX_DV、CRS和COL的作用同MII接口中的一样，发送参考时钟GTX_CLK和接收参考时钟RX_CLK的频率均为125MHz(1000Mbps/8=125MHz)。
在这里有一点需要特别说明下，那就是发送参考时钟GTX_CLK，它和MII接口中的TX_CLK是不同的，MII接口中的TX_CLK是由PHY芯片提供给MAC芯片的，而GMII接口中的GTX_CLK是由MAC芯片提供给PHY芯片的。两者方向不一样。
在实际应用中，绝大多数GMII接口都是兼容MII接口的，所以，一般的GMII接口都有两个发送参考时钟：TX_CLK和GTX_CLK(两者的方向是不一样的，前面已经说过了)，在用作MII模式时，使用TX_CLK和8根数据线中的4根。
RGMII接口：
RGMII即Reduced GMII，是RGMII的简化版本，将接口信号线数量从24根减少到14根(COL/CRS端口状态指示信号，这里没有画出)，时钟频率仍旧为125MHz，TX/RX数据宽度从8为变为4位，为了保持1000Mbps的传输速率不变，RGMII接口在时钟的上升沿和下降沿都采样数据。在参考时钟的上升沿发送GMII接口中的TXD[3:0]/RXD[3:0]，在参考时钟的下降沿发送GMII接口中的TXD[7:4]/RXD[7:4]。RGMI同时也兼容100Mbps和10Mbps两种速率，此时参考时钟速率分别为25MHz和2.5MHz。
TX_EN信号线上传送TX_EN和TX_ER两种信息，在TX_CLK的上升沿发送TX_EN，下降沿发送TX_ER；同样的，RX_DV信号线上也传送RX_DV和RX_ER两种信息，在RX_CLK的上升沿发送RX_DV，下降沿发送RX_ER。
三亿文库包含各类专业文献、中学教育、应用写作文书、专业论文、各类资格考试、幼儿教育、小学教育、高等教育、17各种MII类型接口详解等内容。　
　MII 接口的类型有很多,常用的有 MII、RMII、SMII、...各种Mii接口技术 44页 免费 以太网知识(1)-MII接口...MII接口、MAC、PHY详解 7页 1下载券 MII接口介绍 ... 　各种MII详解(MII,GMII,RGM... 9页 1财富值 以太网接口知识 23页 免费 MII...MII 总线 在 IEEE802.3 中规定的 MII 总线是一种用于将不同类型的 PHY 与... 　以太网MII接口类型大全 MI... 8页 5财富值 分析接口 暂无评价 7页 免费 接口...各种MII详解(MII,GMII,RGM... 9页 1财富值 GMII_RGMII 9页 免费 MII接口... 　的硬件接口与多种 PHY 芯 片相连接,MII 的类型比较多常用的有 MII,RMII,...二 各种 MII 详细介绍作为各种 MII 的始祖,首先还是介绍 MII 接口 很明显 MII... 　3页 2财富值 各种MII类型接口详解 9页 5财富值喜欢此文档的还喜欢 ...GE 接口:指的是 Gigabit Ethernet 千兆以太网接口带有 GE 标记的接口,说明是 ... 　千兆以太网MII接口_信息与通信_工程科技_专业资料。介绍现在经常使用的RGMII SGMII GMII接口 千兆以太网 MII 接口类型主要有 GMII、RGMII、SGMII、TBI 和 RTBI 五... 　(MAC 与 PHY 间 的管理接口一般是 MDIO) MII 接口的类型有很多,常用的有 MII、RMII、SMII、SSMII、SSSMII、GMII、RGMII、 SGMII、TBI、RTBI、XGMII、XAUI、... 　MIIMDIO接口详解_电脑基础知识_IT/计算机_专业资料。MII/MDIO 接口详解本文主要分析...各种MII详解(MII,GMII,R... 9页 1下载券 MII设计详解 41页 免费©... 　MII 层定义了在 100BASE-T MAC 和各种物理层之间的标准电气和机械接口, 这种...编辑本段 MII 总线 在 IEEE802.3 中规定的 MII 总线是一种用于将不同类型...