Platform.points.GetUnitPointPowerObservation

Llamar como

addon.Platform:GetUnitPointPowerObservation(unit, powerType, kind)

Disponible directamente a través de addon; no se necesita ninguna dependencia.

Qué hace

Lee una cantidad de un recurso de puntos seleccionado explícitamente con una consulta exacta de dos argumentos a UnitPower o UnitPowerMax. El selector es obligatorio; no se deduce el recurso principal ni se reasigna el actor. Conserva las cantidades finitas con signo, fraccionarias y cero sin recortarlas. Los datos que faltan, fallan, están restringidos o no son finitos siguen sin estar disponibles. Current y maximum son observaciones separadas para que quienes llaman puedan compartir instantáneas actuales y pedir el máximo de forma diferida.

Argumentos

Nombre	Tipo	Qué hace
`self`	`RMPlatform`	Adaptador de plataforma de Rotation Master (implícito en las llamadas con dos puntos).
`unit`	`string`	Token de unidad exacto cuya cantidad de recurso seleccionada se solicita.
`powerType`	`number`	Selector de poder entero no negativo, finito, legible y explícito, incluido cero.
`kind`	`string`	Exactamente current para UnitPower o maximum para UnitPowerMax; no se agrega ninguna otra consulta nativa.

Retornos

1	`number \| nil`	Cantidad de recurso nativa finita, que conserva su signo y su parte fraccionaria; nil si no está disponible.
2	`string \| nil`	Motivo de política, validación de la consulta o disponibilidad para una cantidad 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 usa 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
`UnitPower`
`UnitPowerMax`
`canaccessvalue`

Valores secretos (Retail y Forever)

En Retail y Forever, el juego les entrega a los addons valores secretos. Esta función auxiliar verifica 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 holyPower = addon.Platform:GetUnitPointPowerObservation("player", Enum.PowerType.HolyPower, "current")
if holyPower == nil then return nil end
return holyPower >= 3

Dependencias

pointFragmentType (builtin:Platform/points.lua:pointFragmentType)

Código fuente

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

Platform.points.GetUnitPointPowerObservation(self, unit, powerType, kind)

    local policy=self:GetCombatDataPolicy()
    if policy~='probe' and (policy~='restricted' or not self:IsNeverSecretPointPower(powerType)) then return nil,'unsupported-policy' end
    if not self:CanReadValue(unit) or not self:CanReadValue(powerType) or not self:CanReadValue(kind) then return nil,'restricted-value' end
    if type(unit)~='string' or unit=='' then return nil,'invalid-unit' end
    if type(powerType)~='number' or powerType~=powerType or powerType<0 or powerType==math.huge or powerType%1~=0 then return nil,'invalid-point-power-query' end
    if kind~='current' and kind~='maximum' then return nil,'invalid-point-power-query' end
    if powerType==pointFragmentType then return self:GetUnitPointFragmentObservation(unit,powerType,kind) end
    local api
    if kind=='current' then api=UnitPower else api=UnitPowerMax end
    if type(api)~='function' then return nil,'missing-api' end
    local ok,result=pcall(api,unit,powerType)
    if not ok then return nil,'api-error' end
    if not self:CanReadValue(result) then return nil,'restricted-value' end
    if canaccessvalue and not canaccessvalue(result) then return nil,'restricted-value' end
    if result==nil then return nil,'point-power-unavailable' end
    if type(result)~='number' or result~=result or result==math.huge or result==-math.huge then return nil,'invalid-api-result' end
    return result

Volver a Referencia de funciones