Llamar como
addon.Platform:GetUnitPointIdentityObservation(unit, includeClass)
Disponible directamente a través de addon; no hace falta ninguna dependencia.
Qué hace
Observa la existencia exacta de la unidad seleccionada y, opcionalmente, su nombre de archivo de clase para condiciones de recursos de puntos. Una ausencia conocida devuelve exists=false sin leer la clase. Las unidades presentes solo requieren el segundo retorno de UnitClass cuando se solicita; los nombres localizados y los ID no usados no afectan a la disponibilidad. Las observaciones necesarias que faltan, fallan, están restringidas o mal formadas siguen sin estar disponibles. No selecciona ningún recurso ni guarda la identidad en caché.
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 exacto que se pasa sin cambios a UnitExists y, cuando hace falta, a UnitClass. |
includeClass | boolean | True también requiere el nombre de archivo de clase de la unidad presente; false solo lee la existencia. |
Retornos
| 1 | table | nil | Registro legible con exists booleano y el nombre de archivo de clase solicitado cuando está presente; nil cuando faltan datos necesarios. |
|---|---|---|
| 2 | string | nil | Motivo de política, validación de la consulta o disponibilidad de una observación necesaria para un registro 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 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 |  |  |  |  |  |
|---|---|---|---|---|---|
UnitClass | | | | | |
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 record = addon.Platform:GetUnitPointIdentityObservation("target", true)
if not record then return nil end
return record.exists and record.class == "ROGUE"Código fuente
Platform/points.lua, línea 87. Solo lectura en el juego; Duplicar crea una copia editable.
Platform.points.GetUnitPointIdentityObservation(self, unit, includeClass)
local policy=self:GetCombatDataPolicy()
if policy~='probe' and policy~='restricted' then return nil,'unsupported-policy' end
if not self:CanReadValue(unit) or not self:CanReadValue(includeClass) then return nil,'restricted-value' end
if type(unit)~='string' or unit=='' then return nil,'invalid-unit' end
if type(includeClass)~='boolean' then return nil,'invalid-point-identity-query' 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 canaccessvalue and not canaccessvalue(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 {exists=false} end
if not includeClass then return {exists=true} end
if type(UnitClass)~='function' then return nil,'missing-api' end
local ok,_,class=pcall(UnitClass,unit)
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,'point-class-unavailable' end
if type(class)~='string' or class=='' then return nil,'invalid-api-result' end
return {exists=true,class=class}