Как вызывать
addon.Platform:GetNameplateMaxDistance()
Доступен напрямую через addon; зависимость не нужна.
Что делает
Прочитать текущую положительную дальность видимости индикаторов здоровья через поддерживаемый API CVar. Это ограничивает запрос «Число в радиусе»; это не доказывает, что все ближайшие юниты наблюдались. Отсутствующие, повреждённые, ограниченные или неудачные наблюдения возвращают nil с причиной.
Аргументы
| Имя | Тип | Что делает |
|---|---|---|
self | RMPlatform | Адаптер платформы Rotation Master (неявно при вызове через двоеточие). |
Возвращает
| 1 | number | nil | Текущая положительная дистанция видимости в метрах; nil, если недоступна. |
|---|---|---|
| 2 | string | nil | Причина недоступности для результата nil. |
Издания
Встроенные помощники регистрируются во всех изданиях. Различается игровой API, который они читают; если нужного API нет, помощник использует запасной вариант или возвращает nil с причиной.
- Недоступно в этом издании (причина — во всплывающей подсказке)
- Только пока включены запасные реализации Blizzard для устаревших функций
| Игровой API |  |  |  |  |  |
|---|---|---|---|---|---|
C_CVar.GetCVar | | | | | |
GetCVar | | | | | |
Секретные значения (Retail и Forever)
В Retail и Forever игра передаёт аддонам секретные значения. Этот помощник проверяет то, что читает (addon.Platform:CanReadValue), и вместо секретного значения, которое нельзя сравнить, возвращает nil с причиной, например restricted-value. Считайте nil недоступным значением, а не ложью.
Как его вызывает аддон
- Число в радиусе (widget)
local maximum=addon.Platform:GetNameplateMaxDistance()
Исходный код
Platform/range.lua, строка 109. В игре только для чтения; «Дублировать» создаёт редактируемую копию.
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