Platform.unit_attackability.GetUnitAttackabilityObservation

Llamar como

addon.Platform:GetUnitAttackabilityObservation(unit)

Disponible directamente a través de addon; no hace falta ninguna dependencia.

Qué hace

Observa si el jugador puede atacar a una unidad seleccionada que no esté muerta, usando exactamente los predicados UnitExists, UnitCanAttack y UnitIsDead. Una ausencia conocida o un resultado de ataque false legible devuelve false sin consultar la muerte. Las observaciones necesarias que faltan, fallan, están restringidas o mal formadas devuelven nil con un motivo. No comprueba fantasmas, alcance, hostilidad ni posibilidad de usar habilidades, ni redirige la propiedad de la unidad.

Argumentos

Nombre	Tipo	Qué hace
`self`	`RMPlatform`	Adaptador de plataforma de Rotation Master (implícito en las llamadas con dos puntos).
`unit`	`string`	Token de unidad seleccionado exacto; el atacante sigue siendo player.

Retornos

1	`boolean \| nil`	True para una unidad legible, atacable y no muerta; false para un resultado negativo concluyente; o nil cuando una observación necesaria no está disponible.
2	`string \| nil`	Motivo de política, validación de la consulta o disponibilidad para una posibilidad de ataque nil.

Ediciones

Las funciones auxiliares integradas se registran en todas las ediciones. Lo que cambia es la API del juego que leen; donde falta alguna, la función auxiliar recurre a una alternativa o devuelve nil con un motivo.

No disponible en esa edición (el motivo aparece en la información emergente)
Solo mientras estén activas las alternativas de Blizzard para API obsoletas

API del juego
`UnitCanAttack`
`UnitExists`
`UnitIsDead`

Valores secretos (Retail y Forever)

En Retail y Forever, el juego entrega a los addons valores secretos. Esta función auxiliar comprueba lo que lee (addon.Platform:CanReadValue) y, en lugar de un secreto que no puede comparar, devuelve nil con un motivo como restricted-value. Trata nil como no disponible, no como falso.

Ejemplo

local attackable = addon.Platform:GetUnitAttackabilityObservation("target")
if attackable == nil then return nil end
return attackable

Dependencias

readClientPolicy (builtin:Platform/unit_attackability.lua:readClientPolicy)

Código fuente

Platform/unit_attackability.lua, línea 38. Solo lectura en el juego; Duplicar crea una copia editable.

Platform.unit_attackability.GetUnitAttackabilityObservation(self, unit)

    local policy=readClientPolicy(self)
    if policy~='probe' and policy~='restricted' then return nil,'unsupported-policy' end
    if not self:CanReadValue(unit) then return nil,'restricted-value' end
    if type(unit)~='string' or unit=='' then return nil,'invalid-unit' end
    if type(UnitExists)~='function' then return nil,'missing-api' end
    local existsOk,exists=pcall(UnitExists,unit)
    if not existsOk then return nil,'api-error' end
    if not self:CanReadValue(exists) then return nil,'restricted-value' end
    if exists==nil then return nil,'unit-data-unavailable' end
    if type(exists)~='boolean' then return nil,'invalid-api-result' end
    if not exists then return false end
    if type(UnitCanAttack)~='function' then return nil,'missing-api' end
    local attackOk,attack=pcall(UnitCanAttack,'player',unit)
    if not attackOk then return nil,'api-error' end
    if not self:CanReadValue(attack) then return nil,'restricted-value' end
    if attack==nil then return nil,'attackability-data-unavailable' end
    if type(attack)~='boolean' then return nil,'invalid-api-result' end
    if not attack then return false end
    if type(UnitIsDead)~='function' then return nil,'missing-api' end
    local deadOk,dead=pcall(UnitIsDead,unit)
    if not deadOk then return nil,'api-error' end
    if not self:CanReadValue(dead) then return nil,'restricted-value' end
    if dead==nil then return nil,'death-data-unavailable' end
    if type(dead)~='boolean' then return nil,'invalid-api-result' end
    return not dead

Volver a Referencia de funciones