Platform.runes.GetRuneTypeObservation

Chame como

addon.Platform:GetRuneTypeObservation(index)

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

O que faz

Observa um único espaço de runa nativo exato usando GetRuneType com o único argumento de índice. Exige um tipo inteiro positivo, finito e legível; tipos numéricos futuros conhecidos continuam distintos do tipo selecionado, e Morte é um tipo exato, não um curinga. Observações ausentes, com falha, restritas ou malformadas continuam indisponíveis. Nenhuma consulta de classe, unidade, contagem ou runa base deduzida é adicionada.

Argumentos

Nome	Tipo	O que faz
`self`	`RMPlatform`	Adaptador de plataforma do Rotation Master (implícito nas chamadas com dois-pontos).
`index`	`number`	Espaço de runa nativo inteiro exato, de 1 a 6.

Retornos

1	`number \| nil`	Tipo de runa inteiro, positivo, finito e legível, ou nil quando indisponível.
2	`string \| nil`	Motivo de política, validação do espaço ou disponibilidade de observação necessária para um tipo 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
`GetRuneType`

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 death = 0
for index = 1, 6 do
  local runeType = addon.Platform:GetRuneTypeObservation(index)
  if runeType == nil then return nil end
  if runeType == 4 then death = death + 1 end -- 4 is a Death rune
end
return death >= 2

Dependências

numberField → Platform.runes.numberField
validIndex → Platform.runes.validIndex

Código-fonte

Platform/runes.lua, linha 48. Somente leitura no jogo; Duplicar cria uma cópia editável.

Platform.runes.GetRuneTypeObservation(self, index)

    local policy=self:GetCombatDataPolicy()
    if policy~='probe' and policy~='restricted' then return nil,'unsupported-policy' end
    local valid,reason=validIndex(self,index)
    if not valid then return nil,reason end
    local api=GetRuneType
    if type(api)~='function' then return nil,'missing-api' end
    local ok,value=pcall(api,index)
    if not ok then return nil,'api-error' end
    local runeType,why=numberField(self,value,'rune-type-unavailable')
    if runeType==nil then return nil,why end
    if runeType<=0 or runeType%1~=0 then return nil,'invalid-api-result' end
    return runeType

Voltar para Referência de funções