泰坦API储藏室for WOW1.12----20170214

老血

简介
这是一个为实现WoW自动化提供有关物品功能的库，例如获取物品信息，使用物品等。
默认名字空间：SR

数据类型
本库定义了以下数据类型。

item (string | number)
物品数据库链接或ID。

regenInfo (table)
包含恢复型物品的相关信息，包含以下字段：

Type (string)：恢复型物品的类型，包括"Health"（恢复生命值）和"Mana"（恢复法力值）。
Bag (number)：恢复型物品所位于的背包ID。
ContainerSlot (number)：恢复型物品所位于的背包格子ID。
Index (number)：恢复型物品所位于的商人格子序号。
StackCount (number)：恢复型物品堆叠的数量。
RegenSeconds (number)：恢复型物品的持续秒数。
RegenAmount (number)：恢复型物品的回复量。
itemType1 (string)
显示在左侧的物品类型，包括"Head", "Shoulder", "Chest", "Waist", "Legs", "Feet", "Wrist", "Hands", "Neck", "Back", "Shirt", "Ring", "Trinket", "OneHand", "MainHand", "OffHand", "OffHandFrills", "TwoHand", "Ranged"和"Projectile"。

itemType2 (string)
显示在右侧的物品类型，包括"Cloth", "Leather", "Mail", "Plate", "Dagger", "Axe", "Mace", "Sword", "Polearm", "Staff", "Bow", "Crossbow", "Gun", "Wand"和"Arrow"。

print(...) - 打印变量
在聊天框打印变量值，最多支持9个参数。

count = GetContainerFreeSlotCount() - 获取背包空格数
获取当前角色身上背包的空余格数。

返回
count (number)：背包的空余格数。
facing = GetDirectionBetweenPositions(position1, position2) - 获取坐标之间的朝向
获取从坐标1到坐标2的面向角的弧度。

参数
position1 (unitId | position)：坐标1。
position2 (unitId | position)：坐标2。
返回
facing (number)：面向角的弧度（0 ~ 2 * math.pi）。
result = IsItemUsable(item) - 判断物品是否可用
判断指定物品是否可用。

参数
item (number or string)：物品数据库ID或名字。
返回
result (boolean)：该物品是否可用。
result = IsMerchantOpened() - 判断商人窗口
检查商人窗口是否已经打开。

返回
result (boolean)：商人窗口是否已经打开。
id, name, quality = GetItemInfoFromLink(link) - 从物品链接获取信息
获取指定物品链接中包含的信息。

参数
link (string)：物品链接。
返回
id (number)：物品数据库ID。
name (string)：物品名称。
quality (number)：物品品质等级（0-灰，1-白，2-绿，3-蓝，4-紫，5-橙）。
leftLines, rightLines = GetItemDescriptionLines(item) - 获取物品鼠标提示文字
获取指定物品的鼠标提示描述的文本行。

参数
item (item)：物品链接或者ID。
返回
leftLines (string[])：显示在鼠标提示左列的文本行。如果物品不存在或者没有描述，则返回NIL。
leftLines (string[])：显示在鼠标提示右列的文本行。如果物品不存在或者没有描述，则返回NIL。
durabilityRate = GetLowestInventoryItemDurabilityRate() - 获取最低持久度
获取身上装备物品最低持久度比率。

返回
durabilityRate (number)：身上装备物品最低的持久度比率（0 - 1）。
regenInfo = GetContainerItemRegenInfo(bag, containerSlot[, minRegenAmountPerSecond]) - 获取背包中的指定恢复型物品
获取背包中指定物品的恢复信息。

参数
bag (number)：背包编号（0 - 4）。
containerSlot (number)：背包中的格子编号。
minRegenAmountPerSecond (number) (默认：nil)：每秒恢复值下限。
返回
regenInfo (regenInfo)：物品的恢复信息。如果物品不存在或者不是一个恢复型物品，则返回NIL。
regenInfo = GetContainerItemRegenInfo(index[, minRegenAmountPerSecond]) - 获取商人中的指定恢复型物品
获取商人中指定物品的恢复信息。

参数
index (number)：商人中的格子编号。
minRegenAmountPerSecond (number) (默认：nil)：每秒恢复值下限。
返回
regenInfo (regenInfo)：物品的恢复信息。如果物品不存在或者不是一个恢复型物品，则返回NIL。
potionInfo = GetContainerItemPotionInfo(bag, containerSlot[, minPotionAmount]) - 获取背包中的指定药品型物品
获取背包中指定物品的药品信息。

参数
bag (number)：背包编号（0 - 4）。
containerSlot (number)：背包中的格子编号。
minPotionAmount (number) (默认：nil)：恢复值下限。
返回
potionInfo (potionInfo)：物品的药品信息。如果物品不存在或者不是一个药品型物品，则返回NIL。
potionInfo = GetContainerItemPotionInfo(index[, minPotionAmount]) - 获取商人中的指定药品型物品
获取商人中指定物品的药品信息。

参数
index (number)：商人中的格子编号。
minPotionAmount (number) (默认：nil)：恢复值下限。
返回
potionInfo (potionInfo)：物品的药品信息。如果物品不存在或者不是一个药品型物品，则返回NIL。
stats = GetItemStats(item) - 获取物品的装备属性
获取指定物品的装备属性。

