Platform.player_movement.GetPlayerMovementObservation

Llamar como

addon.Platform:GetPlayerMovementObservation()

Disponible directamente a través de addon; no se necesita ninguna dependencia.

Qué hace

Observa la velocidad de movimiento actual del jugador en clientes legibles compatibles. Consulta GetUnitSpeed solo para player, sin comprobar otra unidad ni redirigir la propiedad de un vehículo. Cero significa quieto; las velocidades positivas finitas fraccionarias siguen siendo válidas. Las observaciones que faltan, fallan, están restringidas o mal formadas devuelven nil con un motivo.

Argumentos

Retornos

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 usa 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	Classic Era	TBC Anniversary	Classic Progression	Forever	Retail
GetUnitSpeed
canaccessvalue

Valores secretos (Retail y Forever)

En Retail y Forever, el juego les entrega a los addons valores secretos. Esta función auxiliar verifica 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 movement = addon.Platform:GetPlayerMovementObservation()
if not movement then return nil end
return movement.speed > 0

Código fuente

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

    local policy=self:GetCombatDataPolicy()
    if policy~='probe' and policy~='restricted' then return nil,'unsupported-policy' end
    if type(GetUnitSpeed)~='function' then return nil,'missing-api' end
    local ok,speed=pcall(GetUnitSpeed,'player')
    if not ok then return nil,'api-error' end
    if not self:CanReadValue(speed) then return nil,'restricted-value' end
    if canaccessvalue and not canaccessvalue(speed) then return nil,'restricted-value' end
    if speed==nil then return nil,'movement-data-unavailable' end
    if type(speed)~='number' or speed~=speed or speed==math.huge or speed==-math.huge or speed<0 then return nil,'invalid-api-result' end
    return {speed=speed}