Platform.items.GetItemInfoInstant

Llamar como

addon.Platform:GetItemInfoInstant(item)

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

Qué hace

Lee los metadatos nativos normalizados de clasificación de objetos. El registro contiene itemID, classID y subClassID canónicos, además de equipLoc, el token no localizado INVTYPE_* de la ranura de equipo, cuando es legible y no está vacío; no requiere que el texto visible del objeto esté cargado. Los metadatos que faltan, fallan, están mal formados o restringidos devuelven nil con un motivo.

Argumentos

Nombre	Tipo	Qué hace
`self`	`RMPlatform`	Adaptador de plataforma de Rotation Master (implícito en las llamadas con dos puntos).
`item`	`number \| string`	ID de objeto positivo, o nombre/enlace de objeto reconocido de forma nativa, que se clasificará.

Retornos

1	`table \| nil`	Registro canónico y legible de clasificación del objeto (itemID, classID, subClassID y equipLoc opcional), o nil cuando no está disponible.
2	`string \| nil`	Motivo de validación o disponibilidad para un resultado 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 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
`C_Item.GetItemInfoInstant`
`GetItemInfoInstant`

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 item = addon.Platform:GetItemInfoInstant(5512) -- Healthstone
if not item then return nil end
return item.classID == 0 -- consumable

Dependencias

finite → Platform.items.finite
identifier → Platform.items.identifier

Código fuente

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

Platform.items.GetItemInfoInstant(self, item)

    local valid,reason=identifier(item)
    if not valid then return nil,reason end
    local fn=C_Item and C_Item.GetItemInfoInstant
    if type(fn)~='function' then fn=GetItemInfoInstant end
    if type(fn)~='function' then return nil,'missing-api' end
    local ok,tuple=pcall(function() return {fn(item)} end)
    if not ok then return nil,'api-error' end
    local id,class,subclass=tuple[1],tuple[6],tuple[7]
    if not self:CanReadValue(id) or not self:CanReadValue(class) or not self:CanReadValue(subclass) then return nil,'restricted-value' end
    if id==nil then return nil,'item-data-unavailable' end
    if not finite(id) or id<=0 or id%1~=0 or not finite(class) or class%1~=0
        or not finite(subclass) or subclass%1~=0 or type(item)=='number' and id~=item then return nil,'invalid-api-result' end
    -- The equip location is a non-localized INVTYPE_* token (two-hand,
    -- shield, ...). An empty or unreadable token is simply absent.
    local equipLoc=tuple[4]
    if not self:CanReadValue(equipLoc) or type(equipLoc)~='string' or equipLoc=='' then equipLoc=nil end
    return {itemID=id,classID=class,subClassID=subclass,equipLoc=equipLoc}

Volver a Referencia de funciones