Ekran kalemiyle avuç içi reddi

Beş yıldız puanı simgesi

Ekran kalemi, son derece üretken ve yaratıcı bir araç olabilir. Ancak kullanıcılar ekran kalemiyle çizim yaparken, yazı yazarken veya bir uygulamayla etkileşimde bulunurken bazen ellerinin ayasıyla ekrana dokunurlar. Sistem, dokunma etkinliğini yanlışlıkla avuç içi dokunma olarak algılayıp reddetmeden önce bu etkinlik uygulamanıza bildirilebilir.

En iyi uygulamalar

Uygulamanız, gereksiz dokunma etkinliklerini tanımlamalı ve bunları yok saymalıdır. Jetpack Compose'da, PointerEvent üzerinden temel Android MotionEvent'e erişebilirsiniz. ACTION_CANCEL için MotionEvent öğesini kontrol edin. Bu, bir hareketin durdurulması gerektiğini ve geri alınması gerekebileceğini gösterir. Android 13 (API düzeyi 33) ve sonraki sürümlerde, ACTION_CANCEL ve ACTION_POINTER_UP etkinliklerinde FLAG_CANCELED işaretini kontrol edin. Bu işaret, dokunmanın istem dışı (ör. avuç içi dokunma) olduğuna dair güçlü bir sinyal sağlar.

Malzemeler

  • Modifier.pointerInput(): İşaretçi girişini işlemek için kullanılan Compose değiştiricisi.
  • PointerEvent: Compose'da bir veya daha fazla değişiklik içeren bir işaretçi etkinliğini temsil eder.
  • PointerEvent.motionEvent: Temel Android MotionEvent'e erişim sağlayan uzantı özelliği (boş değer atanabilir).
  • MotionEvent: Dokunma ve hareket etkinliklerini temsil eder. Bir etkinliğin dikkate alınmaması gerekip gerekmediğini belirlemek için gereken bilgileri içerir.
  • ACTION_CANCEL: Bir hareketin iptal edildiğini gösteren MotionEvent sabiti. Hareket durdurulmalı ve geri alınması gerekebilir.
  • ACTION_POINTER_UP: İlk işaretçi dışındaki bir işaretçinin yukarı gittiğini (yani cihaz ekranıyla temasını kestiğini) gösteren MotionEvent sabiti.
  • FLAG_CANCELED: İşaretçinin yukarı hareket etmesinin istenmeyen bir dokunma etkinliğine neden olduğunu gösteren MotionEvent sabiti. Android 13 (API düzeyi 33) ve sonraki sürümlerde ACTION_POINTER_UP ve ACTION_CANCEL etkinliklerine eklendi.

Adımlar

Uygulamanıza gönderilen MotionEvent nesnelerini inceleyin. Etkinlik özelliklerini belirlemek için MotionEvent API'lerini kullanın:

  • Tek işaretçi etkinlikleri: Hareketin durması gerektiğini belirten ACTION_CANCEL değerini kontrol edin. Android 13 ve sonraki sürümlerde, dokunmanın yanlışlıkla yapıldığını doğrulamak için FLAG_CANCELED değerini de kontrol edin.
  • Çoklu işaretçi etkinlikleri: Android 13 ve sonraki sürümlerde, istenmeyen dokunmaları belirlemek için ACTION_POINTER_UP ve FLAG_CANCELED değerlerini kontrol edin.

Bu etkinliklere, hareketi durdurarak ve geçici değişiklikleri geri alarak yanıt verin.

1. Hareket etkinliği nesnelerini alma

Bir Composable'da işaretçi girişini işlemek için Modifier.pointerInput kullanın. İşaretçi girişi kapsamında, etkinlikleri almak için awaitPointerEventScope ve awaitPointerEvent kullanın ve motionEvent özelliğini kullanarak temel Android MotionEvent değerini alın:

import androidx.compose.ui.input.pointer.pointerInput
    Box(
        modifier = Modifier
            .fillMaxSize()
            .pointerInput(Unit) {
                awaitPointerEventScope {
                    while (true) {
                        val event = awaitPointerEvent()
                        val motionEvent = event.motionEvent
                        if (motionEvent != null) {
                            // Process motion event.
                        }
                    }
                }
            }
    )

2. Etkinlik işlemini ve işaretlerini belirleme

Tüm API düzeylerinde tek işaretçili bir etkinliği belirten ACTION_CANCEL için MotionEvent değerini kontrol edin. Android 13 ve sonraki sürümlerde FLAG_CANCELED için ACTION_POINTER_UP ayarını kontrol edin:

import androidx.compose.ui.input.pointer.pointerInput
    Box(
        modifier = Modifier
            .fillMaxSize()
            .pointerInput(Unit) {
                awaitPointerEventScope {
                    while (true) {
                        val event = awaitPointerEvent()
                        val motionEvent = event.motionEvent ?: continue

                        when (motionEvent.actionMasked) {
                            MotionEvent.ACTION_CANCEL -> {
                                // Process canceled single-pointer motion event for all SDK versions.
                            }
                            MotionEvent.ACTION_POINTER_UP -> {
                                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU &&
                                    (motionEvent.flags and MotionEvent.FLAG_CANCELED) == MotionEvent.FLAG_CANCELED
                                ) {
                                    // Process canceled multi-pointer motion event for Android 13 and higher.
                                }
                            }
                        }
                    }
                }
            }
    )

3. Hareketi geri alma

Avuç içi dokunmayı tanımladıktan sonra hareketin ekrandaki etkilerini geri alabilirsiniz.

Uygulamanız, avuç içi dokunuşları gibi istenmeyen girişlerin geri alınabilmesi için kullanıcı işlemlerinin geçmişini tutmalıdır. Örnek için Android uygulamasında ekran kalemi desteğini geliştirme codelab'indeki Temel bir çizim uygulaması uygulama bölümüne bakın.

Sonuçlar

Uygulamanız artık Android 13 ve sonraki API düzeylerinde çoklu işaretçi etkinlikleri, tüm API düzeylerinde ise tek işaretçi etkinlikleri için avuç içi dokunmalarını tanımlayıp reddedebilir.

Ek kaynaklar

Daha fazla bilgi için aşağıdaki makaleleri inceleyin: