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.

參數

名稱	類型	作用
`self`	`RMPlatform`	Rotation Master platform adapter (normally addon.Platform), used for its CanReadValue check.
`enabled`	`boolean`	The spell's isEnabled flag.
`active`	`boolean`	The spell's isActive flag.
`onGCD`	`boolean \| nil`	The spell's isOnGCD flag, when the client reports it.
`now`	`number`	Evaluation time in GetTime() seconds, used to test the global cooldown.

傳回值

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

版本

內建輔助函式在每個版本上都會註冊。不同的是它們讀取的遊戲 API；某個 API 不存在時，輔助函式會改用備用方式，或傳回 nil 並附上原因。

它不會直接讀取任何遊戲 API。

機密值（正式版與永久）

在正式版與永久上，遊戲交給插件的是機密值。此輔助函式會檢查它讀取的內容（addon.Platform:CanReadValue），遇到無法比較的機密值時，會傳回 nil 並附上原因（例如 restricted-value），而不是傳回該機密值。請將 nil 視為無法使用，而非假。

插件如何呼叫它

Platform.spells.IsSpellReady

return flagReadiness(self,enabled,active,onGCD,now)

相依項目

gcdRunning → Platform.spells.gcdRunning

原始碼

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"

返回函式參考