Platform.runes.GetRuneCooldownObservation

Llamar como

addon.Platform:GetRuneCooldownObservation(index)

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

Qué hace

Lee una tupla protegida de GetRuneCooldown para una casilla nativa exacta. Normaliza ready, start y duration de forma independiente: ready requiere un booleano legible, y cada tiempo requiere un número finito legible y conserva los valores con signo, fraccionarios y cero. Cada campo no disponible lleva su propio motivo. Una tupla vacía correcta produce un registro parcial; la falta de capacidad, la política o un fallo de la llamada nativa producen nil. Nunca deduce ready a partir de los tiempos ni los tiempos a partir de ready. Guarda en caché este registro completo en quien llama para compartir una observación entre los predicados de recuento de runas y de tiempo de reutilización.

Argumentos

Nombre	Tipo	Qué hace
`self`	`RMPlatform`	Adaptador de plataforma de Rotation Master (implícito en las llamadas con dos puntos).
`index`	`number`	Casilla de runa nativa entera exacta, de 1 a 6.

Retornos

1	`table \| nil`	Registro parcial que contiene ready o readyReason, start o startReason, y duration o durationReason; nil solo cuando la propia consulta no está disponible.
2	`string \| nil`	Motivo de disponibilidad de la política, la validación de la casilla, la capacidad o la llamada nativa para un registro 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
`GetRuneCooldown`

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 rune = addon.Platform:GetRuneCooldownObservation(1)
if not rune or rune.ready == nil then return nil end
return rune.ready

Dependencias

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

Código fuente

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

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

Volver a Referencia de funciones