Platform.glyphs.GetGlyphItemInfo

Appel

addon.Platform:GetGlyphItemInfo(itemID, classID)

Disponible directement via addon ; aucune dépendance n'est nécessaire.

Ce qu'elle fait

Classe un objet numérique comme glyphe de la classe demandée, à l'aide des métadonnées d'objet natives protégées. La classe est facultative et vaut par défaut la classe lisible du joueur. Cela établit uniquement la classification de l'objet, ni son statut équipé ni la correspondance entre ID d'objet et ID de sort de glyphe.

Arguments

Nom	Type	Ce qu'elle fait
`self`	`RMPlatform`	Adaptateur de plateforme Rotation Master (implicite avec un appel par deux-points).
`itemID`	`number`	ID d'objet de glyphe, entier positif, enregistré par la condition ; les tableaux, clés d'ensemble d'objets et ID de sort ne sont pas des références d'objet.
`classID`	`number \| nil`	ID de classe positif facultatif ; nil interroge la classe actuelle du joueur sous protection.

Retours

1	`table \| nil`	Enregistrement canonique et lisible itemID/classID/subClassID lorsque l'objet est un glyphe de la classe demandée ; nil pour des métadonnées invalides ou indisponibles.
2	`string \| nil`	Motif de classification, de validation ou de disponibilité pour un résultat nil.

Éditions

Les fonctions utilitaires intégrées sont enregistrées sur toutes les éditions. Ce qui diffère, c'est l'API du jeu qu'elles lisent ; quand l'une manque, la fonction utilitaire se rabat sur une alternative ou renvoie nil avec une raison.

Indisponible sur cette édition (la raison figure dans l'infobulle)
Uniquement tant que les solutions de repli de Blizzard pour les fonctions obsolètes sont actives

API du jeu
`UnitClass`

Valeurs secrètes (Retail et Forever)

Sur Retail et Forever, le jeu transmet aux addons des valeurs secrètes. Cette fonction utilitaire vérifie ce qu'elle lit (addon.Platform:CanReadValue) et renvoie nil avec une raison telle que restricted-value au lieu d'une valeur secrète qu'elle ne peut pas comparer. Traitez nil comme indisponible, pas comme false.

Comment l'addon l'appelle

Glyphe (valid)

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

Dépendances

integer → Platform.glyphs.integer

Source

Platform/glyphs.lua, ligne 26. En lecture seule dans le jeu ; Dupliquer crée une copie modifiable.

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

Retour à Référence des fonctions