MiTV and MiBox Game DeveloperGuide(for Single Player Game)
V1.0.1
2013-11-29
Modify history:
Definition of Terms:
1.XiaoMi gamecenter
1.1. Introduction
Xiaomi gamecenter is released foral l Miphone,MiBox,MiTVand MIUI users byxiaomicompany.The whole center, striving to create a betterAndroid ecosystem, includes manyqual ity resources such as MIUI system,develop SDK,internetwebsite,xiaomi Forum etc..
Xiaomi game centerprovidesan easyand quickaccessof downloading, searching,charging(supportonl ineand single player)of games, it isthe bestchoiceforgamedevelopers.
1.3.Mibi
Mibi is issued byxiaomi company,used forvirtual production payment, l ikeQbi . Mibi hasthe characteristicsof circulation in al l xiaomi virtual production platform.Users could chargethroughxiaomiaccounts(BuyMibivia RMB),and payforal l the production inxiaomi and itsco-company production platform.
1RMB=1Mibi, thesmal lestunit is1cent, so something could bepriced at0.01Mibi .
The Mibi amountspent byusersfor appl icationsarethe basisforsettlementfortheincoming of developers.
1.4.Quick start
Before reading the belows, it is highlyrecommended thatyou instal l thetwo Demoprograms(MiBox_SDK_Demo_Offl ineGame.apk and MiBox_SDK_Demo_Onl ineGame.apk)distributed with this document into MiTVor MiBox.Because the two programs demonstrate thewholeworkflowof xiaomi game SDK,and it ishelpful to understand ourSDKpayment flow.
2.Production Design and Implementation
2.1.Single Player Game
2.1.1 Flowof single playergame
Thedevelopersof single playergamesneed neitherto managethe users' login nor recordthe login status.Al l theyneed to do isto invokethe miUniPayOffl ine() nested in SDKwhenusers do the payments.SDK itself processes the logic of users' login, registration, insufficientmoney,purchased and so on.Atypical businessflowisasfol lows:
2.1.2 Position of game icons for MiBox and MiTV
Create fourdirectories in directory'res'of apk forthe two game icons(For MiBox and MiTV):
1.drawable-mdpi
2.d rawa ble-tvd pi
3.dawable-hdpi
4.drawable-xhdpi
Put the icon forMiTVin drawable-hdpi and drawable-xhdpi
Put the icon for MiBox in drawable-mdpi and drawable-tvdpi
2.1.3 SDKinvoke methods
Asfordevelopers,onlyneed to add thefol lowing codeto realizethe single playergamepayment.
2.1.3.1Initialize
Please obtain AppId and AppKey first, then invoke the following SDK initialization code to initialize theoperation.
Put MiGameCenterSDKService.apk of SDK package into the'assets'directory of application,and SDK's jarthe'libs', referenced in buildpath, then initialize SDK.(Note:Check whether the package name of the game is thesame with the package name of xiaomi server c onfiguration,whether the Appid and Appkey are c onsistent withthe applied. If not consistent, it would be failed when invoke login and other SDK interfaces.).
Init()method is invoked in Application.onCreate!
ThepermissionthatSDKneedstoadd:
2.1.3.2Invoke payment
2.1.3.2.1Code of Xiaomiaccount login
2.1.3.2.2 Consumable production(Production that can be re-purchased, such as blood bottleand magic bottle)
2.1.3.2.3 Non-consumable production(Production that cannot be re-purchased, such as gamelevel)
Parameter Description:
2.1.3.2.4 SDK's main entrance
SDK's main entrance adds customerservice,game forumsand guide functions(Pleasecontactusforthe location of main entrance.)
2.1.4 Server interface
If needed, itcould also provide the notification addressof receiving order payment resultforsingle playergames. Optional
2.1.4.1.Order notification interface
2.1.4.1.1 Process Description:
This interface isdeveloped bydeveloperand should be configuredin xiaomi game centerbefore releasing.
Aftersuccessful paymentof the order,xiaomi game centerwi l l notifythe developer'sserverprovided in advance with the payment result. If the developer's servercannot be accessed,within a certain period of time,game centerserverwould do the checking cycle(Theformer10times,notifying oncea minute; then oncean hour)
Specific procedures are as fol lows:
Note:Duetothe asynchronous notification model,(3)and(4)maynotfol lowthe sequence,so(4)and (5) need to be checked cycl ical ly,or use the interface to querythe payment result.
Compared to the later-mentioned developer'sactive queryordermode,we recommendusingthisone.
2.1.4.1.2Interface and Parameters Description
Interface address:each developer's server's notification address(Appl ied in advance,configured in xiaomi game center)
Request Parameter Description
Response Parameter Description
Note:Developers must guarantee that product be del ivered onlyonce forthe same order'smultiple notifications.
Interface Format Description
Request mode:HTTP GET
Input parameters: ?parameter1=value1¶meter2=value2&. ..¶meterN=valueN,
ZJI本月新上线了香港葵湾机房站群服务器,提供4个C段238个IPv4,支持使用8折优惠码,优惠后最低每月1400元起。ZJI是原Wordpress圈知名主机商家:维翔主机,成立于2011年,2018年9月更名为ZJI,提供中国香港、台湾、日本、美国独立服务器(自营/数据中心直营)租用及VDS、虚拟主机空间、域名注册等业务,所选数据中心均为国内普遍访问速度不错的机房。葵湾二型(4C站群)CPU:I...
totyun,新公司,主要运作香港vps、日本vps业务,接入cn2网络,不限制流量!VPS基于KVM虚拟,采用系统盘和数据盘分离,从4G内存开始支持Windows系统...大家注意下,网络分“Premium China”、“Global”,由于站长尚未测试,所以也还不清楚情况,有喜欢吃螃蟹的尝试过不妨告诉下站长。官方网站:https://totyun.com一次性5折优惠码:X4QTYVNB3P...
全球独立服务器、站群多IP服务器、VPS(哪个国家都有),香港、美国、日本、韩国、新加坡、越南、泰国、加拿大、英国、德国、法国等等99元起步,湘南科技郴州市湘南科技有限公司官方网址:www.xiangnankeji.cn产品内容:全球独立服务器、站群多IP服务器、VPS(哪个国家都有),香港、美国、日本、韩国、新加坡、越南、泰国、加拿大、英国、德国、法国等等99元起步,湘南科技VPS价格表:独立服...