魔兽世界API魔兽世界全局函数.docx

1、魔兽世界API魔兽世界全局函数魔兽世界API_魔兽世界全局函数 魔兽世界API魔兽世界全局函数帐号游戏时间范围函数 (Account PlayTime Limit Functions)此类API函数是专门为防沉迷系统而设计的，能计算出当前玩家游戏时间等内容，当前只在亚洲地区有效。 GetBillingTimeRested() - 返回当前帐户已登陆时间。 PartialPlayTime() - 如果用户状态为“疲劳（tired）”则返回1：降低经验及掉落。 NoPlayTime() - 如果用户状态为“不健康的（unhealthy）”则返回1：无经验及掉落。 -动作函数 (Action Fun

2、ctions)这些函数对动作按钮进行操作（通常玩家的动作有可能通过下面列表中的函数执行）。保护 界面 ActionButtonDown(id) - 按下指定动作按钮。保护 界面 ActionButtonUp(id) - 释放指定动作按钮。ActionHasRange(slot) - 检测指定动作按钮是否受距离限制 (是则返回 1，否则返回 nil) 。界面 BonusActionButtonDown - 触发指定额外动作按钮 (宠物或仆从)。界面 BonusActionButtonUp - 释放指定额外动作按钮 (宠物或仆从)。保护 CameraOrSelectOrMoveStart() -

3、在 3D 界面开始 "左键单击" 动作。 (1.10 - 保护)保护 CameraOrSelectOrMoveStop(stickyFlag) - 在 3D 界面结束 "左键单击" 动作。 (1.10 - 保护)ChangeActionBarPage() - 更改系统动作按钮页面为系统变量 CURRENT_ACTIONBAR_PAGE 指定页。GetActionBarToggles() - 获取系统动作条显示状况。GetActionCooldown(slot) - 获取指定动作按钮冷却状况。GetActionCount(slot) - 获取动作按钮所需物

4、品剩余量 (绷带/毒药/等)，无物品或不可用时返回 0。GetActionText(slot) - 获取动作按钮文本标签 (宏, 等)，不存在则返回 nil。GetActionTexture(slot) - 获取指定动作按钮材质路径。GetBonusBarOffset() - 检测何种额外动作条已显示。HasAction(slot) - 假如指定动作条按钮有技能执行，则返回 1，其他情况返回 nil。IsActionInRange(slot) - 测试技能是否在施展距离内 (1=是, 0=否, nil=不可用)。IsAttackAction(slot) - 技能为“攻击”动作则返回 1 (战斗

5、中闪光)， 其他情况返回 nil。IsAutoRepeatAction(slot) - 技能可自动重复时返回 1，其他情况返回 nil。IsCurrentAction(slot) - 技能动作正在执行时返回 1，其他情况返回 nil。IsUsableAction(slot) - 技能可立即执行时返回 1，其他情况返回 nil。IsConsumableAction(slot) - 技能有施展次数时返回 1 (例如：施法物品)，其他情况返回 nil。IsEquippedAction(slot) - 必须装备才能施展的技能返回 1 (例如：链接到必须装备的物品)，其他情况返回 nil。PetHasA

6、ctionBar() - 检测玩家宠物是否有动作条。PickupAction(slot) - 将指定动作按钮的技能提取并放置于光标上。PickupPetAction(slot) - 将指定的宠物动作按钮的 技能提取并放置于光标上。PlaceAction(slot) - 将鼠标上的技能放置于指定动作按钮。SetActionBarToggles(show1,show2,show3,show4, alwaysShow) - 设置指定系统动作条显示。 - 1.12 版本添加 'alwaysShow'。保护 TurnOrActionStart() - 在 3D 界面开始 "右键

7、单击" 动作。(1.10 - 保护)保护 TurnOrActionStop() - 在 3D 界面结束 "右键单击" 动作。 (1.10 - 保护)保护 UseAction(slot, checkCursor, onSelf) - 执行绑定到指定 ID 的动作按钮技能，可定向玩家 (与目标无关)。-行为函数 (Activity Functions)这个部分的函数会引发玩家角色的动作(未在别处加以保护, 非简单确认步骤) AcceptDuel() - 玩家同意接受决斗挑战.保护 AttackTarget() - 攻击选定目标.CancelDuel() - 拒绝决斗挑

8、战.CancelLogout()CancelMeetingStoneRequest() - 将角色从集合石队列中移除ClearTutorials()ConfirmSummon()保护 DescendStop() -增加于2.1Dismount() -增加于2.0.3FlagTutorial("tutotial")保护 ForceLogout()ForceQuit()GetSummonConfirmAreaName()GetSummonConfirmSummoner()GetSummonConfirmTimeLeft()Logout - 注销当前玩家角色.Quit - 退出应

