Platform.role.GetInspectRoleObservation

Llamar como

addon.Platform:GetInspectRoleObservation(unit)

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

Qué hace

Observa el rol de una unidad seleccionada en clientes con política de sondeo o restringida sin emitir solicitudes de inspección. Una ausencia conocida de la unidad devuelve false. Prefiere la API de inspección moderna invocable, con la alternativa antigua solo cuando esa función no existe; un fallo de la seleccionada nunca pasa a la otra. Requiere un ID de especialización entero, positivo y finito, y solo consume el rol del quinto retorno de la llamada exacta de un argumento a GetSpecializationInfoByID. Los datos necesarios que faltan, fallan, están restringidos o mal formados no están disponibles; las cadenas de rol futuras legibles y no vacías se mantienen exactas.

Argumentos

Nombre	Tipo	Qué hace
`self`	`RMPlatform`	Adaptador de plataforma de Rotation Master (implícito en las llamadas con dos puntos).
`unit`	`string`	Token de unidad seleccionado no vacío; argumento nativo sin cambios.

Retornos

1	`string \| boolean \| nil`	Cadena de rol conocida y no vacía, false si se sabe que la unidad está ausente o nil si no está disponible.
2	`string \| nil`	Motivo de disponibilidad de la política, la capacidad o una observación necesaria.

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 juego
`C_SpecializationInfo`
`GetInspectSpecialization`
`GetSpecializationInfoByID`
`UnitExists`
`canaccessvalue`

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.

Ejemplo

local role = addon.Platform:GetInspectRoleObservation("target")
if role == nil then return nil end
return role == "HEALER"

Dependencias

readField → Platform.role.readField
roleValue → Platform.role.roleValue

Código fuente

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

Platform.role.GetInspectRoleObservation(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 namespace,reason=readField(self,_G,'C_SpecializationInfo')
    if reason then return nil,reason end
    local inspect
    if namespace~=nil then
        inspect,reason=readField(self,namespace,'GetInspectSpecialization')
        if reason then return nil,reason end
    end
    if type(inspect)~='function' then
        inspect,reason=readField(self,_G,'GetInspectSpecialization')
        if reason then return nil,reason end
    end
    if type(inspect)~='function' then return nil,'missing-api' end
    local ok,spec=pcall(inspect,unit)
    if not ok then return nil,'api-error' end
    if not self:CanReadValue(spec) then return nil,'restricted-value' end
    if canaccessvalue and not canaccessvalue(spec) then return nil,'restricted-value' end
    if spec==nil or spec==0 then return nil,'specialization-unavailable' end
    if type(spec)~='number' or spec~=spec or spec>=math.huge or spec<=0 or spec%1~=0 then return nil,'invalid-api-result' end
    local metadata
    metadata,reason=readField(self,_G,'GetSpecializationInfoByID')
    if reason then return nil,reason end
    if type(metadata)~='function' then return nil,'missing-api' end
    local roleOk,role=pcall(function() return (select(5,metadata(spec))) end)
    if not roleOk then return nil,'api-error' end
    return roleValue(self,role)

Volver a Referencia de funciones