如何在Jetpack Compose中修改Stylus手写笔悬停图标？

要解决默认悬停圆圈覆盖自定义内容的问题，核心是先禁用系统层面的默认指针图标，再通过Compose的指针事件监听自定义渲染悬停内容，具体步骤如下：

1. 禁用系统默认悬停图标 #

Compose提供的Modifier.pointerIcon() API可以直接将手写笔的悬停图标设置为不可见，让系统自带的小圆圈消失：

Modifier.pointerIcon(PointerIcon.Invisible)

注意：该API要求Android API 29（Android 10）及以上版本，若需兼容更低版本，可添加版本判断逻辑。

2. 监听手写笔悬停事件并自定义渲染 #

通过pointerInput监听指针事件，筛选出手写笔的悬停状态，记录位置后绘制自定义图标：

完整示例代码：

@Composable
fun CustomStylusHover() {
    // 记录手写笔悬停位置
    var hoverOffset by remember { mutableStateOf<Offset?>(null) }

    Box(
        modifier = Modifier
            .fillMaxSize()
            .pointerIcon(PointerIcon.Invisible)
            .pointerInput(Unit) {
                awaitPointerEventScope {
                    while (true) {
                        val event = awaitPointerEvent()
                        event.changes.forEach { change ->
                            // 判断是否是手写笔的悬停事件
                            hoverOffset = if (change.isStylus && change.isHover) {
                                change.position
                            } else {
                                null
                            }
                        }
                    }
                }
            }
    ) {
        hoverOffset?.let { offset ->
            // 自定义悬停图标，这里用系统Edit图标示例，可替换为自定义矢量图
            Icon(
                imageVector = Icons.Default.Edit,
                contentDescription = "Stylus hover indicator",
                modifier = Modifier
                    // 调整偏移量，让图标中心对准笔尖位置
                    .offset(
                        x = offset.x - 24.dp.toPx(),
                        y = offset.y - 24.dp.toPx()
                    )
                    .size(48.dp)
                    .tint(Color(0xFF2196F3))
            )
        }
    }
}

额外注意事项 #

• 设备兼容性：部分Android设备的手写笔可能不支持悬停事件，需要先确认设备硬件支持该功能
• 精细控制：若需要根据手写笔的压力、倾斜角度调整图标样式，可通过change.pressure、change.tilt等属性获取对应参数
• 位置校准：不同手写笔的笔尖检测位置可能有偏差，需要根据实际设备调整图标的偏移量

内容的提问来源于stack exchange，提问作者Tarek Khafaga