参考 › 函数参考 › Platform

Platform.spells.flagReadiness

依赖项

调用方式

Platform.spells.flagReadiness(self, enabled, active, onGCD, now)

记录依赖项 Platform.spells.flagReadiness,然后按该名称调用。带命名空间的调用不会传入 self:请使用冒号调用,或自行传入该对象。

作用

Decides cooldown readiness from the never-secret flags when the cooldown times are hidden. Returns false when the cooldown is disabled, true when no cooldown is active, false when the active cooldown is known not to be the global cooldown or the global cooldown is known not to be running, and true when the active cooldown is the global cooldown; otherwise nil with a reason.

参数

名称类型作用
selfRMPlatformRotation Master platform adapter (normally addon.Platform), used for its CanReadValue check.
enabledbooleanThe spell's isEnabled flag.
activebooleanThe spell's isActive flag.
onGCDboolean | nilThe spell's isOnGCD flag, when the client reports it.
nownumberEvaluation time in GetTime() seconds, used to test the global cooldown.

返回值

1boolean | nilTrue when ready by the end of the global cooldown, false when not; nil when it cannot be decided.
2string | nilThe global cooldown reason, or restricted-value, when the result is nil.

版本

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

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

秘密值(正式服和永久服)

在正式服和永久服上,游戏交给插件的是秘密值。此辅助函数会检查它读取的内容(addon.Platform:CanReadValue),遇到无法比较的秘密值时返回 nil 并附上原因(例如 restricted-value),而不是返回该秘密值。请将 nil 视为不可用,而不是假。

插件如何调用它

依赖项

源码

Platform/spells.lua,第 556 行。在游戏中为只读;“复制”会生成一份可编辑的副本。

Platform.spells.flagReadiness(self, enabled, active, onGCD, now)
    if not enabled then return false end
    if not active then return true end
    if onGCD==false then return false end
    local running,why=gcdRunning(self,now)
    if running==false then return false end
    if onGCD==true then return true end
    return nil,why or "restricted-value"

返回函数参考