Platform.glyphs.GetGlyphItemInfo

Как вызывать

addon.Platform:GetGlyphItemInfo(itemID, classID)

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

Что делает

Определить, является ли числовой предмет символом для запрошенного класса, используя защищённые встроенные метаданные предмета. Класс необязателен и по умолчанию равен читаемому классу игрока. Устанавливается только классификация предмета, а не то, надет ли он, и не соответствие предмета ID заклинания символа.

Аргументы

Имя	Тип	Что делает
`self`	`RMPlatform`	Адаптер платформы Rotation Master (неявно при вызове через двоеточие).
`itemID`	`number`	Положительный целый ID предмета-символа, сохранённый условием; массивы, ключи комплектов и ID заклинаний не являются ссылками на предметы.
`classID`	`number \| nil`	Необязательный положительный ID класса; при nil под защитой запрашивается текущий класс игрока.

Возвращает

1	`table \| nil`	Читаемая каноническая запись itemID/classID/subClassID, если предмет — символ для запрошенного класса; nil для некорректных или недоступных метаданных.
2	`string \| nil`	Причина классификации, проверки или недоступности для результата nil.

Издания

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

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

Игровой API
`UnitClass`

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

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

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

Символ (valid)

return addon.Platform:GetGlyphItemInfo(value.item, unit_class_num) ~= nil

Зависимости

integer → Platform.glyphs.integer

Исходный код

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

Platform.glyphs.GetGlyphItemInfo(self, itemID, classID)

    if not self:CanReadValue(itemID) or not self:CanReadValue(classID) then return nil,'restricted-value' end
    if not integer(itemID,1) then return nil,'invalid-item' end
    if classID==nil then
        if type(UnitClass)~='function' then return nil,'missing-api' end
        local ok,tuple=pcall(function() return {UnitClass('player')} end)
        if not ok then return nil,'api-error' end
        classID=tuple[3]
        if not self:CanReadValue(classID) then return nil,'restricted-value' end
        if classID==nil then return nil,'class-data-unavailable' end
    end
    if not integer(classID,1) then return nil,'invalid-class' end
    local record,reason=self:GetItemInfoInstant(itemID)
    if not record then return nil,reason end
    if record.classID~=16 or record.subClassID~=classID then return nil,'invalid-glyph-item' end
    return record

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