Platform.points.GetPlayerComboPointObservation

Chiamala come

addon.Platform:GetPlayerComboPointObservation(powerType, kind)

Disponibile direttamente tramite addon; non serve alcuna dipendenza.

Cosa fa

Osserva il trasporto dei punti combo del giocatore di TBC selezionato esplicitamente. Current usa esattamente GetComboPoints(player,target); maximum usa UnitPowerMax(player,powerType) con il selettore originale. Le altre famiglie non sono disponibili qui e devono usare il loro osservatore esistente delle risorse a punti. Preserva i valori leggibili finiti con segno, frazionari e zero. Dati mancanti, falliti, soggetti a restrizioni o malformati restano non disponibili; una query dei punti combo scelta che fallisce non ripiega mai su UnitPower. Non osserva nessun altro attore e non aggiunge cache.

Argomenti

Nome	Tipo	Cosa fa
`self`	`RMPlatform`	Adattatore di piattaforma di Rotation Master (implicito nelle chiamate con due punti).
`powerType`	`number`	Selettore originale esplicito della risorsa dei punti combo, leggibile, finito, intero e non negativo, zero incluso; mantenuto per la query del massimo.
`kind`	`string`	Esattamente current per la query dei punti combo player/target o maximum per la query della capacità del giocatore.

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à di un'osservazione richiesta 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
`GetComboPoints`
`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

-- TBC only; 4 is the combo point power type
local current = addon.Platform:GetPlayerComboPointObservation(4, "current")
if current == nil then return nil end
return current >= 5

Sorgente

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

Platform.points.GetPlayerComboPointObservation(self, powerType, kind)

    local info=self:GetClientInfo()
    if info.combatDataPolicy~='probe' then return nil,'unsupported-policy' end
    local family
    if self:CanReadValue(info) and type(info)=='table' then family=rawget(info,'family') end
    if not self:CanReadValue(family) then return nil,'restricted-value' end
    if canaccessvalue and not canaccessvalue(family) then return nil,'restricted-value' end
    if family~='tbc' then return nil,'unsupported-point-transport' end
    if not self:CanReadValue(powerType) or not self:CanReadValue(kind) then return nil,'restricted-value' 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
    local api
    if kind=='current' then api=GetComboPoints else api=UnitPowerMax end
    if type(api)~='function' then return nil,'missing-api' end
    local ok,result
    if kind=='current' then ok,result=pcall(api,'player','target') else ok,result=pcall(api,'player',powerType) end
    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