Referência › Referência de funções › Core

Core.point_conditions.GetConditionPointResourceV2

pública

Chame como

addon:GetConditionPointResourceV2(unit, cache)

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

O que faz

Resolve recursos de pontos usando o mapeamento de classe ao vivo original e o cache de identidade, com uma política explícita de transporte alternativo de ComboPoints para o jogador do TBC. Uma alternativa do jogador que corresponda à tabela bruta legível Enum.PowerType e ao valor ComboPoints capturado no carregamento do módulo seleciona target-combo; entradas explícitas do mapa de classes, outros atores e outras famílias mantêm power. Uma procedência da alternativa substituída, herdada ou não comprovável mantém power. Esta política versionada não afirma que o UnitPower nativo esteja quebrado nem que seja equivalente. Ausência conhecida da unidade retorna false; observações necessárias indisponíveis retornam nil com um motivo. Nenhuma quantidade atual ou máxima é consultada aqui.

Argumentos

NomeTipoO que faz
selfRMAddonInstância do addon Rotation Master (implícita nas chamadas com dois-pontos).
unitstringToken de unidade selecionado exato; apenas o token literal player pode selecionar o transporte de combo do TBC.
cachetable | nilCache da passada de avaliação, ou nil para observar a identidade diretamente. Observações bem-sucedidas da classe do jogador podem usar o cache de identidade de longo prazo existente; o mapeamento de recursos continua ao vivo.

Retornos

1number | boolean | nilSeletor inteiro não negativo explícito, false para ausência conhecida da unidade ou nil quando dados necessários estão indisponíveis.
2string | nilMotivo de política, validação da consulta ou disponibilidade da identidade/seletor para um seletor nil.
3string | nilApenas em um recurso selecionado: target-combo para a alternativa explícita do jogador do TBC ou power para o transporte existente da unidade selecionada.

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 jogoClassic EraTBC AnniversaryClassic ProgressionForeverRetail
EnumClassic EraTBC AnniversaryClassic ProgressionForeverRetail
canaccessvalueClassic EraTBC AnniversaryClassic ProgressionForeverRetail

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.

Como o addon a chama

  • Pontos (evaluate)
    local point,reason,transport=addon:GetConditionPointResourceV2(value.unit,cache)

Dependências

Código-fonte

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

Core.point_conditions.GetConditionPointResourceV2(self, unit, cache)
    local platform=self.Platform
    local info=platform:GetClientInfo()
    local policy=info.combatDataPolicy
    if policy~='probe' and policy~='restricted' 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 family=info.family
    if policy=='probe' and (family=='era' or family=='progression') then return editionPointResource(platform,info,unit,record.class,cache) 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 fallbackEnum,fallbackTypes
    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
        fallbackEnum,fallbackTypes=enum,types
    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
    if policy=='restricted' and not platform:IsNeverSecretPointPower(selected) then return nil,'unsupported-policy' end
    local transport='power'
    if unit=='player' and fallbackTypes then
        local rawTypes,rawCombo=rawget(fallbackEnum,'PowerType'),rawget(fallbackTypes,'ComboPoints')
        if platform:CanReadValue(pointComboTypes) and (not canaccessvalue or canaccessvalue(pointComboTypes))
            and platform:CanReadValue(rawTypes) and (not canaccessvalue or canaccessvalue(rawTypes))
            and rawequal(fallbackTypes,pointComboTypes) and rawequal(rawTypes,fallbackTypes)
            and platform:CanReadValue(rawCombo) and (not canaccessvalue or canaccessvalue(rawCombo)) and rawCombo==selected
            and platform:CanReadValue(pointComboValue) and (not canaccessvalue or canaccessvalue(pointComboValue))
            and pointComboValue==selected then
            local family
            if platform:CanReadValue(info) and type(info)=='table' then family=rawget(info,'family') end
            if platform:CanReadValue(family) and (not canaccessvalue or canaccessvalue(family)) and family=='tbc' then transport='target-combo' end
        end
    end
    return selected,nil,transport

Voltar para Referência de funções