Platform.spells.IsSpellReady

Llamar como

addon.Platform:IsSpellReady(spell, now)

Disponible directamente a través de addon; no hace falta ninguna dependencia.

Qué hace

Comprueba si un hechizo se puede recomendar ahora, permitiendo un hechizo cuyo tiempo de reutilización restante termine con el tiempo de reutilización global actual. En Retail y Forever, donde los tiempos de reutilización son secretos en combate, la disponibilidad se obtiene en su lugar de los indicadores isEnabled, isActive e isOnGCD, que nunca son secretos. Solo comprueba la disponibilidad del tiempo de reutilización; no comprueba si está aprendido, el alcance ni si hay recursos para usarlo. Pasa el momento de evaluación desde evalStart o GetTime().

Argumentos

Nombre	Tipo	Qué hace
`self`	`RMPlatform`	Adaptador de plataforma de Rotation Master. Una referencia con punto requiere addon.Platform como primer argumento; una llamada con dos puntos lo proporciona de forma implícita.
`spell`	`number \| string`	ID de hechizo o nombre de hechizo reconocido por el cliente cuyo tiempo de reutilización se debe comprobar.
`now`	`number`	Momento de evaluación actual en segundos según GetTime(), normalmente evalStart.

Retornos

1	`boolean \| nil`	True si está listo al final del tiempo de reutilización global; false si su propio tiempo de reutilización impide recomendarlo; nil si el cliente no puede proporcionar un resultado legible.
2	`string \| nil`	Motivo de disponibilidad o de validación cuando el resultado es nil.

Ediciones

Las funciones auxiliares integradas se registran en todas las ediciones. Lo que cambia es la API del juego que leen; donde falta alguna, la función auxiliar recurre a una alternativa o devuelve nil con un motivo.

No disponible en esa edición (el motivo aparece en la información emergente)
Solo mientras estén activas las alternativas de Blizzard para API obsoletas

API del juego
`GetTime`

Valores secretos (Retail y Forever)

En Retail y Forever, el juego entrega a los addons valores secretos. Esta función auxiliar comprueba lo que lee (addon.Platform:CanReadValue) y, en lugar de un secreto que no puede comparar, devuelve nil con un motivo como restricted-value. Trata nil como no disponible, no como falso.

Ejemplo

local ready = addon.Platform:IsSpellReady(value.spell, evalStart)
if ready == nil then return nil end
return ready

Dependencias

cooldownValues → Platform.spells.cooldownValues
flagReadiness → Platform.spells.flagReadiness
gcdSpell (builtin:Platform/spells.lua:gcdSpell)

Código fuente

Platform/spells.lua, línea 575. Solo lectura en el juego; Duplicar crea una copia editable.

Platform.spells.IsSpellReady(self, spell, now)

    if not self:CanReadValue(now) then return nil, "restricted-value" end
    if type(now)~="number" or now~=now or now==math.huge or now==-math.huge then
        return nil, "invalid-time"
    end
    local start,duration,enabled,reason,active,onGCD=cooldownValues(self,spell)
    if start==nil then
        if active==nil then return nil,reason end
        return flagReadiness(self,enabled,active,onGCD,now)
    end
    if not enabled then return false end
    local expires=start+duration
    if duration==0 or expires<=now then return true end

    if not gcdSpell then self:GetGlobalCooldown() end
    local gcdStart,gcdDuration,gcdEnabled,why,gcdActive=cooldownValues(self,gcdSpell)
    if gcdStart==nil then
        -- The GCD's times are hidden: one known not to be running cannot
        -- cover this spell's own, still running, cooldown.
        if gcdActive~=nil and (not gcdEnabled or not gcdActive) then return false end
        return nil,why
    end
    if not gcdEnabled or gcdDuration==0 then return false end
    -- modRate controls cooldown animation; API timestamps/duration already
    -- describe expiration in GetTime seconds, so do not divide them by it.
    local gcdExpires=gcdStart+gcdDuration
    return gcdExpires>now and expires<=gcdExpires+0.001

Volver a Referencia de funciones