Platform.points.GetUnitPointFragmentObservation

Как вызывать

addon.Platform:GetUnitPointFragmentObservation(unit, powerType, kind)

Доступен напрямую через addon; зависимость не нужна.

Что делает

Наблюдать очки ресурса, которые клиент сообщает частями (Раскаленные угли в Mists of Pandaria). Для current используется ровно UnitPower(unit,powerType,true), для maximum — UnitPowerMax(unit,powerType,true); результат делится на MAX_POWER_PER_EMBER от Blizzard (10), поэтому 35 частей — это 3,5. Только политика проверки. Отсутствующие, неудачные, ограниченные или повреждённые данные остаются недоступными; запрос в целых единицах никогда не используется как запасной вариант. Кэш не добавляется.

Аргументы

Имя	Тип	Что делает
`self`	`RMPlatform`	Адаптер платформы Rotation Master (неявно при вызове через двоеточие).
`unit`	`string`	Точный непустой токен юнита, передаётся без изменений.
`powerType`	`number`	Явный читаемый конечный неотрицательный целочисленный выбор ресурса.
`kind`	`string`	Ровно current для UnitPower или maximum для UnitPowerMax.

Возвращает

1	`number \| nil`	Конечное количество в целых единицах с дробной частью; nil, если недоступно.
2	`string \| nil`	Причина по политике, проверке запроса или недоступности обязательного наблюдения для количества nil.

Издания

Встроенные помощники регистрируются во всех изданиях. Различается игровой API, который они читают; если нужного API нет, помощник использует запасной вариант или возвращает nil с причиной.

Недоступно в этом издании (причина — во всплывающей подсказке)
Только пока включены запасные реализации Blizzard для устаревших функций

Игровой API
`UnitPower`
`UnitPowerMax`
`canaccessvalue`

Секретные значения (Retail и Forever)

В Retail и Forever игра передаёт аддонам секретные значения. Этот помощник проверяет то, что читает (addon.Platform:CanReadValue), и вместо секретного значения, которое нельзя сравнить, возвращает nil с причиной, например restricted-value. Считайте nil недоступным значением, а не ложью.

Пример

local embers = Enum.PowerType.BurningEmbers
if not embers then return nil end
local current = addon.Platform:GetUnitPointFragmentObservation("player", embers, "current")
if current == nil then return nil end
return current >= 3.5

Зависимости

pointFragmentsPerWhole (builtin:Platform/points.lua:pointFragmentsPerWhole)

Исходный код

Platform/points.lua, строка 162. В игре только для чтения; «Дублировать» создаёт редактируемую копию.

Platform.points.GetUnitPointFragmentObservation(self, unit, powerType, kind)

    if self:GetCombatDataPolicy()~='probe' then return nil,'unsupported-policy' end
    if not self:CanReadValue(unit) or not self:CanReadValue(powerType) or not self:CanReadValue(kind) then return nil,'restricted-value' end
    if type(unit)~='string' or unit=='' then return nil,'invalid-unit' end
    if type(powerType)~='number' or powerType~=powerType or powerType<0 or powerType==math.huge or powerType%1~=0 then return nil,'invalid-point-power-query' end
    if kind~='current' and kind~='maximum' then return nil,'invalid-point-power-query' end
    local api
    if kind=='current' then api=UnitPower else api=UnitPowerMax end
    if type(api)~='function' then return nil,'missing-api' end
    local ok,result=pcall(api,unit,powerType,true)
    if not ok then return nil,'api-error' end
    if not self:CanReadValue(result) then return nil,'restricted-value' end
    if canaccessvalue and not canaccessvalue(result) then return nil,'restricted-value' end
    if result==nil then return nil,'point-power-unavailable' end
    if type(result)~='number' or result~=result or result==math.huge or result==-math.huge then return nil,'invalid-api-result' end
    return result/pointFragmentsPerWhole

Назад: Справочник функций