Conditions.common.Widget_GetSpellId

调用方式

addon:Widget_GetSpellId(spellid, ranked)

可直接通过 addon 使用，无需依赖项。

作用

解析条件中存储的法术标识符。启用精确等级时会保留所提供的 ID；否则在有等级的经典版客户端上，会通过法术目录解析当前已知的等级。无法完成解析时返回 nil 和可用性原因。

参数

名称	类型	作用
`self`	`RMAddon`	Rotation Master 插件实例（使用冒号调用时隐含传入）。
`spellid`	`number`	要解析的已存储法术 ID。
`ranked`	`boolean \| nil`	为 true 时要求使用这个确切的等级；为 false 或 nil 时跟随可用的等级。

返回值

1	`number \| nil`	解析后的法术 ID；不可用时为 nil。
2	`string \| nil`	解析失败时的可用性原因；成功时为 nil。

版本

内置辅助函数在每个版本上都会注册。不同的是它们读取的游戏 API；某个 API 缺失时，辅助函数会改用后备方案，或返回 nil 并附上原因。

它不直接读取任何游戏 API。

插件如何调用它

任意法术可用 (evaluate)

local spellid, reason = addon:Widget_GetSpellId(value.spell, value.ranked)

任意法术充能 (evaluate)

local spellid, reason = addon:Widget_GetSpellId(value.spell, value.ranked)

任意法术冷却 (evaluate)

local spellid, reason = addon:Widget_GetSpellId(value.spell, value.ranked)

任意法术在射程内 (evaluate)

local spellid, reason = addon:Widget_GetSpellId(value.spell, value.ranked)

任意法术充能时间 (evaluate)

local spellid, reason = addon:Widget_GetSpellId(value.spell, value.ranked)

战斗辅助循环法术 (evaluate)

local spellid, why = addon:Widget_GetSpellId(value.spell, value.ranked)

战斗辅助建议 (evaluate)

local spellid, why = addon:Widget_GetSpellId(value.spell, value.ranked)

宠物法术生效中或待生效 (evaluate)

local spellid, reason = addon:Widget_GetSpellId(value.spell, false)

以及另外 17 处: 宠物法术可用 (evaluate), 宠物法术充能 (evaluate), 宠物法术冷却 (evaluate), 宠物法术施放历史 (evaluate), 宠物法术施放历史时间 (evaluate), 宠物法术在射程内 (evaluate), 宠物法术充能时间 (evaluate), 法术生效中或待生效 (evaluate), 法术自动重复中 (evaluate), 法术可用 (evaluate), 法术充能 (evaluate), 法术冷却 (evaluate), 法术触发高亮 (evaluate), 法术施放历史 (evaluate), 法术施放历史时间 (evaluate), 法术在射程内 (evaluate), 法术充能时间 (evaluate)

依赖项

SpellData (builtin:Conditions/common.lua:SpellData)

源码

Conditions/common.lua，第 37 行。在游戏中为只读；“复制”会生成一份可编辑的副本。

Conditions.common.Widget_GetSpellId(self, spellid, ranked)

    if (WOW_PROJECT_ID ~= WOW_PROJECT_MAINLINE) then
        if not ranked then
            local resolved, reason = SpellData:GetSpellId(spellid)
            return resolved, reason or (not resolved and "spell-data-unavailable" or nil)
        end
    end
    return spellid

返回函数参考