Aufruf als
addon.Platform:GetUnitPointIdentityObservation(unit, includeClass)
Direkt über addon verfügbar; keine Abhängigkeit nötig.
Was sie bewirkt
Für Punktressourcen-Bedingungen die exakte Existenz der ausgewählten Einheit und optional ihren Klassen-Dateinamen beobachten. Bekannte Abwesenheit ergibt exists=false, ohne die Klasse zu lesen. Vorhandene Einheiten benötigen auf Anfrage nur Rückgabewert zwei von UnitClass; ungenutzte lokalisierte Namen und IDs beeinflussen die Verfügbarkeit nicht. Erforderliche fehlende, fehlgeschlagene, eingeschränkte oder fehlerhafte Beobachtungen bleiben nicht verfügbar. Dies wählt keine Ressource aus und speichert keine Identität zwischen.
Argumente
| Name | Typ | Was sie bewirkt |
|---|---|---|
self | RMPlatform | Plattformadapter von Rotation Master (bei Doppelpunktaufrufen implizit). |
unit | string | Exakte Einheitenkennung, unverändert an UnitExists und bei Bedarf an UnitClass übergeben. |
includeClass | boolean | True erfordert zusätzlich den Klassen-Dateinamen der vorhandenen Einheit; false liest nur die Existenz. |
Rückgabewerte
| 1 | table | nil | Lesbarer Datensatz mit booleschem exists und, falls vorhanden, dem angefragten Klassen-Dateinamen; nil, wenn erforderliche Daten nicht verfügbar sind. |
|---|---|---|
| 2 | string | nil | Grund aus Richtlinie, Abfragevalidierung oder Verfügbarkeit einer erforderlichen Beobachtung für einen nil-Datensatz. |
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 |  |  |  |  |  |
|---|---|---|---|---|---|
UnitClass | | | | | |
UnitExists | | | | | |
canaccessvalue | | | | | |
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.
Beispiel
local record = addon.Platform:GetUnitPointIdentityObservation("target", true)
if not record then return nil end
return record.exists and record.class == "ROGUE"Quelle
Platform/points.lua, Zeile 87. Im Spiel schreibgeschützt; Duplizieren erstellt eine bearbeitbare Kopie.
Platform.points.GetUnitPointIdentityObservation(self, unit, includeClass)
local policy=self:GetCombatDataPolicy()
if policy~='probe' and policy~='restricted' then return nil,'unsupported-policy' end
if not self:CanReadValue(unit) or not self:CanReadValue(includeClass) then return nil,'restricted-value' end
if type(unit)~='string' or unit=='' then return nil,'invalid-unit' end
if type(includeClass)~='boolean' then return nil,'invalid-point-identity-query' end
if type(UnitExists)~='function' then return nil,'missing-api' end
local existsOK,exists=pcall(UnitExists,unit)
if not existsOK then return nil,'api-error' end
if not self:CanReadValue(exists) then return nil,'restricted-value' end
if canaccessvalue and not canaccessvalue(exists) then return nil,'restricted-value' end
if exists==nil then return nil,'unit-data-unavailable' end
if type(exists)~='boolean' then return nil,'invalid-api-result' end
if not exists then return {exists=false} end
if not includeClass then return {exists=true} end
if type(UnitClass)~='function' then return nil,'missing-api' end
local ok,_,class=pcall(UnitClass,unit)
if not ok then return nil,'api-error' end
if not self:CanReadValue(class) then return nil,'restricted-value' end
if canaccessvalue and not canaccessvalue(class) then return nil,'restricted-value' end
if class==nil then return nil,'point-class-unavailable' end
if type(class)~='string' or class=='' then return nil,'invalid-api-result' end
return {exists=true,class=class}