Platform.points.GetPlayerComboPointObservation

Как вызывать

addon.Platform:GetPlayerComboPointObservation(powerType, kind)

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

Что делает

Наблюдать явно выбранную передачу очков серии игрока в TBC. Для current используется ровно GetComboPoints(player,target); для maximum — UnitPowerMax(player,powerType) с исходным выбором. Другие семейства здесь недоступны и должны использовать свой существующий наблюдатель очков ресурса. Читаемые конечные знаковые, дробные и нулевые значения сохраняются. Отсутствующие, неудачные, ограниченные или повреждённые данные остаются недоступными; неудачный выбранный запрос очков серии никогда не переходит к UnitPower. Другие участники не наблюдаются, кэш не добавляется.

Аргументы

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

Возвращает

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

Издания

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

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

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

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

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

Пример

-- TBC only; 4 is the combo point power type
local current = addon.Platform:GetPlayerComboPointObservation(4, "current")
if current == nil then return nil end
return current >= 5

Исходный код

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

Platform.points.GetPlayerComboPointObservation(self, powerType, kind)

    local info=self:GetClientInfo()
    if info.combatDataPolicy~='probe' then return nil,'unsupported-policy' end
    local family
    if self:CanReadValue(info) and type(info)=='table' then family=rawget(info,'family') end
    if not self:CanReadValue(family) then return nil,'restricted-value' end
    if canaccessvalue and not canaccessvalue(family) then return nil,'restricted-value' end
    if family~='tbc' then return nil,'unsupported-point-transport' end
    if not self:CanReadValue(powerType) or not self:CanReadValue(kind) then return nil,'restricted-value' 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=GetComboPoints else api=UnitPowerMax end
    if type(api)~='function' then return nil,'missing-api' end
    local ok,result
    if kind=='current' then ok,result=pcall(api,'player','target') else ok,result=pcall(api,'player',powerType) end
    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

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