Referencia › Referencia de funciones › Platform

Platform.glyphs.GetGlyphItemInfo

pública

Llamar como

addon.Platform:GetGlyphItemInfo(itemID, classID)

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

Qué hace

Clasifica un objeto numérico como glifo de la clase solicitada, usando metadatos de objeto nativos protegidos. La clase es opcional y, por defecto, es la clase legible del jugador. Solo establece la clasificación del objeto, no si está equipado ni una correspondencia de objeto a ID de hechizo de glifo.

Argumentos

NombreTipoQué hace
selfRMPlatformAdaptador de plataforma de Rotation Master (implícito en las llamadas con dos puntos).
itemIDnumberID de objeto de glifo entero positivo guardado por la condición; las matrices, las claves de conjuntos de objetos y los ID de hechizo no son referencias de objeto.
classIDnumber | nilID de clase positivo opcional; nil consulta la clase actual del jugador de forma protegida.

Retornos

1table | nilRegistro canónico legible itemID/classID/subClassID cuando el objeto es un glifo de la clase solicitada; nil para metadatos no válidos o no disponibles.
2string | nilMotivo de clasificación, 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 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 juegoClassic EraTBC AnniversaryClassic ProgressionForeverRetail
UnitClassClassic EraTBC AnniversaryClassic ProgressionForeverRetail

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.

Cómo la llama el addon

  • Glifo (valid)
    return addon.Platform:GetGlyphItemInfo(value.item, unit_class_num) ~= nil

Dependencias

Código fuente

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

Platform.glyphs.GetGlyphItemInfo(self, itemID, classID)
    if not self:CanReadValue(itemID) or not self:CanReadValue(classID) then return nil,'restricted-value' end
    if not integer(itemID,1) then return nil,'invalid-item' end
    if classID==nil then
        if type(UnitClass)~='function' then return nil,'missing-api' end
        local ok,tuple=pcall(function() return {UnitClass('player')} end)
        if not ok then return nil,'api-error' end
        classID=tuple[3]
        if not self:CanReadValue(classID) then return nil,'restricted-value' end
        if classID==nil then return nil,'class-data-unavailable' end
    end
    if not integer(classID,1) then return nil,'invalid-class' end
    local record,reason=self:GetItemInfoInstant(itemID)
    if not record then return nil,reason end
    if record.classID~=16 or record.subClassID~=classID then return nil,'invalid-glyph-item' end
    return record

Volver a Referencia de funciones