Appel
addon.Platform:GetNameplateMaxDistance()
Disponible directement via addon ; aucune dépendance n'est nécessaire.
Ce qu'elle fait
Lit la distance de visibilité positive actuelle des barres de nom à l'aide de l'API CVar prise en charge. Cela limite une requête « Décompte par distance » ; cela ne prouve pas que toutes les unités proches ont été observées. Les observations manquantes, mal formées, restreintes ou en échec renvoient nil avec un motif.
Arguments
| Nom | Type | Ce qu'elle fait |
|---|---|---|
self | RMPlatform | Adaptateur de plateforme Rotation Master (implicite avec un appel par deux-points). |
Retours
| 1 | number | nil | Distance de visibilité positive actuelle, en mètres ; nil si indisponible. |
|---|---|---|
| 2 | string | nil | Motif de disponibilité pour un résultat nil. |
Éditions
Les fonctions utilitaires intégrées sont enregistrées sur toutes les éditions. Ce qui diffère, c'est l'API du jeu qu'elles lisent ; quand l'une manque, la fonction utilitaire se rabat sur une alternative ou renvoie nil avec une raison.
- Indisponible sur cette édition (la raison figure dans l'infobulle)
- Uniquement tant que les solutions de repli de Blizzard pour les fonctions obsolètes sont actives
| API du jeu |  |  |  |  |  |
|---|---|---|---|---|---|
C_CVar.GetCVar | | | | | |
GetCVar | | | | | |
Valeurs secrètes (Retail et Forever)
Sur Retail et Forever, le jeu transmet aux addons des valeurs secrètes. Cette fonction utilitaire vérifie ce qu'elle lit (addon.Platform:CanReadValue) et renvoie nil avec une raison telle que restricted-value au lieu d'une valeur secrète qu'elle ne peut pas comparer. Traitez nil comme indisponible, pas comme false.
Comment l'addon l'appelle
- Nombre à distance (widget)
local maximum=addon.Platform:GetNameplateMaxDistance()
Source
Platform/range.lua, ligne 109. En lecture seule dans le jeu ; Dupliquer crée une copie modifiable.
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