Conditions.weapon.swingSpeed

Как вызывать

Conditions.weapon.swingSpeed(value, cache)

Запишите зависимость Conditions.weapon.swingSpeed и вызывайте её по этому имени. Вызов через пространство имён не передаёт self: используйте вызов через двоеточие или передайте объект сами.

Что делает

Reads the player's main-hand, or off-hand when value.offhand is set, attack speed from the cached UnitAttackSpeed for the swing timer conditions. An off-hand check with no off-hand speed returns false.

Аргументы

Имя	Тип	Что делает
`value`	`table`	Condition settings; a truthy offhand field selects the off hand.
`cache`	`table \| nil`	Evaluation-pass cache passed to getCached, or nil to read directly.

Возвращает

1	`number \| boolean \| nil`	Swing speed in seconds, false when there is no off-hand weapon, or nil when unavailable.
2	`string \| nil`	Reason for nil: missing-api, api-error, restricted-value or invalid-weapon-observation.

Издания

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

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

Игровой API
`UnitAttackSpeed`
`UnitRangedDamage`

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

Время удара оружием (evaluate)
```
local speed,reason=swingSpeed(value,cache)
```
Оставшееся время до удара (evaluate)
```
local speed,reason=swingSpeed(value,cache)
```

Зависимости

Functions.cache.getCached → Functions.cache.getCached
Functions.presentation.compareString → Functions.presentation.compareString
Functions.presentation.nullable → Functions.presentation.nullable
Functions.values.compare → Functions.values.compare
Functions.values.isin → Functions.values.isin
numericObservation → Conditions.weapon.numericObservation

Исходный код

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

Conditions.weapon.swingSpeed(value, cache)

    -- Ranged: the Auto Shot or wand interval (UnitRangedDamage), false with no
    -- ranged attack; the melee hands read UnitAttackSpeed.
    if value.ranged then
        local speed,reason=Functions.cache.getCached(cache,addon.Platform.GetRangedSwingSpeed,addon.Platform)
        if speed==nil then return nil,reason end
        return speed
    end
    if type(UnitAttackSpeed)~="function" then return nil,"missing-api" end
    -- pcall forwards the mainhand and offhand speeds from the observation.
    ---@diagnostic disable-next-line: unbalanced-assignments
    local ok,main,off=pcall(addon.getCached,cache,UnitAttackSpeed,"player")
    if not ok then return nil,"api-error" end
    local speed=main
    if value.offhand then
        speed=off
        -- No off-hand weapon: the API returns no off-hand speed. That is a
        -- reading (nothing to swing), so off-hand checks are false.
        if speed==nil then return false end
    end
    return numericObservation(speed)

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