Справочник › Справочник функций › Platform

Platform.rotation_owner.GetPlayerOwnerClassObservation

общедоступный

Как вызывать

addon.Platform:GetPlayerOwnerClassObservation()

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

Что делает

Прочитать свежее защищённое наблюдение UnitClass для player, чтобы определить владельца ротации. Используется только читаемое непустое имя файла класса из второго возвращаемого значения. Чтения существования, уровня, транспорта, семейства или боевой политики не добавляются, и результат не сохраняется между вызовами. Ядро по-прежнему отдельно проверяет токен класса и ключ персонажа; переопределённые поставщики контекста сохраняют свой полный исходный путь.

Аргументы

ИмяТипЧто делает
selfRMPlatformАдаптер платформы Rotation Master (неявно при вызове через двоеточие).

Возвращает

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

Издания

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

  • Недоступно в этом издании (причина — во всплывающей подсказке)
  • Только пока включены запасные реализации Blizzard для устаревших функций
Игровой APIClassic EraTBC AnniversaryClassic ProgressionForeverRetail
UnitClassClassic EraTBC AnniversaryClassic ProgressionForeverRetail
canaccessvalueClassic EraTBC AnniversaryClassic ProgressionForeverRetail

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

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

Пример

local class = addon.Platform:GetPlayerOwnerClassObservation()
if class == nil then return nil end
return class == "DRUID"

Исходный код

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

Platform.rotation_owner.GetPlayerOwnerClassObservation(self)
    if type(UnitClass)~='function' then return nil,'missing-api' end
    local ok,_,class=pcall(UnitClass,'player')
    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,'class-data-unavailable' end
    if type(class)~='string' or class=='' then return nil,'invalid-api-result' end
    return class

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