Chiamala come
addon.Platform:GetUnitPointIdentityObservation(unit, includeClass)
Disponibile direttamente tramite addon; non serve alcuna dipendenza.
Cosa fa
Osserva l'esistenza esatta dell'unità selezionata e, facoltativamente, il nome file della sua classe per le condizioni sulle risorse a punti. Un'assenza accertata restituisce exists=false senza leggere la classe. Le unità presenti richiedono, se richiesto, solo il secondo valore restituito da UnitClass; nomi localizzati e ID inutilizzati non influiscono sulla disponibilità. Osservazioni richieste mancanti, fallite, soggette a restrizioni o malformate restano non disponibili. Non seleziona una risorsa né memorizza l'identità in cache.
Argomenti
| Nome | Tipo | Cosa fa |
|---|---|---|
self | RMPlatform | Adattatore di piattaforma di Rotation Master (implicito nelle chiamate con due punti). |
unit | string | Identificativo unità esatto passato invariato a UnitExists e, se necessario, a UnitClass. |
includeClass | boolean | True richiede anche il nome file della classe dell'unità presente; false legge solo l'esistenza. |
Valori restituiti
| 1 | table | nil | Record leggibile con exists booleano e, se presente, il nome file della classe richiesto; nil quando i dati richiesti non sono disponibili. |
|---|---|---|
| 2 | string | nil | Motivo di policy, di convalida della query o di indisponibilità di un'osservazione richiesta quando il record è 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 |  |  |  |  |  |
|---|---|---|---|---|---|
UnitClass | | | | | |
UnitExists | | | | | |
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 record = addon.Platform:GetUnitPointIdentityObservation("target", true)
if not record then return nil end
return record.exists and record.class == "ROGUE"Sorgente
Platform/points.lua, riga 87. Nel gioco è in sola lettura; Duplica crea una copia modificabile.
Platform.points.GetUnitPointIdentityObservation(self, unit, includeClass)
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(includeClass) then return nil,'restricted-value' end
if type(unit)~='string' or unit=='' then return nil,'invalid-unit' end
if type(includeClass)~='boolean' then return nil,'invalid-point-identity-query' end
if type(UnitExists)~='function' then return nil,'missing-api' end
local existsOK,exists=pcall(UnitExists,unit)
if not existsOK then return nil,'api-error' end
if not self:CanReadValue(exists) then return nil,'restricted-value' end
if canaccessvalue and not canaccessvalue(exists) then return nil,'restricted-value' end
if exists==nil then return nil,'unit-data-unavailable' end
if type(exists)~='boolean' then return nil,'invalid-api-result' end
if not exists then return {exists=false} end
if not includeClass then return {exists=true} end
if type(UnitClass)~='function' then return nil,'missing-api' end
local ok,_,class=pcall(UnitClass,unit)
if not ok then return nil,'api-error' end
if not self:CanReadValue(class) then return nil,'restricted-value' end
if canaccessvalue and not canaccessvalue(class) then return nil,'restricted-value' end
if class==nil then return nil,'point-class-unavailable' end
if type(class)~='string' or class=='' then return nil,'invalid-api-result' end
return {exists=true,class=class}