Llamar como
addon.Platform:GetNameplateMaxDistance()
Disponible directamente a través de addon; no se necesita ninguna dependencia.
Qué hace
Lee la distancia de visibilidad positiva actual de las placas de nombre usando la API de CVar compatible. Limita una consulta de Recuento por distancia; no demuestra que se hayan observado todas las unidades cercanas. Las observaciones que faltan, están mal formadas, restringidas o fallan devuelven nil con un motivo.
Argumentos
| Nombre | Tipo | Qué hace |
|---|---|---|
self | RMPlatform | Adaptador de plataforma de Rotation Master (implícito en las llamadas con dos puntos). |
Retornos
| 1 | number | nil | Distancia de visibilidad positiva actual en metros; nil si no está disponible. |
|---|---|---|
| 2 | string | nil | Motivo de disponibilidad para un resultado nil. |
Ediciones
Las funciones auxiliares integradas se registran en todas las ediciones. Lo que cambia es la API del juego que leen; donde falta alguna, la función auxiliar usa una alternativa o devuelve nil con un motivo.
- No disponible en esa edición (el motivo aparece en la información emergente)
- Solo mientras estén activas las alternativas de Blizzard para API obsoletas
| API del juego |  |  |  |  |  |
|---|---|---|---|---|---|
C_CVar.GetCVar | | | | | |
GetCVar | | | | | |
Valores secretos (Retail y Forever)
En Retail y Forever, el juego les entrega a los addons valores secretos. Esta función auxiliar verifica lo que lee (addon.Platform:CanReadValue) y, en lugar de un secreto que no puede comparar, devuelve nil con un motivo como restricted-value. Trata nil como no disponible, no como falso.
Cómo la llama el addon
- Recuento por distancia (widget)
local maximum=addon.Platform:GetNameplateMaxDistance()
Código fuente
Platform/range.lua, línea 109. Solo lectura en el juego; Duplicar crea una copia editable.
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