Diablo3英雄榜-API分析
Diablo3英雄榜-API分析
概述
暗黑3API 是暴雪提供的用来给游戏爱好者提供英雄和资料查询的工具。玩家可以在线下在社区应用中扩展游戏体验。
这篇文章是写在UI篇之后的,但是由于UI篇还没有完成。实际上我的流程是UI->逻辑->数据。在UI的过程中需要很多数据,设计到美观问题,尤其是装备这块。我打算先把装备这块的数据先分析出来。
角色档案
访问账户信息级别的信息需要使用角色档案API。这个档案通过一个HTTP GET request返回一个dataset。访问的方式如下:
battletag-name ::= <regional battletag allowed characters>
battletag-code ::= <integer>
url ::= <host> "/api/d3/profile/" <battletag-name> "-" <battletag-code> "/"
这里的battletag-name就是游戏里面的账号名称,battletag-code就是游戏里面跟随的#数字。比如:
http://tw.battle.net/api/d3/profile/kakyban-3879/
这里会得到账号下的游戏ID列表之类的数据。在这个例子里host为tw.battle.net。内容大概如下所示的Json内容:
HTTP/1.1200 OK
<http headers>
{"heroes": [{"name": "Yharr", "id": 1, ...}, ...], ...}
具体的可以直接访问我给出的例子。这都是真实的数据。
英雄档案
英雄档案就是所玩的角色的ID,比如说练了个法师,那么就是那个法师的档案。英雄档案API一次同伙一个HTTP GET请求获得一个英雄的资源文件。
battletag-name ::= <regional battletag allowed characters>
battletag-code ::= <integer>
hero-id ::= <integer>
url ::= <host> "/api/d3/profile/" <battletag-name> "-" <battletag-code> "/hero/" <hero-id>
这里的hero-id是上一级的json数据里的id。那么访问一个英雄的api大概如下:
http://tw.battle.net/api/d3/profile/kakyban-3879/hero/26135206
得到的json数据大概如下:
HTTP/1.1200 OK
<http headers>
{ "id" : 1, "name" : "Yharr", "class" : "barbarian", "gender" : 0, "level" : 54, "hardcore" : false, ... }
也就是说先要调用角色档案API得到账号下角色的id号,然后在通过id得到每个id的角色详细信息。角色的详细信息里面就包含了id,名称,职业,性别,等级,巅峰等级,装备列表,技能列表,追随者列表等。
装备详细信息
装备详细信息是通过调用items属性下的tooltipParams
url ::= <host> "/api/d3/data/item/" <item-data>
比如这样子,就是这个角色身上穿的头盔的API。得到大概下面的内容:
HTTP/1.1200 OK
<http headers>
{ "name": "Exsanguinating Chopsword of Assault", "icon": "mightyweapon1h_202", "displayColor": "blue", "requiredLevel": 60, "itemLevel": 61, "bonusAffixes": 0, ... }
追随者信息
追随者的格式如下:
follower-type ::= "enchantress" | "templar" | "scoundrel"
url ::= <host> "/api/d3/data/follower/" < follower-type>
得到的内容大概如下:
HTTP/1.1200 OK
<http headers>
{ "slug": "scoundrel", "name": "Scoundrel", "portrait": "scoundrel", "skills": { "active": [ { "slug": "crippling-shot", "name": "Crippling Shot", ...}, ...], ... }, ... }
最后补充:
如何得到物品的图片列,比如在物品信息API或者英雄API的items属性里有一个icons的属性。比如那个角色的头盔的icon为unique_helm_set_05_x1_demonhunter_male,那么他的API就是
http://media.blizzard.com/d3/icons/items/small/unique_helm_set_05_x1_demonhunter_male.png
http://media.blizzard.com/d3/icons/items/large/unique_helm_set_05_x1_demonhunter_male.png
如何得到装备的数据
在得到Json的字符串以后,我们可以通过Gson转换成为Mapping,如下面的代码
Map<String, Object> mProfile ;
……
Gson gson = new Gson();
mProfile = gson.fromJson(response, new TypeToken<Map<String,Object>>(){}.getType());
在这里一定一定要注意,不要意图直接把字符串转换成对象。因为暴雪的api并不是非常的严谨。在Rest里面,职业的id是class也就是说保留字冲突。还用到了一些其他的符号,比如说"-"。
如上的图片,请大家不要做,完全没有啥意义。说起来满脸都是泪啊。