Platform.unit_identity.GetUnitIdentityObservation

Как вызывать

addon.Platform:GetUnitIdentityObservation(unit, otherunit)

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

Что делает

Сравнить два точных токена юнитов через UnitIsUnit после проверки только первого токена через UnitExists. Читаемое отсутствие первого юнита возвращает false без сравнения. Отсутствующие, неудачные, ограниченные или повреждённые обязательные наблюдения возвращают nil с причиной. Второй запрос существования, поиск GUID или выведенная идентичность не добавляются.

Аргументы

Имя	Тип	Что делает
`self`	`RMPlatform`	Адаптер платформы Rotation Master (неявно при вызове через двоеточие).
`unit`	`string`	Первый точный токен юнита, проверяемый на существование перед сравнением.
`otherunit`	`string`	Второй точный токен юнита, передаваемый без изменений в UnitIsUnit.

Возвращает

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

Издания

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

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

Игровой API
`UnitExists`
`UnitIsUnit`

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

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

Пример

local same = addon.Platform:GetUnitIdentityObservation("targettarget", "player")
if same == nil then return nil end
return same -- the target is attacking you

Исходный код

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

Platform.unit_identity.GetUnitIdentityObservation(self, unit, otherunit)

    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(otherunit) then return nil,'restricted-value' end
    if type(unit)~='string' or unit=='' or type(otherunit)~='string' or otherunit=='' then return nil,'invalid-unit' 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 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 false end
    if type(UnitIsUnit)~='function' then return nil,'missing-api' end
    local ok,same=pcall(UnitIsUnit,unit,otherunit)
    if not ok then return nil,'api-error' end
    if not self:CanReadValue(same) then return nil,'restricted-value' end
    if same==nil then return nil,'unit-identity-unavailable' end
    if type(same)~='boolean' then return nil,'invalid-api-result' end
    return same

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