Compose笔记(二十三)--多点触控

这一节主要了解一下Compose中多点触控,在Jetpack Compose 中,多点触控处理需要结合Modifier和手势API来实现,一般通过组合 pointerInput、TransformableState 和 TransformModifier 来创建支持缩放、旋转和平移的组件。

一、 API

  1. PointerInput

含义:处理低级触摸事件的主要API,支持多点触控。

用法:通过pointerInput修饰符拦截和处理触摸事件。

  1. TransformableState

含义:管理变换状态(缩放、旋转、平移)的状态容器。

用法:与transformable修饰符结合,监听手势并更新变换值。

  1. TransformModifier

含义:应用变换效果(缩放、旋转、平移)的修饰符。

用法:通过graphicsLayer或transformable应用变换。
二、关键类与接口

  1. PointerInputScope

提供处理触摸事件的作用域,包含:

detectDragGestures:处理单指拖拽。

detectTransformGestures:处理双指缩放 / 旋转。

detectTapGestures:处理点击事件。

  1. TransformScope

在detectTransformGestures中提供:

panChange:平移变化量。

zoomChange:缩放变化量。

rotationChange:旋转变化量。

  1. Transformation

包含三个变换参数:

scale:缩放因子。

rotation:旋转角度。

offset:平移偏移量。

栗子:

  1. 单指拖拽
Kotlin 复制代码
import androidx.compose.foundation.Image
import androidx.compose.foundation.background
import androidx.compose.foundation.gestures.detectDragGestures
import androidx.compose.foundation.layout.Box
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.size
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.setValue
import androidx.compose.ui.Modifier
import androidx.compose.ui.geometry.Offset
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.graphics.graphicsLayer
import androidx.compose.ui.input.pointer.consumeAllChanges
import androidx.compose.ui.input.pointer.pointerInput
import androidx.compose.ui.res.painterResource
import androidx.compose.ui.unit.dp
import com.example.composenavigationdemo.R

@Composable
fun TestImage() {
    var offset by remember { mutableStateOf(Offset.Zero) }

    Box(
        modifier = Modifier
            .size(200.dp)
            .background(Color.LightGray)
            .pointerInput(Unit) {
                detectDragGestures { change, dragAmount ->
                    // 阻止事件冒泡
                    change.consumeAllChanges()
                    // 更新偏移量
                    offset = offset + dragAmount
                }
            }
            .graphicsLayer {
                translationX = offset.x
                translationY = offset.y
            }
    ) {
        Image(
            painter = painterResource(R.drawable.android),
            contentDescription = null,
            modifier = Modifier.fillMaxSize()
        )
    }
}
  1. 双指缩放与旋转
Kotlin 复制代码
import androidx.compose.foundation.Image
import androidx.compose.foundation.background
import androidx.compose.foundation.gestures.detectTransformGestures
import androidx.compose.foundation.layout.Box
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.geometry.Offset
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.graphics.graphicsLayer
import androidx.compose.ui.input.pointer.pointerInput
import androidx.compose.ui.res.painterResource
import com.example.composenavigationdemo.R

@Composable
fun TestImage() {
    var scale by remember { mutableStateOf(1f) }
    var rotation by remember { mutableStateOf(0f) }
    var offset by remember { mutableStateOf(Offset.Zero) }

    Box(
        modifier = Modifier
            .fillMaxSize()
            .background(Color.LightGray)
            .pointerInput(Unit) {
                detectTransformGestures { centroid, pan, zoom, rotationChange ->
                    // 更新变换参数
                    scale = (scale * zoom).coerceIn(0.5f, 5f)
                    rotation += rotationChange
                    offset = centroid
                }
            }
    ) {
        Image(
            painter = painterResource(R.drawable.android),
            contentDescription = null,
            modifier = Modifier
                .align(Alignment.Center)
                .graphicsLayer {
                    scaleX = scale
                    scaleY = scale
                    rotationZ = rotation
                    translationX = offset.x - size.width / 2
                    translationY = offset.y - size.height / 2
                }
        )
    }
}

3 组合多种手势

Kotlin 复制代码
import androidx.compose.foundation.Image
import androidx.compose.foundation.background
import androidx.compose.foundation.gestures.detectDragGestures
import androidx.compose.foundation.gestures.detectTransformGestures
import androidx.compose.foundation.layout.Box
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.geometry.Offset
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.graphics.graphicsLayer
import androidx.compose.ui.input.pointer.pointerInput
import androidx.compose.ui.res.painterResource
import com.example.composenavigationdemo.R
import kotlinx.coroutines.coroutineScope
import kotlinx.coroutines.launch

@Composable
fun TestImage() {
    var scale by remember { mutableStateOf(1f) }
    var rotation by remember { mutableStateOf(0f) }
    var offset by remember { mutableStateOf(Offset.Zero) }
    var isDragging by remember { mutableStateOf(false) }

    Box(
        modifier = Modifier
            .fillMaxSize()
            .background(Color.LightGray)
            .pointerInput(Unit) {
                coroutineScope {
                    launch {
                      
                        detectDragGestures(
                            onDragStart = { isDragging = true },
                            onDragEnd = { isDragging = false }
                        ) { change, dragAmount ->
                            offset += dragAmount
                        }
                    }

                    launch {
                  
                        detectTransformGestures(
                            panZoomLock = true
                        ) { _, pan, zoom, rotationChange ->
                            scale *= zoom
                            rotation += rotationChange
                            offset += pan
                        }
                    }
                }
            }
            .graphicsLayer {
                scaleX = scale
                scaleY = scale
                rotationZ = rotation
                translationX = offset.x
                translationY = offset.y
            }
    ) {
        Image(
            painter = painterResource(R.drawable.android),
            contentDescription = null,
            modifier = Modifier.align(Alignment.Center)
        )
    }
}

注意:

1 事件消费:通过change.consumeAllChanges()阻止事件冒泡。

2 坐标系转换:注意centroid(双指中心点)和offset的坐标系差异。

3 状态管理:使用remember保存变换状态,确保配置变更后状态恢复。

相关推荐
X_StarX1 分钟前
【Unity笔记02】订阅事件-自动开门
笔记·学习·unity·游戏引擎·游戏开发·大学生
MingYue_SSS8 分钟前
开关电源抄板学习
经验分享·笔记·嵌入式硬件·学习
巴伦是只猫31 分钟前
【机器学习笔记 Ⅱ】1 神经网络
笔记·神经网络·机器学习
weixin_4373982138 分钟前
转Go学习笔记(2)进阶
服务器·笔记·后端·学习·架构·golang
teeeeeeemo2 小时前
回调函数 vs Promise vs async/await区别
开发语言·前端·javascript·笔记
刘龙超4 小时前
如何应对 Android 面试官 -> 玩转 JetPack ViewBinding
android jetpack
致***锌5 小时前
期权标准化合约是什么?
笔记
Wilber的技术分享6 小时前
【机器学习实战笔记 14】集成学习:XGBoost算法(一) 原理简介与快速应用
人工智能·笔记·算法·随机森林·机器学习·集成学习·xgboost
顾林海7 小时前
ViewModel 销毁时机详解
android·面试·android jetpack
V我五十买鸡腿8 小时前
顺序栈和链式栈
c语言·数据结构·笔记·算法