README.md

• Telegram的夜间白天切换效果组件
  • 特别致谢
  • 项目环境
  • 实现原理
    • 思路
    • 步骤
  • 兼容开发模式
    • 说明
    • Compose
      • 文件地址
      • 使用方式
    • 原生XML
      • 文件地址
      • 使用方式
    • 效果图

Telegram的夜间白天切换效果组件

特别致谢

SakurajimaMaii的技术交流支持 SakurajimaMaii

项目环境

Compose Material3

Kotlin 1.8.10

Grade 8.4

AGP 8.0.1

实现原理

思路

截图遮挡下层进行遮罩，下层切换好后上层使用paint进行混合绘制来显示下层，就达到了切换的效果

步骤

1. 获取当前页面截图。注(Compose获取截图时是通过LocalView进行获取，所以有节点树顺序影响，所以需要放在最外层)
2. 获取截图后绘制到页面上层遮住下方，绘制结束后走一个绘制结束回调进行主题切换。注(切换的时间一般是无感知的，所以不用关心同步等待问题)
3. 以页面对角线长度为半径使用Paint进行与截图图层的混合
4. 根据动画模式选择paint的模式是擦除还是相交显示
5. 使用ValueAnimator.ofFloat创建动画来进行圆的绘制，绘制结束后显示下层已经切换好的页面结束动画

兼容开发模式

说明

实现后发现只需要一个文件内容即可，所以没做远程仓库上传，需要使用的可以在对应平台找源文件索引地址然后下载下来按照对应的使用方式或者参考使用文件地址进行使用即可

注：动画的两个类型单独放在了constant文件中，MaskAnimModel

Compose

文件地址

组件源文件地址索引

使用文件地址索引

使用方式

//MaskBox的基础布局是一个Box
MaskBox(
    animTime =1000L, //动画时间(毫秒为单位)
    maskComplete = {},//截图创建完成的回调，也就是动画准备完成开始直接的回调
    animFinish = { },//动画结束后的回调
) { maskAnimActiveEvent ->  
    Button(onClick = { 
        //调用函数激活动画，传入动画类型，动画扩展收缩的圆形的坐标，可以认为是点击坐标
        maskAnimActiveEvent(MaskAnimModel.EXPEND,0f,0f)
    }) {
        Text(text = "active mask anim")
    }
}

原生XML

文件地址

组件源文件地址索引

使用文件地址索引

使用方式

//xml是通过自定义View实现的，原理就是获取根布局来添加自定义view，自定义view用于动画遮罩和隐藏，所以不用局限在最外层
//直接使用上下文调用activeMaskView来激活自定义View的创建和添加
context.activeMaskView(
    animModel = if (isDarkTheme) MaskAnimModel.SHRINK else MaskAnimModel.EXPEND,//传入的动画类型 
    clickX = clickX,//动画扩展收缩的圆形的x坐标，可以认为是点击坐标
    clickY = clickY,//动画扩展收缩的圆形的y坐标，可以认为是点击坐标
    animTime = 700,//动画时间，单位是毫秒
    maskComplete = {//遮罩创建完成回调，也就是截图创建绘制完毕准备执行动画之前的回调
        //....
    },
    maskAnimFinish = {//动画结束回调
       //...
    },
)

效果图