Platform.points.GetUnitPointIdentityObservation

Как вызывать

addon.Platform:GetUnitPointIdentityObservation(unit, includeClass)

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

Что делает

Наблюдать точное существование выбранного юнита и, при необходимости, имя файла его класса для условий по очкам ресурса. Известное отсутствие возвращает exists=false без чтения класса. Для присутствующих юнитов по запросу нужно только второе возвращаемое значение UnitClass; неиспользуемые локализованные названия и ID на доступность не влияют. Отсутствующие, неудачные, ограниченные или повреждённые обязательные наблюдения остаются недоступными. Ресурс не выбирается, идентичность не кэшируется.

Аргументы

Имя	Тип	Что делает
`self`	`RMPlatform`	Адаптер платформы Rotation Master (неявно при вызове через двоеточие).
`unit`	`string`	Точный токен юнита, передаваемый без изменений в UnitExists и, при необходимости, в UnitClass.
`includeClass`	`boolean`	true также требует имя файла класса присутствующего юнита; false читает только существование.

Возвращает

1	`table \| nil`	Читаемая запись с логическим exists и, если юнит есть, запрошенным именем файла класса; nil, если обязательные данные недоступны.
2	`string \| nil`	Причина по политике, проверке запроса или недоступности обязательного наблюдения для записи nil.

Издания

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

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

Игровой API
`UnitClass`
`UnitExists`
`canaccessvalue`

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

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

Пример

local record = addon.Platform:GetUnitPointIdentityObservation("target", true)
if not record then return nil end
return record.exists and record.class == "ROGUE"

Исходный код

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

Platform.points.GetUnitPointIdentityObservation(self, unit, includeClass)

    local policy=self:GetCombatDataPolicy()
    if policy~='probe' and policy~='restricted' then return nil,'unsupported-policy' end
    if not self:CanReadValue(unit) or not self:CanReadValue(includeClass) then return nil,'restricted-value' end
    if type(unit)~='string' or unit=='' then return nil,'invalid-unit' end
    if type(includeClass)~='boolean' then return nil,'invalid-point-identity-query' end
    if type(UnitExists)~='function' then return nil,'missing-api' end
    local existsOK,exists=pcall(UnitExists,unit)
    if not existsOK then return nil,'api-error' end
    if not self:CanReadValue(exists) then return nil,'restricted-value' end
    if canaccessvalue and not canaccessvalue(exists) then return nil,'restricted-value' end
    if exists==nil then return nil,'unit-data-unavailable' end
    if type(exists)~='boolean' then return nil,'invalid-api-result' end
    if not exists then return {exists=false} end
    if not includeClass then return {exists=true} end
    if type(UnitClass)~='function' then return nil,'missing-api' end
    local ok,_,class=pcall(UnitClass,unit)
    if not ok then return nil,'api-error' end
    if not self:CanReadValue(class) then return nil,'restricted-value' end
    if canaccessvalue and not canaccessvalue(class) then return nil,'restricted-value' end
    if class==nil then return nil,'point-class-unavailable' end
    if type(class)~='string' or class=='' then return nil,'invalid-api-result' end
    return {exists=true,class=class}

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