Referencia › Referencia de funciones › Platform

Platform.rotation_owner.GetPlayerOwnerClassObservation

pública

Llamar como

addon.Platform:GetPlayerOwnerClassObservation()

Disponible directamente a través de addon; no se necesita ninguna dependencia.

Qué hace

Lee una observación nueva y protegida de UnitClass del jugador para la propiedad de las rotaciones. Solo consume el nombre de archivo de clase legible y no vacío del segundo retorno. No se agrega ninguna lectura de existencia, nivel, vehículo, familia ni política de combate, y ningún resultado persiste entre llamadas. La propiedad del núcleo sigue validando por separado el token de clase y la clave del personaje; los proveedores de contexto sustituidos conservan su ruta original completa.

Argumentos

NombreTipoQué hace
selfRMPlatformAdaptador de plataforma de Rotation Master (implícito en las llamadas con dos puntos).

Retornos

1string | nilNombre de archivo de clase nuevo y legible, o nil si no está disponible.
2string | nilMotivo de disponibilidad de la capacidad o de la observación para una clase 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 usa 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
canaccessvalueClassic EraTBC AnniversaryClassic ProgressionForeverRetail

Valores secretos (Retail y Forever)

En Retail y Forever, el juego les entrega a los addons valores secretos. Esta función auxiliar verifica 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 class = addon.Platform:GetPlayerOwnerClassObservation()
if class == nil then return nil end
return class == "DRUID"

Código fuente

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

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

Volver a Referencia de funciones