Chame como
addon.Platform:GetNameplateMaxDistance()
Disponível diretamente por meio de addon; nenhuma dependência é necessária.
O que faz
Lê a distância de visibilidade positiva atual das placas de identificação usando a API de CVar suportada. Isso limita uma consulta de Contagem por distância; não prova que todas as unidades próximas foram observadas. Observações ausentes, malformadas, restritas ou com falha retornam nil com um motivo.
Argumentos
| Nome | Tipo | O que faz |
|---|---|---|
self | RMPlatform | Adaptador de plataforma do Rotation Master (implícito nas chamadas com dois-pontos). |
Retornos
| 1 | number | nil | Distância de visibilidade positiva atual em metros; nil quando indisponível. |
|---|---|---|
| 2 | string | nil | Motivo de disponibilidade para um resultado 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 |  |  |  |  |  |
|---|---|---|---|---|---|
C_CVar.GetCVar | | | | | |
GetCVar | | | | | |
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.
Como o addon a chama
- Contagem por distância (widget)
local maximum=addon.Platform:GetNameplateMaxDistance()
Código-fonte
Platform/range.lua, linha 109. Somente leitura no jogo; Duplicar cria uma cópia editável.
Platform.range.GetNameplateMaxDistance(self)
local query=C_CVar and C_CVar.GetCVar or GetCVar
if type(query)~='function' then return nil,'missing-api' end
local ok,value=pcall(query,'nameplateMaxDistance')
if not ok then return nil,'api-error' end
if not self:CanReadValue(value) then return nil,'restricted-value' end
if type(value)~='string' and type(value)~='number' then return nil,'nameplate-distance-unavailable' end
local maximum=tonumber(value)
if not maximum or maximum~=maximum or maximum<=0 or maximum==math.huge then return nil,'nameplate-distance-unavailable' end
return maximum