Processar toques em mostradores de relógio

Um usuário pode interagir com o mostrador do relógio de muitas formas. Por exemplo, ele pode tocar no mostrador do relógio para ver que música está tocando ou para ver a agenda do dia. O Wear OS by Google permite que o mostrador do relógio aceite o gesto de um toque em determinado local, contanto que não haja outro elemento da interface que também responda a esse gesto.

Para implementar um mostrador do relógio interativo, primeiro crie o estilo do mostrador e, em seguida, implemente o processamento de gestos, conforme descrito neste guia.

Processar eventos de toque

O mostrador do relógio recebe apenas eventos de toque, que são eventos em que o usuário coloca o dedo na tela e o levanta. Se o usuário realizar qualquer outro tipo de gesto enquanto o dedo estiver na tela touchscreen, o mostrador do relógio receberá um evento de cancelamento, já que todos os outros gestos são reservados pelo sistema para outras funções.

Para processar gestos de toque, use setTapListener() para adicionar um TapListener. O listener é chamado quando o usuário toca no mostrador do relógio.

O mostrador do relógio recebe os seguintes tipos de eventos de toque:

  • TapType.DOWN: quando o usuário coloca o dedo na tela touchscreen

  • TapType.UP: quando o usuário levanta o dedo na tela touchscreen

  • TapType.CANCEL: quando o sistema detecta que o usuário realiza um gesto diferente de um toque.

Um evento TapType.DOWN e o evento TapType.UP sucessivo são verificados como um toque de acordo com o valor retornado por android.view.ViewConfiguration.getScaledTouchSlop.

Não acione uma ação quando o mostrador do relógio recebe um evento TapType.CANCEL, porque o sistema já está processando o gesto.

Para mais informações, consulte onTapEvent.

O app de exemplo de mostrador do relógio (link em inglês) demonstra as práticas recomendadas para configurar um mostrador.