Platform.creature_type.GetUnitCreatureTypeID

Appel

addon.Platform:GetUnitCreatureTypeID(unit)

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

Ce qu'elle fait

Observe l'identité de créature à partir de la deuxième valeur renvoyée par UnitCreatureType sur les clients en politique de sondage ou restreinte. Vérifie d'abord UnitExists(unit) exactement ; un false lisible renvoie false sans exiger ni appeler les métadonnées de créature. Une unité présente exige un ID numérique lisible et fini ; le nom localisé inutilisé n'affecte pas la disponibilité. Les ID signés, fractionnaires, nuls et futurs finis sont conservés comme valeurs connues. Les faits requis manquants, en échec, nil, restreints ou mal formés renvoient nil avec un motif. Aucune énumération de créatures, comparaison de libellés traduits ni cache à long terme n'est ajouté.

Arguments

Nom	Type	Ce qu'elle fait
`self`	`RMPlatform`	Adaptateur de plateforme Rotation Master (implicite avec un appel par deux-points).
`unit`	`string`	Identifiant d'unité sélectionné, lisible et non vide, passé tel quel comme argument unique aux requêtes d'existence et de métadonnées de créature.

Retours

1	`number \| boolean \| nil`	ID de créature natif fini, false pour une absence d'unité connue, ou nil si des observations requises sont indisponibles.
2	`string \| nil`	Motif de politique, de validation de la requête ou de disponibilité d'une observation requise pour un ID 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
`UnitCreatureType`
`UnitExists`
`canaccessvalue`

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.

Exemple

local id = addon.Platform:GetUnitCreatureTypeID("target")
if id == nil then return nil end
-- false (no target) never equals 6, the Undead creature type.
return id == 6

Source

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

Platform.creature_type.GetUnitCreatureTypeID(self, unit)

    local policy=self:GetCombatDataPolicy()
    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
    local native=UnitCreatureType
    if type(native)~='function' then return nil,'missing-api' end
    local observed,_,id=pcall(native,unit)
    if not observed then return nil,'api-error' end
    if not self:CanReadValue(id) then return nil,'restricted-value' end
    if canaccessvalue and not canaccessvalue(id) then return nil,'restricted-value' end
    if id==nil then return nil,'unit-creature-type-unavailable' end
    if type(id)~='number' or id~=id or id==math.huge or id==-math.huge then return nil,'invalid-api-result' end
    return id

Retour à Référence des fonctions