Platform.role.GetTalentGroupRoleObservation

Как вызывать

addon.Platform:GetTalentGroupRoleObservation(group)

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

Что делает

Наблюдать первый результат роли точного старого вызова GetTalentGroupRole(group) через точку на клиентах с политикой проверки или ограничения. Читаемая выбранная группа передаётся без изменений, включая nil как один аргумент; границы группы не выводятся, другой API не подставляется, юнит игрока не запрашивается. Полное старое объявление основной роли не устанавливается. Отсутствующие, неудачные, ограниченные, пустые или повреждённые данные роли недоступны; читаемые непустые будущие строки сохраняются точно.

Аргументы

Имя	Тип	Что делает
`self`	`RMPlatform`	Адаптер платформы Rotation Master (неявно при вызове через двоеточие).
`group`	`any`	Действующий аргумент выбранной группы талантов, передаётся без изменений одним аргументом после проверки читаемости.

Возвращает

1	`string \| nil`	Известная непустая строка роли или nil, если недоступно.
2	`string \| nil`	Причина недоступности по политике, возможности или обязательному наблюдению.

Издания

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

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

Игровой API
`GetTalentGroupRole`

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

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

Пример

local group = GetActiveTalentGroup and GetActiveTalentGroup()
local role = addon.Platform:GetTalentGroupRoleObservation(group)
if role == nil then return nil end
return role == "TANK"

Зависимости

readField → Platform.role.readField
roleValue → Platform.role.roleValue

Исходный код

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

Platform.role.GetTalentGroupRoleObservation(self, group)

    local policy=self:GetCombatDataPolicy()
    if policy~='probe' and policy~='restricted' then return nil,'unsupported-policy' end
    if not self:CanReadValue(group) then return nil,'restricted-value' end
    local query,reason=readField(self,_G,'GetTalentGroupRole')
    if reason then return nil,reason end
    if type(query)~='function' then return nil,'missing-api' end
    local ok,role=pcall(query,group)
    if not ok then return nil,'api-error' end
    return roleValue(self,role)

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