Menangani ketukan di tampilan jam

Pengguna dapat berinteraksi dengan tampilan jam Anda dalam berbagai cara. Misalnya, pengguna dapat mengetuk tampilan jam untuk mengetahui lagu yang sedang diputar atau melihat agenda hari itu. Wear OS by Google memungkinkan tampilan jam menerima gestur ketukan tunggal di lokasi tertentu pada tampilan jam, selama tidak ada elemen UI lain yang juga merespons gestur tersebut.

Untuk mengimplementasikan tampilan jam interaktif, pertama-tama buat gaya tampilan jam, lalu implementasikan penanganan gestur seperti yang dijelaskan dalam panduan ini.

Menangani peristiwa ketukan

Tampilan jam hanya diberi peristiwa ketuk, yang merupakan peristiwa ketika pengguna meletakkan jari pada layar di bawah, lalu mengangkatnya. Jika pengguna melakukan jenis gestur lainnya saat jarinya ada di layar sentuh, tampilan jam akan menerima peristiwa batal, karena semua gestur lainnya direservasi oleh sistem untuk fungsi lainnya.

Untuk menangani gestur ketuk, gunakan setTapListener() untuk menambahkan TapListener. Pemroses dipanggil setiap kali pengguna mengetuk tampilan jam.

Tampilan jam menerima jenis peristiwa sentuh berikut:

  • TapType.DOWN: saat pengguna meletakkan jarinya di layar sentuh

  • TapType.UP: saat pengguna mengangkat jari dari layar sentuh

  • TapType.CANCEL: saat sistem mendeteksi bahwa pengguna melakukan gestur selain ketukan

Peristiwa TapType.DOWN dan peristiwa TapType.UP berturut-turut diverifikasi sebagai ketukan sesuai dengan nilai yang ditampilkan oleh android.view.ViewConfiguration.getScaledTouchSlop.

Jangan picu tindakan saat tampilan jam menerima peristiwa TapType.CANCEL , karena sistem sudah memproses gestur.

Untuk informasi selengkapnya, lihat onTapEvent.

Aplikasi contoh tampilan jam menunjukkan praktik terbaik untuk mengonfigurasi tampilan jam.