Core.level_conditions.GetConditionUnitLevel

Как вызывать

addon:GetConditionUnitLevel(unit, cache)

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

Что делает

Определить читаемый исходный уровень юнита для вычисления условия. Известное отсутствие возвращает false; недоступные наблюдения возвращают nil с причиной. Наблюдения кэшируются в пределах переданного прохода вычисления. Между проходами сохраняются только корректные уровни игрока — до обновления навыка, профиля или уровня.

Аргументы

Имя	Тип	Что делает
`self`	`RMAddon`	Экземпляр аддона Rotation Master (неявно при вызове через двоеточие).
`unit`	`string`	Токен юнита, исходный уровень которого нужно определить.
`cache`	`table \| nil`	Общий кэш вычисления; при nil наблюдение выполняется напрямую без кэша прохода.

Возвращает

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

Издания

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

Не читает игровой API напрямую.

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

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

Как его вызывает аддон

Уровень (evaluate)

local observed,reason=addon:GetConditionUnitLevel(value.unit,cache)

Уровень (evaluate)

local level,reason=addon:GetConditionUnitLevel("player",cache)

Исходный код

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

Core.level_conditions.GetConditionUnitLevel(self, unit, cache)

    if not self.Platform:CanReadValue(unit) then return nil,'restricted-value' end
    if type(unit)~='string' or unit=='' then return nil,'invalid-unit' end
    if self.Platform:GetClientFamily()=='unknown' then return nil,'unsupported-client' end
    local longterm=self.longtermCache
    if unit=='player' and type(longterm)=='table' then
        local level=longterm.conditionPlayerLevel
        if not self.Platform:CanReadValue(level) then return nil,'restricted-value' end
        if level~=nil then
            if type(level)~='number' or level~=level or level<=0 or level==math.huge or level%1~=0 then return nil,'invalid-api-result' end
            return level
        end
    end
    local record,reason=addon.Functions.cache.getCached(cache,self.Platform.GetUnitLevelObservation,self.Platform,unit)
    if not record then return nil,reason end
    if not record.exists then return false end
    if unit=='player' and type(longterm)=='table' then longterm.conditionPlayerLevel=record.level end
    return record.level

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