模块:舰娘函数/doc

来自舰娘百科
跳转至: 导航搜索

这是模块:舰娘函数的文档页面

舰娘函数 API参考指南

请勿调用尚未实现的方法。 警告:这个模块不会对非法参数进行特殊错误处理,请确保参数合法。

已经实现的方法

getSpDataById

根据请求的舰船id和属性名称,返回符合搜索条件的第一个值。id为kcwiki ID(非改装船维持不变,改装船为原船+一位字母表示科技等级改修等级)。

调用格式:
{{#invoke:舰娘函数|getSpDataById|舰船编号|属性名1|属性名2|衍生等级}}
调用示例:
{{#invoke:舰娘函数|getSpDataById|131|数据|火力|2}}

调用示例的返回值:

 129

参数合法值:

 舰船编号:
   请求的舰船的ID。必须为数字。
   ID必须为3位数,或3位数+1个小写字母的形式。例如:080a
   具体舰船对应编号请参考 > http://zh.kcwiki.moe/wiki/%E6%A8%A1%E5%9D%97:%E8%88%B0%E5%A8%98%E6%95%B0%E6%8D%AE
 属性名1:
   可以是ID、图鉴号、日文名、假名、中文名、舰种、级别、类别、搭载、数据、装备、获得、消耗、改修、解体、改装、画师、声优、入手方式。
   类别是舰种+级别数据的计算后结果。例如,{{#invoke:舰娘函数|getSpDataById|131|类别}}的返回值为:大和型 / 一番舰 / 战列舰
   搭载是舰船所能搭载的最大飞机数量。
 属性名2:
   若属性名1为级别,可以是1或2。1对应型号,2对应番号,均为Raw data。若要获取计算后的结果请使用"类别"。
   若属性名1为数据,可以是耐久、火力、雷装、对空、装甲、对潜、回避、索敌、运、速力、射程、稀有度。
   若属性名1为装备,可以是格数、搭载、初期装备。
   若属性名1为获得,可以是改造、建造、掉落、时间。
   若属性名1为消耗,可以是燃料、弹药。
   若属性名1为改修,可以是火力、雷装、对空、装甲。
   若属性名1为解体,可以是燃料、弹药、钢材、铝。
   若属性名1为改装,可以是等级、弹药、钢材、改装前、改装后。
 衍生等级:
   将最后一个参数取名为衍生等级并没有什么特别的意义,完全是作者eve中毒的结果(
   若属性名1为数据,衍生等级为1返回初始属性,衍生等级为2返回最大强化时的属性。不适用于速力、射程和稀有度。
   若属性名1为装备,衍生等级数用于指定插槽。例如,衍生等级2指第二装备插槽。不适用于插槽数(格数)本身。
 ps:
   如果舰船的某个装备格不能安装装备,则请求装备时返回空字符串。如果某个装备格完全不能搭载飞机,则请求搭载数时返回空字符串。

返回值的具体含义请参考:http://zh.kcwiki.moe/wiki/%E6%A8%A1%E5%9D%97:%E8%88%B0%E5%A8%98%E6%95%B0%E6%8D%AE

尚未实现的方法

这里列出已在队列中但是还没有填完的坑。请勿使用它们。

getSpById

根据请求的舰船ID,返回符合搜索条件的第一个值。id为图鉴ID。 已知问题:

 数据存储格式有问题,此模块暂时无法应用于所有舰船。
 数据输出存在问题,尚未成功找到问题所在。
调用格式:
{{#invoke:舰娘函数|getSpById|舰船ID}}
调用示例:
{{#invoke:舰娘函数|getSpById|1}}

调用示例的返回值:

 Lua错误 模块:舰娘函数的第186行:attempt to index field '?' (a nil value)

参数合法值:

 任意合法的舰船ID均可,无须补0。


getSpDataByFilter

根据请求的舰船类型,返回符合过滤条件的所有舰船的可排序属性列表。

调用格式:
{{#invoke:舰娘函数|getSpDataByFilter|舰船类型}}
调用示例:
{{#invoke:舰娘函数|getSpDataByFilter|战列舰}}

调用示例的返回值:

 <待补完>{{#invoke:舰娘函数|getSpDataByFilter|战列舰}}

参数合法值:

 <待补完>

Source code