Appel
addon.Platform:GetPlayerOwnerClassObservation()
Disponible directement via addon ; aucune dépendance n'est nécessaire.
Ce qu'elle fait
Lit une observation fraîche et protégée de UnitClass pour player afin de déterminer à qui appartient la rotation. Ne consomme que le nom de fichier de classe lisible et non vide de la deuxième valeur renvoyée. Aucune lecture d'existence, de niveau, de véhicule, de famille ou de politique de combat n'est ajoutée, et aucun résultat n'est conservé d'un appel à l'autre. Le cœur vérifie toujours séparément le jeton de classe et la clé du personnage ; les fournisseurs de contexte remplacés conservent leur chemin d'origine complet.
Arguments
| Nom | Type | Ce qu'elle fait |
|---|---|---|
self | RMPlatform | Adaptateur de plateforme Rotation Master (implicite avec un appel par deux-points). |
Retours
| 1 | string | nil | Nom de fichier de classe frais et lisible, ou nil si indisponible. |
|---|---|---|
| 2 | string | nil | Motif de disponibilité de la capacité ou de l'observation pour une classe 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 | | | | | |
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 class = addon.Platform:GetPlayerOwnerClassObservation()
if class == nil then return nil end
return class == "DRUID"Source
Platform/rotation_owner.lua, ligne 18. En lecture seule dans le jeu ; Dupliquer crée une copie modifiable.
Platform.rotation_owner.GetPlayerOwnerClassObservation(self)
if type(UnitClass)~='function' then return nil,'missing-api' end
local ok,_,class=pcall(UnitClass,'player')
if not ok then return nil,'api-error' end
if not self:CanReadValue(class) then return nil,'restricted-value' end
if canaccessvalue and not canaccessvalue(class) then return nil,'restricted-value' end
if class==nil then return nil,'class-data-unavailable' end
if type(class)~='string' or class=='' then return nil,'invalid-api-result' end
return class