9、用程序(游戏), 而非 LUA 脚本.RandomRoll(low, high) - 随机产生在两个(正整数)数值闭区间的整数.保护 SitStandOrDescendStart() - 切换玩家坐下/站立姿势.保护 StartDuel("name") - 向玩家发出决斗邀请(根据名字)TogglePVP() - 切换 PVP 状态ToggleSheath() - 拔出/收起武器.UseSoulstone() - 使用激活的灵魂石复活自己.-插件函数 (AddOn Functions)DisableAddOn(index or "AddOnName")

10、- 禁止某插件下次载入.DisableAllAddOns() - 禁止所有插件下次被载入.EnableAddOn(index or "AddOnName") - 在下次进程开启指定插件.EnableAllAddOns() - 在下次进程开启全部插件.GetAddOnDependencies(index or "AddOnName") - 取得插件依赖列表.GetAddOnInfo(index or "AddOnName") - 取得插件相关信息.GetAddOnMetadata(index or "name", &

11、quot;variable") - 从插件的TOC文件中获取标签内容(值)。GetNumAddOns() - 取得用户插件数量.IsAddOnLoaded(index or "AddOnName") - 指定插件已读取则返回 true.IsAddOnLoadOnDemand(index or "AddOnName") - 测试插件是否可动态载入.LoadAddOn(index or "AddOnName") - 发出动态载入插件读取请求.ResetDisabledAddOns() -竞技场函数(Arena Functions

12、)ArenaTeamInviteByName(teamIndex, playerName) - Invites the specified player to the specified arena team. ArenaTeamLeave(teamIndex) - Leaves the specified arena team. ArenaTeamRoster(teamIndex) - Sends a request to the server to request the most recen t information on a specific Arena Team that you

13、are in. ArenaTeamUninviteByName(teamIndex, playerName) - Removes the specified played from the specified arena team. ArenaTeamDisband(teamIndex) - Disbands the arena team without any warning! Requires you to be the leader of the team. (Known to be implemented as of 2.1.3, but may have existed before

14、). GetArenaCurrency() - Gets the amount of arena points a player currently has to spend. GetArenaTeam(teamIndex) - Returns information regarding the players arena team, nil if the player is not in the passed team GetArenaTeamRosterInfo(teamIndex, playerIndex) - Returns information regarding a player

15、 from the specified team, this requires a call to ArenaTeamRoster you only need to do this when the player logins in, UI reloads will not effect the return. GetNumArenaTeamMembers(teamIndex, showOffline) - Gets the number of arena team members, this requires a call to ArenaTeamRoster you only need t

16、o do this when the player logins in, UI reloads will not effect the return. GetBattlefieldTeamInfo(index) - Gets info about a registered Arena Team at the end of an arena match. GetCurrentArenaSeason() - Gets the current Arena season. IsActiveBattlefieldArena() - Returns true if in an Arena Match, a

17、lso Returns true for the second argument if it's a registered match. IsArenaTeamCaptain(teamIndex) - Returns a value based on whether the player is the arena team captain. IsBattlefieldArena() - Returns true if the battlemaster you're talking to can queue you for arenas -拍卖函数 (Auction Functi

18、ons)CalculateAuctionDeposit(runTime) - 返回当前指定持续时间拍卖物品的堆放信息 (单位:分钟).CanSendAuctionQuery() - 拍卖行搜索按钮可用时返回 1, 否则为 nil.CancelAuction(index) - 取消指定拍卖 (在物主列表).ClickAuctionSellItemButton() - 将当前 '拣起' 的物品放到 '拍卖' 栏.CloseAuctionHouse() - 关闭 (打开的) 拍卖窗口.GetAuctionHouseDepositRate() - 返回当前开启的拍卖窗口

