Platform.unit_identity.GetUnitIdentityObservation

Chame como

addon.Platform:GetUnitIdentityObservation(unit, otherunit)

Disponível diretamente por meio de addon; nenhuma dependência é necessária.

O que faz

Compara dois tokens de unidade exatos usando UnitIsUnit após verificar apenas o primeiro token com UnitExists. Uma primeira unidade ausente de forma legível retorna false sem comparar. Observações necessárias ausentes, com falha, restritas ou malformadas retornam nil com um motivo. Nenhuma segunda consulta de existência, busca de GUID ou identidade deduzida é adicionada.

Argumentos

Nome	Tipo	O que faz
`self`	`RMPlatform`	Adaptador de plataforma do Rotation Master (implícito nas chamadas com dois-pontos).
`unit`	`string`	Primeiro token de unidade exato, cuja existência é verificada antes da comparação.
`otherunit`	`string`	Segundo token de unidade exato, passado sem alteração para UnitIsUnit.

Retornos

1	`boolean \| nil`	Igualdade de unidades legível, false para primeira unidade sabidamente ausente ou nil quando observações necessárias estão indisponíveis.
2	`string \| nil`	Motivo de política, validação do token ou disponibilidade para um resultado de identidade 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
`UnitExists`
`UnitIsUnit`

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 same = addon.Platform:GetUnitIdentityObservation("targettarget", "player")
if same == nil then return nil end
return same -- the target is attacking you

Código-fonte

Platform/unit_identity.lua, linha 21. Somente leitura no jogo; Duplicar cria uma cópia editável.

Platform.unit_identity.GetUnitIdentityObservation(self, unit, otherunit)

    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(otherunit) then return nil,'restricted-value' end
    if type(unit)~='string' or unit=='' or type(otherunit)~='string' or otherunit=='' then return nil,'invalid-unit' 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
    if type(UnitIsUnit)~='function' then return nil,'missing-api' end
    local ok,same=pcall(UnitIsUnit,unit,otherunit)
    if not ok then return nil,'api-error' end
    if not self:CanReadValue(same) then return nil,'restricted-value' end
    if same==nil then return nil,'unit-identity-unavailable' end
    if type(same)~='boolean' then return nil,'invalid-api-result' end
    return same

Voltar para Referência de funções