Pular para o conteúdo principal

Definir a posição do stick do controle (:set_stick)

Este método está disponível somente a partir da versão 20260805.

Declaração​

status, mensagem_de_erro = objeto_do_controle:set_stick(stick, x, y)

Parâmetros​

  • stick
    Texto: pode ser "left" ou "right"; não há distinção entre maiúsculas e minúsculas
  • x
    Número: número finito no intervalo [-1, 1]; positivo move para a direita e negativo para a esquerda
  • y
    Número: número finito no intervalo [-1, 1]; positivo move para cima e negativo para baixo

Valores de retorno​

  • status
    Booleano: retorna true quando a posição do stick é definida com sucesso; retorna false se o dispositivo estiver desconectado, ocupado ou se o envio da entrada falhar
  • mensagem de erro
    Texto: mensagem de erro quando a operação falha

Descrição​

  • 0, 0 faz o stick voltar ao centro.
  • A posição do stick muda diretamente para (x, y), sem gerar automaticamente um movimento suave.
  • Tipos de parâmetro inválidos, nomes de stick desconhecidos, números não finitos ou valores fora do intervalo são lançados como erros de parâmetro Lua.

Exemplo​

local pad = assert(gamepad.connect())

assert(pad:set_stick("left", 0.5, 1))
assert(pad:set_stick("left", 0, 0))
assert(pad:disconnect())