Chiamala come
addon.Platform:GetHealthForecastTimeObservation()
Disponibile direttamente tramite addon; non serve alcuna dipendenza.
Cosa fa
Osserva un GetTime protetto senza argomenti, appena letto, per una previsione della salute necessaria. Richiede leggibilità e un numero finito; preserva i valori con segno e frazionari senza aggiungere vincoli di monotonia, interezza o non negatività. Non usa cache dell'orologio né query native aggiuntive.
Argomenti
| Nome | Tipo | Cosa fa |
|---|---|---|
self | RMPlatform | Adattatore di piattaforma di Rotation Master (implicito nelle chiamate con due punti). |
Valori restituiti
| 1 | number | nil | Orologio appena letto, leggibile e finito, oppure nil se non disponibile. |
|---|---|---|
| 2 | string | nil | Motivo di indisponibilità della funzionalità o dell'osservazione dell'orologio. |
Edizioni
Le funzioni di supporto integrate sono registrate su ogni edizione. Ciò che cambia è l'API di gioco che leggono; dove ne manca una, la funzione di supporto ripiega su un'alternativa o restituisce nil con un motivo.
- Non disponibile su quell'edizione (il motivo è nel suggerimento)
- Solo mentre sono attivi i ripieghi di Blizzard per le API deprecate
| API di gioco |  |  |  |  |  |
|---|---|---|---|---|---|
GetTime | | | | | |
canaccessvalue | | | | | |
Valori segreti (Retail e Forever)
Su Retail e Forever il gioco fornisce agli addon valori segreti. Questa funzione di supporto controlla ciò che legge (addon.Platform:CanReadValue) e restituisce nil con un motivo come restricted-value invece di un valore segreto che non può confrontare. Considera nil come non disponibile, non come false.
Esempio
local now = addon.Platform:GetHealthForecastTimeObservation()
-- value.deadline: a GetTime() timestamp chosen in the condition editor
if not now or type(value.deadline) ~= "number" then return nil end
return now >= value.deadlineDipendenze
finite→Platform.health_forecast.finite
Sorgente
Platform/health_forecast.lua, riga 130. Nel gioco è in sola lettura; Duplica crea una copia modificabile.
Platform.health_forecast.GetHealthForecastTimeObservation(self)
if type(GetTime)~='function' then return nil,'missing-api' end
local ok,now=pcall(GetTime)
if not ok then return nil,'api-error' end
if not self:CanReadValue(now) then return nil,'restricted-value' end
if canaccessvalue and not canaccessvalue(now) then return nil,'restricted-value' end
if not finite(now) then return nil,'invalid-forecast-time' end
return now