Chame como
addon.Platform:GetUnitPointIdentityObservation(unit, includeClass)
Disponível diretamente por meio de addon; nenhuma dependência é necessária.
O que faz
Observa a existência exata da unidade selecionada e, opcionalmente, o nome de arquivo da classe dela para condições de recursos de pontos. Ausência conhecida retorna exists=false sem ler a classe. Unidades presentes exigem apenas o segundo retorno de UnitClass quando solicitado; nomes localizados e IDs não usados não afetam a disponibilidade. Observações necessárias ausentes, com falha, restritas ou malformadas continuam indisponíveis. Isso não seleciona um recurso nem guarda a identidade em cache.
Argumentos
| Nome | Tipo | O que faz |
|---|---|---|
self | RMPlatform | Adaptador de plataforma do Rotation Master (implícito nas chamadas com dois-pontos). |
unit | string | Token de unidade exato passado sem alteração para UnitExists e, quando necessário, para UnitClass. |
includeClass | boolean | True também exige o nome de arquivo de classe da unidade presente; false lê apenas a existência. |
Retornos
| 1 | table | nil | Registro legível com exists booleano e o nome de arquivo de classe solicitado quando presente; nil quando dados necessários estão indisponíveis. |
|---|---|---|
| 2 | string | nil | Motivo de política, validação da consulta ou disponibilidade de observação necessária para um registro nil. |
Edições
As funções auxiliares integradas são registradas em todas as edições. O que muda é a API do jogo que elas leem; quando uma está ausente, a função auxiliar recorre a uma alternativa ou retorna nil com um motivo.
- Indisponível nessa edição (o motivo está na dica)
- Só enquanto as alternativas da Blizzard para APIs obsoletas estiverem ativas
| API do jogo |  |  |  |  |  |
|---|---|---|---|---|---|
UnitClass | | | | | |
UnitExists | | | | | |
canaccessvalue | | | | | |
Valores secretos (Retail e Forever)
No Retail e no Forever, o jogo entrega valores secretos aos addons. Esta função auxiliar verifica o que lê (addon.Platform:CanReadValue) e retorna nil com um motivo como restricted-value em vez de um valor secreto que não consegue comparar. Trate nil como indisponível, não como false.
Exemplo
local record = addon.Platform:GetUnitPointIdentityObservation("target", true)
if not record then return nil end
return record.exists and record.class == "ROGUE"Código-fonte
Platform/points.lua, linha 87. Somente leitura no jogo; Duplicar cria uma cópia editável.
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}