调用方式
Platform.casting.interruptibility(flag)
记录依赖项 Platform.casting.interruptibility,然后按该名称调用。带命名空间的调用不会传入 self:请使用冒号调用,或自行传入该对象。
作用
Converts the native notInterruptible flag of a cast or channel into an interruptible Boolean (its inverse). Returns nil with "restricted-value" for a secret flag, "interruptibility-unavailable" when the flag is nil, or "invalid-api-result" when it is not a Boolean.
参数
| 名称 | 类型 | 作用 |
|---|---|---|
flag | boolean | nil | Native notInterruptible value from UnitCastingInfo or UnitChannelInfo. |
返回值
| 1 | boolean | nil | True when the cast can be interrupted, false when it cannot; nil when unavailable. |
|---|---|---|
| 2 | string | nil | Reason when the result is nil. |
版本
内置辅助函数在每个版本上都会注册。不同的是它们读取的游戏 API;某个 API 缺失时,辅助函数会改用后备方案,或返回 nil 并附上原因。
它不直接读取任何游戏 API。
秘密值(正式服和永久服)
在正式服和永久服上,游戏交给插件的是秘密值。此辅助函数会检查它读取的内容(addon.Platform:CanReadValue),遇到无法比较的秘密值时返回 nil 并附上原因(例如 restricted-value),而不是返回该秘密值。请将 nil 视为不可用,而不是假。
插件如何调用它
Platform.casting.GetUnitCastObservationrecord.interruptible,record.interruptibleReason=interruptibility(tuple[kind=='cast' and 8 or 7])
依赖项
platform(builtin:Platform/casting.lua:platform)
源码
Platform/casting.lua,第 64 行。在游戏中为只读;“复制”会生成一份可编辑的副本。
Platform.casting.interruptibility(flag)
if not platform:CanReadValue(flag) then return nil,'restricted-value' end
if flag==nil then return nil,'interruptibility-unavailable' end
if type(flag)~='boolean' then return nil,'invalid-api-result' end
return not flag