Appel
addon.Platform:GetHealthForecastTimeObservation()
Disponible directement via addon ; aucune dépendance n'est nécessaire.
Ce qu'elle fait
Observe un appel protégé et frais à GetTime sans argument pour une prévision de points de vie nécessaire. Exige un nombre lisible et fini ; conserve les valeurs signées et fractionnaires sans imposer de contrainte monotone, entière ou non négative. Aucun cache d'horloge ni requête native supplémentaire n'est utilisé.
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 | Horloge fraîche, lisible et finie, ou nil si indisponible. |
|---|---|---|
| 2 | string | nil | Motif de disponibilité de la capacité ou de l'observation de l'horloge. |
É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 |  |  |  |  |  |
|---|---|---|---|---|---|
GetTime | | | | | |
canaccessvalue | | | | | |
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.
Exemple
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.deadlineDépendances
finite→Platform.health_forecast.finite
Source
Platform/health_forecast.lua, ligne 130. En lecture seule dans le jeu ; Dupliquer crée une copie modifiable.
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