Platform.player_flags.GetPlayerFlagObservation

Llamar como

addon.Platform:GetPlayerFlagObservation(kind)

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

Qué hace

Observa un único indicador independiente del jugador sin argumentos: stealthed usa IsStealthed, control usa HasFullControl y outdoors usa IsOutdoors. Los valores legibles true y false conservan su significado. Los datos necesarios que faltan, fallan, son nil, están restringidos o mal formados devuelven nil con un motivo. No se añade deducción de existencia, estancia ni posibilidad de usar habilidades.

Argumentos

Nombre	Tipo	Qué hace
`self`	`RMPlatform`	Adaptador de plataforma de Rotation Master (implícito en las llamadas con dos puntos).
`kind`	`string`	Uno de stealthed, control u outdoors; no se invoca ningún otro predicado.

Retornos

1	`boolean \| nil`	Indicador seleccionado legible, o nil cuando faltan datos necesarios.
2	`string \| nil`	Motivo de política, validación de la consulta o disponibilidad para un indicador del jugador 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
`HasFullControl`
`IsOutdoors`
`IsStealthed`

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 stealthed = addon.Platform:GetPlayerFlagObservation("stealthed")
local outdoors = addon.Platform:GetPlayerFlagObservation("outdoors")
if stealthed == nil or outdoors == nil then return nil end
return outdoors and not stealthed

Código fuente

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

Platform.player_flags.GetPlayerFlagObservation(self, kind)

    local policy=self:GetCombatDataPolicy()
    if policy~='probe' and policy~='restricted' then return nil,'unsupported-policy' end
    if not self:CanReadValue(kind) then return nil,'restricted-value' end
    if kind~='stealthed' and kind~='control' and kind~='outdoors' then return nil,'invalid-player-flag-query' end
    local api
    if kind=='stealthed' then api=IsStealthed
    elseif kind=='control' then api=HasFullControl
    else api=IsOutdoors end
    if type(api)~='function' then return nil,'missing-api' end
    local ok,result=pcall(api)
    if not ok then return nil,'api-error' end
    if not self:CanReadValue(result) then return nil,'restricted-value' end
    if result==nil then return nil,'player-flag-unavailable' end
    if type(result)~='boolean' then return nil,'invalid-api-result' end
    return result

Volver a Referencia de funciones