参数
item (item)：该物品。
返回
stats (table)：物品的属性表，包括字段"Strength" (number), "Agility" (number), "Stamina" (number), "Intellect" (number), "Spirit" (number), "Armor" (number), "RequiresLevel" (number), "DamagePerSecond" (number), "Type1" (itemType1), "Type2" (itemType2) 和 "Speed" (number)。
found, inventorySlotId, containerLocations = FindItem(item) - 寻找身上的物品
在角色身上寻找指定物品，包括已装备和背包中的。

参数
item (item)：物品数据库ID或名字。
返回
found (boolean)：是否找到该物品。
inventorySlotId (number)：如果已装备，则返回物品栏ID。有了这个，可以调用暴雪GetInventoryXXX系列API。
containerLocations (containerLocation[])：如果在背包中，则返回背包中的位置数组。containerLocation也是一个数组，由两个元素组成：[1]=BagID，[2]=ContainerSlotID。有了这个，可以调用暴雪GetContainerXXX系列API。
containerItemsForHealthRegen, containerItemsForManaRegen = FindRegenItemsInContainer([minRegenAmountPerSecond]) - 寻找背包中的恢复型物品
在背包中寻找所有的恢复型物品。

参数
minRegenAmountPerSecond (number) (默认：nil)：每秒恢复值下限。
返回
containerItemsForHealthRegen (regenInfo[])：背包中的所有恢复生命值物品。
containerItemsForManaRegen (regenInfo[])：背包中的所有恢复法力值物品。
containerItemsForHealthRegen, containerItemsForManaRegen = FindRegenItemsInContainer([minRegenAmountPerSecond]) - 寻找商人中的恢复型物品
在商人中寻找所有的恢复型物品。

参数
minRegenAmountPerSecond (number) (默认：nil)：每秒恢复值下限。
返回
containerItemsForHealthRegen (regenInfo[])：商人中的所有恢复生命值物品。
containerItemsForManaRegen (regenInfo[])：商人中的所有恢复法力值物品。
containerItemsForHealthPotion, containerItemsForManaPotion = FindPotionItemsInContainer([minPotionAmount]) - 寻找背包中的药品型物品
在背包中寻找所有的药品型物品。

参数
minPotionAmount (number) (默认：nil)：恢复值下限。
返回
containerItemsForHealthPotion (potionInfo[])：背包中的所有恢复生命值药品。
containerItemsForManaPotion (potionInfo[])：背包中的所有恢复法力值药品。
containerItemsForHealthPotion, containerItemsForManaPotion = FindPotionItemsInContainer([minPotionAmount]) - 寻找商人中的药品型物品
在商人中寻找所有的药品型物品。

参数
minPotionAmount (number) (默认：nil)：恢复值下限。
返回
containerItemsForHealthPotion (potionInfo[])：商人中的所有恢复生命值药品。
count = GetRegenOrPotionItemCount(regenOrPotionItems) - 获取物品总数
获取恢复型或药品型物品的总个数。

参数
regenOrPotionItems (regenInfo[] | potionInfo[])：恢复型物品数组或药品型物品数组。
返回
count (number)：物品总个数。
allSold = SellJunk({HighestQuality = highestQuality, MustKeptItems = mustKeptItems, MustSoldItems = mustSoldItems, MustKeptHealthRegenItemsMinAmount = mustKeptHealthRegenItemsMinAmount, MustKeptManaRegenItemsMinAmount = mustKeptManaRegenItemsMinAmount, MustKeptHealthPotionItemsMinAmount = mustKeptHealthPotionItemsMinAmount, MustKeptManaPotionItemsMinAmount = mustKeptManaPotionItemsMinAmount) - 卖垃圾
售卖背包中的所有垃圾。

参数
highestQuality (number)：垃圾的最高品质。
mustKeptItems (string[])：必须保留的物品名称数组。
mustSoldItems (string[])：必须出售的物品名称数组。
mustKeptHealthRegenItemsMinAmount (number)：必须保留的恢复生命物品的最小每秒恢复值，nil则不做特殊保留。
mustKeptManaRegenItemsMinAmount (number)：必须保留的恢复魔法物品的最小每秒恢复值，nil则不做特殊保留。
mustKeptHealthPotionItemsMinAmount (number)：必须保留的恢复生命药品的最小每秒恢复值，nil则不做特殊保留。
mustKeptManaPotionItemsMinAmount (number)：必须保留的恢复魔法药品的最小每秒恢复值，nil则不做特殊保留。
返回
allSold (boolean)：垃圾是否已经全部卖完了。
allBought = BuyRegenItems(healthRegenItemCount, manaRegenItemCount) - 购买恢复型物品
从当前商人购买恢复型物品。

参数
healthRegenItemCount (number)：背包中持有的生命回复物品的目标数额。（比如已有5个，目标20个，那么就要购买15个）。
manaRegenItemCount (number)：背包中持有的法力回复物品的目标数额。（比如已有5个，目标20个，那么就要购买15个）。
返回
allSold (boolean)：物品是否已经全部买完了。
UseItem(item[, onSelf]) - 使用物品
使用指定物品。

参数
item (number or string)：物品数据库ID或名字。
onSelf (boolean) (默认：false）：是否用在自己身上。