Platform.spells.cooldownValues

Appel

Platform.spells.cooldownValues(self, spell)

Enregistrez la dépendance Platform.spells.cooldownValues, puis appelez-la sous ce nom. Un appel par espace de noms ne transmet pas self : utilisez un appel avec deux-points ou passez l'objet vous-même.

Ce qu'elle fait

Reads a spell cooldown as separate values for the readiness checks. When the platform is marked secretsUnrestricted and the legacy GetSpellCooldown exists it calls that directly; otherwise it uses addon.Platform:GetSpellCooldown, passing along its never-secret flags when the times are restricted.

Arguments

Nom	Type	Ce qu'elle fait
`self`	`RMPlatform`	Rotation Master platform adapter (normally addon.Platform), used for its CanReadValue check.
`spell`	`number \| string`	Spell ID or client-recognized spell name.

Retours

1	`number \| nil`	Cooldown start time in GetTime() seconds; nil when unavailable.
2	`number \| nil`	Cooldown duration in seconds; nil when unavailable.
3	`boolean \| nil`	Whether the cooldown is enabled; when the times are unavailable, the never-secret isEnabled flag if it could be read.
4	`string \| nil`	Reason when the times are unavailable.
5	`boolean \| nil`	With restricted-value from GetSpellCooldown only: isActive.
6	`boolean \| nil`	With restricted-value from GetSpellCooldown only: isOnGCD; may be nil.

Éditions

Les fonctions utilitaires intégrées sont enregistrées sur toutes les éditions. Ce qui diffère, c'est l'API du jeu qu'elles lisent ; quand l'une manque, la fonction utilitaire se rabat sur une alternative ou renvoie nil avec une raison.

Indisponible sur cette édition (la raison figure dans l'infobulle)
Uniquement tant que les solutions de repli de Blizzard pour les fonctions obsolètes sont actives

API du jeu
`GetSpellCooldown`

Valeurs secrètes (Retail et Forever)

Sur Retail et Forever, le jeu transmet aux addons des valeurs secrètes. Cette fonction utilitaire vérifie ce qu'elle lit (addon.Platform:CanReadValue) et renvoie nil avec une raison telle que restricted-value au lieu d'une valeur secrète qu'elle ne peut pas comparer. Traitez nil comme indisponible, pas comme false.

Comment l'addon l'appelle

Platform.spells.IsSpellReady

local start,duration,enabled,reason,active,onGCD=cooldownValues(self,spell)

Platform.spells.gcdRunning

local start,duration,enabled,why,active=cooldownValues(self,gcdSpell)

Dépendances

finiteNonNegative → Platform.spells.finiteNonNegative
identifier → Platform.spells.identifier

Source

Platform/spells.lua, ligne 507. En lecture seule dans le jeu ; Dupliquer crée une copie modifiable.

Platform.spells.cooldownValues(self, spell)

    local legacy=self.secretsUnrestricted and GetSpellCooldown
    if type(legacy)~="function" then
        local cooldown,reason,enabled,active,onGCD=self:GetSpellCooldown(spell)
        if not cooldown then return nil,nil,enabled,reason,active,onGCD end
        return cooldown.startTime,cooldown.duration,cooldown.isEnabled
    end
    local valid,reason=identifier(spell)
    if not valid then return nil,nil,nil,reason end
    local ok,start,duration,enabled=pcall(legacy,spell)
    if not ok then return nil,nil,nil,"api-error" end
    if not self:CanReadValue(start) or not self:CanReadValue(duration) or not self:CanReadValue(enabled) then
        return nil,nil,nil,"restricted-value"
    end
    if start==nil then return nil,nil,nil,"spell-data-unavailable" end
    if enabled~=0 and enabled~=1 and enabled~=true and enabled~=false then return nil,nil,nil,"invalid-api-result" end
    if not finiteNonNegative(start) or not finiteNonNegative(duration) then return nil,nil,nil,"invalid-api-result" end
    return start,duration,enabled==1 or enabled==true

Retour à Référence des fonctions