Core.point_conditions.GetConditionPointResource

Chame como

addon:GetConditionPointResource(unit, cache)

Disponível diretamente por meio de addon; nenhuma dependência é necessária.

O que faz

Resolve o seletor de recurso de pontos da unidade selecionada usando o mapa de classe para recurso ao vivo e a alternativa ComboPoints. Ausência conhecida retorna false; dados necessários de identidade ou do seletor indisponíveis retornam nil com um motivo. Compartilha observações completas de identidade dentro da passada de avaliação. Apenas observações bem-sucedidas da classe do jogador persistem no cache de longo prazo atual, vinculadas à identidade nativa de UnitClass; a existência é atualizada a cada passada. Isso seleciona um recurso sem ler a quantidade atual ou máxima dele.

Argumentos

Nome	Tipo	O que faz
`self`	`RMAddon`	Instância do addon Rotation Master (implícita nas chamadas com dois-pontos).
`unit`	`string`	Token de unidade selecionado exato; apenas a classe do jogador pode usar o cache de longo prazo de observações bem-sucedidas.
`cache`	`table \| nil`	Cache da passada de avaliação, ou nil para observar a identidade diretamente. O mapeamento de recursos é resolvido ao vivo a cada invocação.

Retornos

1	`number \| boolean \| nil`	Seletor de poder inteiro não negativo explícito, false para uma unidade sabidamente ausente ou nil quando dados necessários estão indisponíveis.
2	`string \| nil`	Motivo de política, validação da consulta ou disponibilidade da identidade/seletor para um seletor nil.

Edições

As funções auxiliares integradas são registradas em todas as edições. O que muda é a API do jogo que elas leem; quando uma está ausente, a função auxiliar recorre a uma alternativa ou retorna nil com um motivo.

Indisponível nessa edição (o motivo está na dica)
Só enquanto as alternativas da Blizzard para APIs obsoletas estiverem ativas

API do jogo
`Enum`

Valores secretos (Retail e Forever)

No Retail e no Forever, o jogo entrega valores secretos aos addons. Esta função auxiliar verifica o que lê (addon.Platform:CanReadValue) e retorna nil com um motivo como restricted-value em vez de um valor secreto que não consegue comparar. Trate nil como indisponível, não como false.

Exemplo

local power, reason = addon:GetConditionPointResource("player", cache)
if power == nil then return nil, reason end
if power == false then return false end
return UnitPower("player", power) >= 4

Dependências

playerClassCacheKey (builtin:Core/point_conditions.lua:playerClassCacheKey)
pointIdentity → Core.point_conditions.pointIdentity

Código-fonte

Core/point_conditions.lua, linha 58. Somente leitura no jogo; Duplicar cria uma cópia editável.

Core.point_conditions.GetConditionPointResource(self, unit, cache)

    local platform=self.Platform
    if platform:GetCombatDataPolicy()~='probe' then return nil,'unsupported-policy' end
    if not platform:CanReadValue(unit) then return nil,'restricted-value' end
    if type(unit)~='string' or unit=='' then return nil,'invalid-unit' end
    local record,reason=addon.Functions.cache.getCached(cache,pointIdentity,self,unit,playerClassCacheKey)
    if not record then return nil,reason end
    if not record.exists then return false end
    local points=self.points
    if not platform:CanReadValue(points) then return nil,'restricted-value' end
    if type(points)~='table' then return nil,'invalid-point-resource-map' end
    local ok,selected=pcall(function() return points[record.class] end)
    if not ok then return nil,'api-error' end
    if not platform:CanReadValue(selected) then return nil,'restricted-value' end
    if selected==nil or selected==false then
        local enum=Enum
        if not platform:CanReadValue(enum) then return nil,'restricted-value' end
        if type(enum)~='table' then return nil,'point-resource-unavailable' end
        local typesOK,types=pcall(function() return enum.PowerType end)
        if not typesOK then return nil,'api-error' end
        if not platform:CanReadValue(types) then return nil,'restricted-value' end
        if type(types)~='table' then return nil,'point-resource-unavailable' end
        local fallbackOK,fallback=pcall(function() return types.ComboPoints end)
        if not fallbackOK then return nil,'api-error' end
        selected=fallback
        if not platform:CanReadValue(selected) then return nil,'restricted-value' end
    end
    if selected==nil then return nil,'point-resource-unavailable' end
    if type(selected)~='number' or selected~=selected or selected<0 or selected==math.huge or selected%1~=0 then return nil,'invalid-point-resource' end
    return selected

Voltar para Referência de funções