Platform.health_forecast.GetHealthForecastValueObservation

Chiamala come

addon.Platform:GetHealthForecastValueObservation(unit, kind)

Disponibile direttamente tramite addon; non serve alcuna dipendenza.

Cosa fa

Legge un valore scalare pigro della salute dopo un controllo separato dell'identità. Il tipo current usa esattamente UnitHealth(unit); maximum usa esattamente UnitHealthMax(unit). I client con policy di sondaggio o ristretta accettano numeri leggibili, finiti e non negativi, zero incluso. Non vengono aggiunte chiamate ripetute di esistenza/GUID né ripieghi su tuple alternative.

Argomenti

Nome	Tipo	Cosa fa
`self`	`RMPlatform`	Adattatore di piattaforma di Rotation Master (implicito nelle chiamate con due punti).
`unit`	`string`	Identificativo unità selezionato non vuoto; questa chiamata da sola non stabilisce la presenza.
`kind`	`string`	Tipo scalare chiuso: current o maximum.

Valori restituiti

1	`number \| nil`	Valore scalare nativo della salute, finito e non negativo, oppure nil se non disponibile.
2	`string \| nil`	Motivo di policy, di convalida o di indisponibilità di un'osservazione richiesta.

Edizioni

Le funzioni di supporto integrate sono registrate su ogni edizione. Ciò che cambia è l'API di gioco che leggono; dove ne manca una, la funzione di supporto ripiega su un'alternativa o restituisce nil con un motivo.

Non disponibile su quell'edizione (il motivo è nel suggerimento)
Solo mentre sono attivi i ripieghi di Blizzard per le API deprecate

API di gioco
`UnitHealth`
`UnitHealthMax`
`canaccessvalue`

Valori segreti (Retail e Forever)

Su Retail e Forever il gioco fornisce agli addon valori segreti. Questa funzione di supporto controlla ciò che legge (addon.Platform:CanReadValue) e restituisce nil con un motivo come restricted-value invece di un valore segreto che non può confrontare. Considera nil come non disponibile, non come false.

Esempio

local current = addon.Platform:GetHealthForecastValueObservation("target", "current")
local maximum = addon.Platform:GetHealthForecastValueObservation("target", "maximum")
if not current or not maximum or maximum == 0 then return nil end
return current / maximum <= 0.35

Dipendenze

finite → Platform.health_forecast.finite

Sorgente

Platform/health_forecast.lua, riga 81. Nel gioco è in sola lettura; Duplica crea una copia modificabile.

Platform.health_forecast.GetHealthForecastValueObservation(self, unit, kind)

    local policy=self:GetCombatDataPolicy()
    if policy~='probe' and policy~='restricted' then return nil,'unsupported-policy' end
    if not self:CanReadValue(unit) or not self:CanReadValue(kind) then return nil,'restricted-value' end
    if type(unit)~='string' or unit=='' then return nil,'invalid-unit' end
    local api
    if kind=='current' then api=UnitHealth
    elseif kind=='maximum' then api=UnitHealthMax
    else return nil,'invalid-health-forecast-query' end
    if type(api)~='function' then return nil,'missing-api' end
    local ok,value=pcall(api,unit)
    if not ok then return nil,'api-error' end
    if not self:CanReadValue(value) then return nil,'restricted-value' end
    if canaccessvalue and not canaccessvalue(value) then return nil,'restricted-value' end
    if value==nil then return nil,'health-data-unavailable' end
    if not finite(value) or value<0 then return nil,'invalid-api-result' end
    return value

Torna a Riferimento delle funzioni