Pular para o conteúdo principal

Simular o contato de um dedo com a tela (touch.on)

Declaração​

evento_de_toque = touch.on(coordenada_x, coordenada_y)

Parâmetros​

  • coordenada x, coordenada y
    Inteiros: coordenadas do ponto de contato no sistema de coordenadas rotacionado atual

Valor de retorno​

  • evento de toque
    Objeto de evento de toque

Descrição​

Simula o contato de um dedo com uma posição específica da tela e retorna um objeto de evento de toque para controlar esse processo.
Os parâmetros de coordenadas desta função são afetados pelo sistema de coordenadas inicializado por screen.init.
Observação: esta função aloca e ocupa automaticamente um ID de dedo. A quantidade de IDs é limitada (aproximadamente 30); chamar touch.on ou touch.tap além desse limite lançará o erro finger pool overflow. Evite ocupar simultaneamente muitos IDs e chame o método :off oportunamente para liberá-los.
Esta função também pode ser chamada da forma abaixo (o ID do dedo deve ser qualquer número entre 1 e 29; nesse modo, você deve gerenciar os IDs manualmente):

touch.on(ID_do_dedo, coordenada_x, coordenada_y)

Exemplo​

-- simula o contato de um dedo com o ponto 100, 100, desliza uniformemente até 200, 200 e solta
touch.on(100, 100):move(200, 200):off()

touch.on(1, 100, 100) -- simula o contato do dedo número 1 com o ponto 100, 100
touch.off(1)          -- solta o dedo número 1