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())