Llamar como
addon.Platform:GetNameplateMaxDistance()
Disponible directamente a través de addon; no hace falta 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 recurre a 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 entrega a los addons valores secretos. Esta función auxiliar comprueba 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