魔兽世界API全局函数

### 魔兽世界API全局函数详解 #### 一、AccountPlayTimeLimitFunctions：账号游戏时间限制函数 这部分API主要用于管理玩家的游戏时间，包括获取已消耗的时间和剩余时间等。 - **GetBillingTimeRested()**：获取剩余的休息时间。在游戏内，玩家根据其订阅类型或购买的时间包可能会有一定的“休息时间”，这些时间不会被计为游戏时间。 - **PartialPlayTime()**：当玩家状态处于“疲劳”时（即部分时间消耗），返回1。通常这种情况下，玩家需要休息一段时间才能恢复正常的游戏速度。 - **NoPlayTime()**：如果玩家的状态为“不健康”时（即完全无法游戏），返回1。这可能是因为账户欠费、时间用尽等原因导致无法继续进行游戏。 #### 二、ActionFunctions：动作函数 这部分API主要与游戏内的快捷键、技能施放等操作有关。 - **ActionButtonDown(id)**：当按下某个快捷键时触发此函数。 - **ActionButtonUp(id)**：当释放某个快捷键时触发此函数。 - **ActionHasRange(slot)**：判断指定快捷键槽位上的技能是否具有施法范围。如果技能有施法范围，则返回true；反之则返回nil。 - **BonusActionButtonDown**：触发额外的快捷键按下事件。 - **BonusActionButtonUp**：触发额外的快捷键释放事件。 - **CameraOrSelectOrMoveStart()**：开启3D视角下的选择或移动操作。 - **CameraOrSelectOrMoveStop([stickyFlag])**：关闭3D视角下的选择或移动操作。可选参数stickyFlag用于控制是否保持当前状态。 - **ChangeActionBarPage()**：切换当前使用的快捷栏页面到系统默认的CURRENT_ACTIONBAR_PAGE页面。 - **GetActionBarToggles()**：获取快捷栏的显示状态。 - **GetActionCooldown(slot)**：获取指定快捷键槽位上技能的冷却时间。 - **GetActionCount(slot)**：获取指定快捷键槽位上的物品数量。如果是药水或其他消耗品，则会显示其数量；如果不是消耗品，则返回0。 - **GetActionText(slot)**：获取指定快捷键槽位上的技能或物品名称。 - **GetActionTexture(slot)**：获取指定快捷键槽位上技能或物品的图标纹理。 - **GetBonusBarOffset()**：获取额外快捷栏的偏移量。 - **HasAction(slot)**：检查指定快捷键槽位上是否有有效的技能或物品。如果有，则返回1；否则返回nil。 - **IsActionInRange(slot)**：判断指定快捷键槽位上的技能是否处于有效施法范围内。返回值1表示在范围内，0表示不在范围内，nil表示技能没有施法距离要求。 - **IsAttackAction(slot)**：判断指定快捷键槽位上的技能是否为攻击类技能。如果是，则返回1；否则返回nil。 - **IsAutoRepeatAction(slot)**：判断指定快捷键槽位上的技能是否支持自动重复施放。如果是，则返回1；否则返回nil。 - **IsCurrentAction(slot)**：判断指定快捷键槽位上的技能是否正在施放。如果是，则返回1；否则返回nil。 - **IsUsableAction(slot)**：判断指定快捷键槽位上的技能是否可以施放。如果是，则返回1；否则返回nil。 - **IsConsumableAction(slot)**：判断指定快捷键槽位上的物品是否为一次性消耗品（如药水）。如果是，则返回1；否则返回nil。 - **IsEquippedAction(slot)**：判断指定快捷键槽位上的技能是否关联了装备。如果是，则返回1；否则返回nil。 - **PetHasActionBar()**：检查宠物是否有自己的快捷栏。 - **PickupAction(slot)**：将指定快捷键槽位上的技能或物品拾取至背包。 - **PickupPetAction(slot)**：将指定宠物快捷键槽位上的技能或物品拾取至背包。 - **PlaceAction(slot)**：将指定物品放置于快捷键槽位。 - **SetActionBarToggles(show1, show2, show3, show4[, alwaysShow])**：设置快捷栏的显示状态。 - **TurnOrActionStart()**：开启3D视角下的转向或施法操作。 - **TurnOrActionStop()**：关闭3D视角下的转向或施法操作。 - **UseAction(slot[, checkCursor[, onSelf]])**：使用指定快捷键槽位上的技能或物品。checkCursor和onSelf是可选参数，分别用于判断是否使用光标指向的目标以及是否对自己施放技能。 #### 三、ActivityFunctions：活动函数 这部分API主要涉及到游戏中的各种活动，如决斗、退出游戏等。 - **AcceptDuel()**：接受决斗邀请。 - **AttackTarget()**：对目标发起攻击。 - **CancelDuel()**：取消决斗邀请。 - **CancelLogout()**：取消退出游戏的操作。 - **CancelMeetingStoneRequest()**：取消组队石的邀请请求。 - **ClearTutorials()**：清除教程提示。 - **ConfirmSummon()**：确认召唤请求。 - **DescendStop()**：停止下落（例如从飞行坐骑降落）。 - **Dismount()**：解除骑乘状态。 - **FlagTutorial("tutorial")**：标记特定的教程。 - **ForceLogout()**：强制退出游戏。 - **ForceQuit()**：强制关闭游戏客户端。 - **GetSummonConfirmAreaName()**：获取召唤确认区域的名称。 - **GetSummonConfirmSummoner()**：获取召唤者的姓名。 - **GetSummonConfirmTimeLeft()**：获取召唤确认剩余时间。 - **Logout()**：退出游戏。 - **Quit()**：退出游戏客户端。 - **RandomRoll(low, high)**：生成一个指定范围内的随机数字。 - **SitStandOrDescendStart()**：坐下或站立。 - **StartDuel("name")**：向指定玩家发起决斗邀请。 - **TogglePVP()**：切换PvP状态。 - **ToggleSheath()**：切换武器的收起或展示状态。 - **UseSoulstone()**：使用灵魂石复活自己。 #### 四、AddOnFunctions：插件函数 这部分API主要用于开发和管理游戏插件。 - **DisableAddOn(addonName)**：禁用指定插件。 - **EnableAddOn(addonName)**：启用指定插件。 - **LoadAddOn(addonName)**：加载指定插件。 - **UnloadAddOn(addonName)**：卸载指定插件。 - **RegisterEvent(event)**：注册监听特定的事件。 - **UnregisterEvent(event)**：取消注册特定的事件监听。 - **RegisterFrameForDrag(frame)**：注册帧以便进行拖动操作。 - **UnregisterFrameForDrag(frame)**：取消注册帧的拖动操作。 - **RegisterFrameForEvents(frame, eventList)**：注册帧以监听一系列事件。 - **UnregisterFrameForEvents(frame, eventList)**：取消注册帧的事件监听。 - **RegisterStateDriver(frame, driver)**：注册状态驱动器。 - **UnregisterStateDriver(frame, driver)**：取消注册状态驱动器。 - **RegisterUnitEvent(frame, unit, eventList)**：注册单位事件监听。 - **UnregisterUnitEvent(frame, unit, eventList)**：取消注册单位事件监听。 - **RegisterMessage(message)**：注册消息。 - **UnregisterMessage(message)**：取消注册消息。 - **SendChatMessage(message, type, language, target)**：发送聊天消息。 - **SendAddonMessage(message, prefix, target)**：发送插件消息。 - **GetCVar(cvarName)**：获取指定的客户端变量。 - **SetCVar(cvarName, value)**：设置指定的客户端变量。 - **GetNumAddOns()**：获取已安装插件的数量。 - **GetAddOnInfo(index)**：获取指定索引处插件的信息。 - **GetAddOnMetadata(addonName, metadataKey)**：获取插件的元数据。 - **GetAddOnOption(addonName, optionName)**：获取插件选项的值。 - **GetAddOnVersion(addonName)**：获取插件版本号。 - **SetAddOnOption(addonName, optionName, optionValue)**：设置插件选项的值。 通过上述API全局函数的详细介绍，我们可以看到魔兽世界的API涵盖了游戏中非常广泛的方面，无论是从游戏时间管理、快捷键技能操作、游戏活动还是插件开发等方面都提供了丰富的功能。这对于游戏开发者和插件制作者来说都是非常宝贵的资源。