Chiamala come
addon.Platform:GetUnitMetadataObservation(unit, kind)
Disponibile direttamente tramite addon; non serve alcuna dipendenza.
Cosa fa
Osserva un singolo campo di metadati nativi dell'unità consumato, dopo aver verificato UnitExists: class usa il secondo valore restituito da UnitClass, creature usa il nome localizzato di UnitCreatureType e classification usa UnitClassification. Un'unità leggibile ma assente restituisce false senza interrogare i metadati. I campi inutilizzati della tupla non influiscono sulla disponibilità; un valore richiesto mancante, fallito, nil, soggetto a restrizioni o malformato restituisce nil con un motivo. Non vengono aggiunte deduzioni di classe del giocatore, GUID, enum o traduzione.
Argomenti
| Nome | Tipo | Cosa fa |
|---|---|---|
self | RMPlatform | Adattatore di piattaforma di Rotation Master (implicito nelle chiamate con due punti). |
unit | string | Identificativo unità esatto, di cui si verifica l'esistenza, passato all'API di metadati selezionata. |
kind | string | Uno tra class, creature o classification; gli altri tipi di metadati non sono supportati. |
Valori restituiti
| 1 | string | boolean | nil | Stringa leggibile dei metadati consumati, false per un'unità accertata come assente, oppure nil quando i dati richiesti non sono disponibili. |
|---|---|---|
| 2 | string | nil | Motivo di policy, di convalida della query o di indisponibilità quando l'osservazione dei metadati è 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 | | | | | |
UnitClassification | | | | | |
UnitCreatureType | | | | | |
UnitExists | | | | | |
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 classification = addon.Platform:GetUnitMetadataObservation("target", "classification")
if classification == nil then return nil end
return classification == "worldboss" or classification == "elite"Sorgente
Platform/unit_metadata.lua, riga 21. Nel gioco è in sola lettura; Duplica crea una copia modificabile.
Platform.unit_metadata.GetUnitMetadataObservation(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
if kind~='class' and kind~='creature' and kind~='classification' then return nil,'invalid-unit-metadata-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 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 false end
local api
if kind=='class' then api=UnitClass
elseif kind=='creature' then api=UnitCreatureType
else api=UnitClassification end
if type(api)~='function' then return nil,'missing-api' end
local ok,observed
if kind=='class' then ok,observed=pcall(function() return select(2,api(unit)) end)
else ok,observed=pcall(api,unit) end
if not ok then return nil,'api-error' end
if not self:CanReadValue(observed) then return nil,'restricted-value' end
if observed==nil then return nil,'unit-metadata-unavailable' end
if type(observed)~='string' or observed=='' then return nil,'invalid-api-result' end
return observed