Aufruf als
addon.Platform:GetNameplateMaxDistance()
Direkt über addon verfügbar; keine Abhängigkeit nötig.
Was sie bewirkt
Die aktuelle positive Sichtweite der Namensplaketten über die unterstützte CVar-API lesen. Dies begrenzt eine Abfrage für „Anzahl in Entfernung“; es belegt nicht, dass alle Einheiten in der Nähe beobachtet wurden. Fehlende, fehlerhafte, eingeschränkte oder fehlgeschlagene Beobachtungen ergeben nil mit einem Grund.
Argumente
| Name | Typ | Was sie bewirkt |
|---|---|---|
self | RMPlatform | Plattformadapter von Rotation Master (bei Doppelpunktaufrufen implizit). |
Rückgabewerte
| 1 | number | nil | Aktuelle positive Sichtweite in Metern; nil, wenn nicht verfügbar. |
|---|---|---|
| 2 | string | nil | Verfügbarkeitsgrund für ein nil-Ergebnis. |
Editionen
Integrierte Hilfsfunktionen werden auf jeder Edition registriert. Unterschiedlich ist die Spiel-API, die sie lesen; fehlt eine, weicht die Hilfsfunktion aus oder gibt nil mit einem Grund zurück.
- Auf dieser Edition nicht verfügbar (den Grund nennt der Tooltip)
- Nur, solange Blizzards Ersatz für veraltete Funktionen aktiv ist
| Spiel-API |  |  |  |  |  |
|---|---|---|---|---|---|
C_CVar.GetCVar | | | | | |
GetCVar | | | | | |
Geheime Werte (Retail und Forever)
Auf Retail und Forever übergibt das Spiel Addons geheime Werte. Diese Hilfsfunktion prüft, was sie liest (addon.Platform:CanReadValue), und gibt statt eines geheimen Werts, den sie nicht vergleichen kann, nil mit einem Grund wie restricted-value zurück. Behandeln Sie nil als nicht verfügbar, nicht als false.
Wie das Addon sie aufruft
- Anzahl in Entfernung (widget)
local maximum=addon.Platform:GetNameplateMaxDistance()
Quelle
Platform/range.lua, Zeile 109. Im Spiel schreibgeschützt; Duplizieren erstellt eine bearbeitbare Kopie.
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