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 AndroidMotionEvent'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österenMotionEventsabiti. 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österenMotionEventsabiti.FLAG_CANCELED: İşaretçinin yukarı hareket etmesinin istenmeyen bir dokunma etkinliğine neden olduğunu gösterenMotionEventsabiti. Android 13 (API düzeyi 33) ve sonraki sürümlerdeACTION_POINTER_UPveACTION_CANCELetkinliklerine 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_CANCELdeğerini kontrol edin. Android 13 ve sonraki sürümlerde, dokunmanın yanlışlıkla yapıldığını doğrulamak içinFLAG_CANCELEDdeğerini de kontrol edin. - Çoklu işaretçi etkinlikleri: Android 13 ve sonraki sürümlerde, istenmeyen dokunmaları belirlemek için
ACTION_POINTER_UPveFLAG_CANCELEDdeğ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:
- Android 13 özellikleri ve API'leri: Geliştirilmiş avuç içi reddi
- Geliştirici kılavuzları
- Gelişmiş ekran kalemi özellikleri
- Büyük ekranlarda giriş uyumluluğu başlıklı makalenin Avuç içi reddi bölümü
- Codelab: Android uygulamasında ekran kalemi desteğini geliştirme