Platform.points.GetUnitPointPowerObservation

Chiamala come

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

Disponibile direttamente tramite addon; non serve alcuna dipendenza.

Cosa fa

Legge la quantità di una singola risorsa a punti selezionata esplicitamente, con una query esatta a due argomenti UnitPower o UnitPowerMax. Il selettore è obbligatorio; non avvengono deduzioni della risorsa primaria né rimappature dell'attore. Preserva le quantità finite con segno, frazionarie e zero senza limitarle. Dati mancanti, falliti, soggetti a restrizioni o non finiti restano non disponibili. Attuale e massimo sono osservazioni separate, così i chiamanti possono condividere le istantanee attuali richiedendo il massimo solo quando serve.

Argomenti

Nome	Tipo	Cosa fa
`self`	`RMPlatform`	Adattatore di piattaforma di Rotation Master (implicito nelle chiamate con due punti).
`unit`	`string`	Identificativo esatto dell'unità di cui si richiede la quantità della risorsa selezionata.
`powerType`	`number`	Selettore di risorsa esplicito, leggibile, finito, intero e non negativo, zero incluso.
`kind`	`string`	Esattamente current per UnitPower o maximum per UnitPowerMax; non viene aggiunta alcuna altra query nativa.

Valori restituiti

1	`number \| nil`	Quantità nativa finita della risorsa, con segno e parte frazionaria mantenuti; nil se non disponibile.
2	`string \| nil`	Motivo di policy, di convalida della query o di indisponibilità quando la quantità è nil.

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
`UnitPower`
`UnitPowerMax`
`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 holyPower = addon.Platform:GetUnitPointPowerObservation("player", Enum.PowerType.HolyPower, "current")
if holyPower == nil then return nil end
return holyPower >= 3

Dipendenze

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

Sorgente

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

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

Torna a Riferimento delle funzioni