Platform.health_forecast.GetHealthForecastProviderObservation

Aufruf als

addon.Platform:GetHealthForecastProviderObservation(unit)

Direkt über addon verfügbar; keine Abhängigkeit nötig.

Was sie bewirkt

Optionales RealMobHealth über seinen exakten Punktaufruf mit einem Argument lesen. Ein fehlender Namensraum (nil/false) ergibt einen leeren Datensatz. current und maximum unabhängig normalisieren: nil/false-Felder erlauben den nativen Rückgriff, numerische Null bleibt vorhanden. Fehlerhafte, fehlgeschlagene, eingeschränkte, negative oder nicht endliche verwendete Anbieterfakten sind nicht verfügbar. Es wird kein Anbieter- oder veralteter Rückgriff-Cache verwendet.

Argumente

Name	Typ	Was sie bewirkt
`self`	`RMPlatform`	Plattformadapter von Rotation Master (bei Doppelpunktaufrufen implizit).
`unit`	`string`	Ausgewählte Einheitenkennung, als einziges Argument an den Anbieter weitergereicht.

Rückgabewerte

1	`table \| nil`	Teilweiser current/maximum-Datensatz, leer, wenn der Anbieter fehlt, oder nil, wenn nicht verfügbar.
2	`string \| nil`	Verfügbarkeitsgrund aus Anbieter, Validierung oder Beobachtung.

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.

Sie liest keine Spiel-API direkt.

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:GetHealthForecastProviderObservation("target")
if not record or not record.current or not record.maximum then return nil end
if record.maximum == 0 then return nil end
return record.current / record.maximum < 0.2

Abhängigkeiten

providerValue → Platform.health_forecast.providerValue
readField → Platform.health_forecast.readField

Quelle

Platform/health_forecast.lua, Zeile 107. Im Spiel schreibgeschützt; Duplizieren erstellt eine bearbeitbare Kopie.

Platform.health_forecast.GetHealthForecastProviderObservation(self, unit)

    local policy=self:GetCombatDataPolicy()
    if policy~='probe' and policy~='restricted' then return nil,'unsupported-policy' end
    if not self:CanReadValue(unit) then return nil,'restricted-value' end
    if type(unit)~='string' or unit=='' then return nil,'invalid-unit' end
    local provider=_G.RealMobHealth
    if not self:CanReadValue(provider) then return nil,'restricted-value' end
    if provider==nil or provider==false then return {} end
    local api,why=readField(self,provider,'GetUnitHealth')
    if why then return nil,why end
    if type(api)~='function' then return nil,'missing-api' end
    local ok,current,maximum=pcall(api,unit)
    if not ok then return nil,'api-error' end
    local value,reason=providerValue(self,current)
    if reason then return nil,reason end
    local max,maxReason=providerValue(self,maximum)
    if maxReason then return nil,maxReason end
    return {current=value,maximum=max}

Zurück zu Funktionsreferenz