19、内物品 含未显示 存放比例 (百分率) (可能根据 CalculateAuctionDeposit).GetAuctionInvTypes(classIndex, subclassIndex) - 返回物品的子类.GetAuctionItemClasses() - 返回拍卖物品的主分类.GetAuctionItemInfo("type", index) - 返回指定拍卖物品细节.GetAuctionItemLink("type", index) - 返回指定拍卖物品的 itemLink.GetAuctionItemSubClasses(classInde

20、x) - 返回拍卖物品种类次序的子类.GetAuctionItemTimeLeft("type", index) - 返回指定拍卖物品剩余时间状态.GetAuctionSellItemInfo() - 返回当前拍卖物品相关信息 (未选择为 nil).GetBidderAuctionItems(page) - (取得竞标人信息).GetNumAuctionItems("type") - 返回指定拍卖物品列表大小.GetOwnerAuctionItems(page) - (取得拍卖人信息).GetSelectedAuctionItem("type&

21、quot;) - 返回选择的拍卖物品索引 (1- 50), 未选择返回 0.IsAuctionSortReversed("type", "sort") - 指定拍卖物品的排列类型逆序排列时返回 1, 否则为 nil.PlaceAuctionBid("type", index, bid) - 对选择拍卖物品投标.QueryAuctionItems("name", minLevel, maxLevel, invTypeIndex, classIndex, subclassIndex, page, isUsable, q

22、ualityIndex) - (请求检索符合条件的物品).SetSelectedAuctionItem("type", index) - ?.SortAuctionItems("type", "sort") - 根据指定分栏对指定拍卖列表进行排序.StartAuction(minBid, buyoutPrice, runTime) - 开始拍卖 '创建拍卖' 面板内物品.界面 AuctionFrameAuctions.duration - 设置拍卖持续总计时间.-银行函数 (Bank Functions)BankBut

23、tonIDToInvSlotID(buttonID) - 以背包位置 ID 方式返回银行包裹位置 ID.CloseBankFrame() - 关闭 (打开的) 银行窗口. -RambleGetBankSlotCost(numSlots) - 返回购买下个银行包裹位置的价格. -RambleGetNumBankSlots() - 返回已购买银行包裹位置数量, 如果已购完返回特定标志.PurchaseSlot() - 购买一个空余的银行包裹位置.-战场函数 (Battlefield Functions)AcceptAreaSpiritHeal() - 接受灵魂治疗.CancelAreaSpirit

24、Heal() - 取消灵魂治疗.CanJoinBattlefieldAsGroup() - 玩家不能加入战场团队则返回 nil.AcceptBattlefieldPort(index, acceptFlag) - 接受或拒绝一个传送至战场的请求.CheckSpiritHealerDist() - 死亡时如果你在精神医者复活的范围内，返回true.CloseBattlefield() - 关闭候列战场窗口.GetHonorCurrency() - 获取当前荣誉值GetAreaSpiritHealerTime() - 返回距精神医者下一次释放复活的时间.GetBattlefieldEstimate

25、dWaitTime(index) - 返回战场队列估算的排队时间.GetBattlefieldFlagPosition(index) - 获得战场旗帜的位置.GetBattlefieldInfo(index) - 返回你最近打开队列窗口的战场的详细信息.GetBattlefieldInstanceExpiration() - 获取战场即将关闭的时间.GetBattlefieldInstanceInfo(index) - 获得战场的副本ID.GetBattlefieldInstanceRunTime() - 单位：毫秒, 返回本次战场已运行的时间. (似乎是从服务器上获取数据，因为它和time(

26、)函数并不同步)GetBattlefieldMapIconScale() - 调整在战场小地图上标记图标的比例.GetBattlefieldPortExpiration(index) - 获得对应战场传送的剩余时间.GetBattlefieldPosition(index) - 获取战场中与你不在同一小队或团队的玩家姓名与位置 .GetBattlefieldScore(index) - 获得一个玩家的战场分数.GetBattlefieldStatData(playerIndex, slotIndex) - 获取战场中某一个玩家某一分栏的详细信息 . (例如战歌峡谷的夺旗数)GetBattlef

27、ieldStatInfo(index) - 从战场记分板的指定分栏获取信息 .GetBattlefieldStatus(index) - 返回玩家所在或正 在队列中的战场的状态 .GetBattlefieldTimeWaited(index) - 获取玩家在战场队列中的时间 .GetBattlefieldWinner() - 获得战场中获胜者 .GetNumBattlefieldFlagPositions() - Get the number of flag positions available from GetBattlefieldFlagPosition().GetNumBattlefi

28、eldPositions() - Get the number of positions available from GetBattlefieldPosition().GetNumBattlefieldScores() - Returns the number of scores(players) listed in the battlefield scoreboard.GetNumBattlefieldStats() - Get the number of battleground specific columns.GetNumBattlefields() - Get the number

29、 of running battlefields for the last battleground queue window you opened.GetNumWorldStateUI() - 获取世界状态的UI数量GetSelectedBattlefield() - Get the selected battlefield to join first.GetWorldStateUIInfo(i) - Get score and flag status within a battlefield.JoinBattlefield(index, joinAs) - 加入战场队列 .LeaveBat

30、tlefield() - 离开战场.ReportPlayerIsPVPAFK("unit") - 获取当前战场中的一玩家是否AFKRequestBattlefieldPositions() - Request new data for GetBattlefieldPosition().RequestBattlefieldScoreData() - Request new data for GetBattlefieldScore().SetBattlefieldScoreFaction(faction) - Set the faction to show on the battlefield sc