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>

 

http://tw.battle.net/api/d3/data/item/CogBCIL4qLcOEgcIBBVToDKJHXKOHSEdOLLA1R2bBgDLHeZqMcAdZiMGUB2BgcbEMIsCOPYCQABQElgEYPYCaisKDAgAEM7b0OiFgIDAFhIbCMqDpcEMEgcIBBWFJ5SxMIsCOABAAVgEkAEAgAFGpQHmajHArQHmFdsNtQF_-U5duAGvr47ICcABIRjZ_ursDlACWACgAdn-6uwOoAGZgPvhDqAB5qDfkwagAbrehKsP

 

好比这样子，就是这个角色身上穿的头盔的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也就是说保留字冲突。还用到了一些其余的符号，好比说"-"。

如上的图片，请你们不要作，彻底没有啥意义。提及来满脸都是泪啊。