Platform.runes.GetRuneCooldownObservation

Chame como

addon.Platform:GetRuneCooldownObservation(index)

Disponível diretamente por meio de addon; nenhuma dependência é necessária.

O que faz

Lê uma tupla protegida de GetRuneCooldown para um espaço nativo exato. Normaliza ready, start e duration de forma independente: ready exige um booleano legível, e cada tempo exige um número finito legível e preserva valores com sinal, fracionários e zero. Cada campo indisponível tem o próprio motivo. Uma tupla vazia bem-sucedida gera um registro parcial; falta de capacidade, política ou falha da chamada nativa gera nil. Nunca deduz ready a partir dos tempos nem os tempos a partir de ready. Guarde este registro completo em cache em quem chama para compartilhar uma observação entre os predicados de contagem de runas e de tempo de recarga.

Argumentos

Nome	Tipo	O que faz
`self`	`RMPlatform`	Adaptador de plataforma do Rotation Master (implícito nas chamadas com dois-pontos).
`index`	`number`	Espaço de runa nativo inteiro exato, de 1 a 6.

Retornos

1	`table \| nil`	Registro parcial contendo ready ou readyReason, start ou startReason, e duration ou durationReason; nil apenas quando a própria consulta está indisponível.
2	`string \| nil`	Motivo de disponibilidade da política, da validação do espaço, da capacidade ou da chamada nativa para um registro nil.

Edições

As funções auxiliares integradas são registradas em todas as edições. O que muda é a API do jogo que elas leem; quando uma está ausente, a função auxiliar recorre a uma alternativa ou retorna nil com um motivo.

Indisponível nessa edição (o motivo está na dica)
Só enquanto as alternativas da Blizzard para APIs obsoletas estiverem ativas

API do jogo
`GetRuneCooldown`

Valores secretos (Retail e Forever)

No Retail e no Forever, o jogo entrega valores secretos aos addons. Esta função auxiliar verifica o que lê (addon.Platform:CanReadValue) e retorna nil com um motivo como restricted-value em vez de um valor secreto que não consegue comparar. Trate nil como indisponível, não como false.

Exemplo

local rune = addon.Platform:GetRuneCooldownObservation(1)
if not rune or rune.ready == nil then return nil end
return rune.ready

Dependências

numberField → Platform.runes.numberField
validIndex → Platform.runes.validIndex

Código-fonte

Platform/runes.lua, linha 72. Somente leitura no jogo; Duplicar cria uma cópia editável.

Platform.runes.GetRuneCooldownObservation(self, index)

    local policy=self:GetCombatDataPolicy()
    if policy~='probe' and policy~='restricted' then return nil,'unsupported-policy' end
    local valid,reason=validIndex(self,index)
    if not valid then return nil,reason end
    local api=GetRuneCooldown
    if type(api)~='function' then return nil,'missing-api' end
    local ok,tuple=pcall(function() return {api(index)} end)
    if not ok then return nil,'api-error' end
    local record={}
    record.start,record.startReason=numberField(self,tuple[1],'rune-start-unavailable')
    record.duration,record.durationReason=numberField(self,tuple[2],'rune-duration-unavailable')
    local ready=tuple[3]
    if not self:CanReadValue(ready) then record.readyReason='restricted-value'
    elseif ready==nil then record.readyReason='rune-ready-unavailable'
    elseif type(ready)~='boolean' then record.readyReason='invalid-api-result'
    else record.ready=ready end
    return record

Voltar para Referência de funções