Как вызывать
addon.Platform:GetHealthForecastTimeObservation()
Доступен напрямую через addon; зависимость не нужна.
Что делает
Получить свежее значение защищённого вызова GetTime без аргументов для нужного прогноза здоровья. Требуются читаемость и конечное число; знаковые и дробные значения сохраняются без ограничений монотонности, целочисленности или неотрицательности. Кэш часов и дополнительные встроенные запросы не используются.
Аргументы
| Имя | Тип | Что делает |
|---|---|---|
self | RMPlatform | Адаптер платформы Rotation Master (неявно при вызове через двоеточие). |
Возвращает
| 1 | number | nil | Свежие читаемые конечные часы или nil, если недоступны. |
|---|---|---|
| 2 | string | nil | Причина недоступности возможности или наблюдения часов. |
Издания
Встроенные помощники регистрируются во всех изданиях. Различается игровой API, который они читают; если нужного API нет, помощник использует запасной вариант или возвращает nil с причиной.
- Недоступно в этом издании (причина — во всплывающей подсказке)
- Только пока включены запасные реализации Blizzard для устаревших функций
| Игровой API |  |  |  |  |  |
|---|---|---|---|---|---|
GetTime | | | | | |
canaccessvalue | | | | | |
Секретные значения (Retail и Forever)
В Retail и Forever игра передаёт аддонам секретные значения. Этот помощник проверяет то, что читает (addon.Platform:CanReadValue), и вместо секретного значения, которое нельзя сравнить, возвращает nil с причиной, например restricted-value. Считайте nil недоступным значением, а не ложью.
Пример
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.deadlineЗависимости
finite→Platform.health_forecast.finite
Исходный код
Platform/health_forecast.lua, строка 130. В игре только для чтения; «Дублировать» создаёт редактируемую копию.
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