UI控件使用指南

控件名称

名称

功能说明

使用场景

效果展示

lvsf_multlist

列表控件

1.实现水平/竖直元素的管理,方便增、删、改、查;
2.内置贝塞尔算法,可实现item的弧形缩放变形视觉效果;
3.具有配套的辅助控件,如缩放控件左滑删除进度条 等。

适用于多节点并排展示的场景,可高效实现节点的动态增删改查操作,如列表菜单、页面平铺布局、运动类APP界面等

加载动图

lvsf_multobj

obj缩放控件

针对非拍照场景,实现对目标对象及其子元素的缩放展示,核心通过调整对象尺寸完成缩放效果,适配性强。

针对PSRAM容量受限的硬件平台,可替代拍照缩放方案实现对象缩放需求

multobj

lvsf_multroller

滚筒控件

基于lvsf_multlist控件二次开发的滚筒式选择控件,新增对齐区域文本重新着色功能,交互与视觉体验更优。

时间、日期、数值等需要滑动选择的参数设置场景

滚筒

lvsf_multslider

滑动条控件

封装滑动条核心功能,相比原生滑动条新增衬底文本添加、进度拖拽范围自定义功能,功能扩展性更强(效果详见具体文档)。

各类属性值的滑动展示与参数设置场景,如音量调节、亮度调节等

滑动条

lvsf_multswipe

滑动删除控件

单独封装lvsf_multlist的item滑动删除核心能力,同时内置多种常用的滑动删除交互方式,可直接调用。

lvsf_multlist控件中,部分item需要通过左滑/上滑实现删除操作的场景

滑动条

lvsf_multedge

侧边栏控件

为lvsf_multlist实现侧边栏功能,侧边栏为隐藏式悬浮窗口设计,支持通过滑动、拖拽操作调出展示。

需为lvsf_multlist搭配附加窗口,且附加窗口需滑动触发显示的场景,如消息提示框、功能侧边栏等

切换动画

lvsf_multanim

切换动画控件

一站式封装各类常用界面切换动画,包含缩放动画、3D动画、mask遮罩动画、vglite硬件加速动画等,可直接配置调用。

页面、组件切换及平铺布局的动画效果实现场景,简化动画开发流程

切换动画

lvsf_scrolbar

进度条控件

封装lvsf_multlist的进度条功能,无需单独开发进度逻辑,仅需使能对应标志位,即可快速实现lvsf_multlist的滚动进度显示。

lvsf_multlist控件需要展示滚动进度的场景,如长列表、长平铺布局等

进度条动画

lvsf_txtimg

文本转图片控件

封装文本转A8格式图片功能,从底层优化大文本量显示耗时问题,同时支持文本图片旋转功能,适配多场景展示。

文本量较大或需要实现文本缩放效果的场景,如电子书阅读、长列表菜单、大篇幅文本展示等

文本缩放

lvsf_txtlite

2.5D文本控件

封装vglite硬件加速接口,核心实现文本转图片功能,可快速实现环形歌词滚动、文本缩放动画等特效。

适用于58x及后续芯片。 音乐播放类应用的歌词动效实现场景,如环形歌词、滚动歌词等

环形滚动

lv_gesture

手势控件

轻量级手势控件,核心实现页面右滑退出手势识别与响应功能,支持手势的使能与重置配置。

各类页面需要添加右滑退出交互的场景,统一APP页面返回手势体验

手势

lvsf_cube

立体效果控件

基于vglite硬件加速接口开发,实现多平面拼接的立体显示效果,支持自定义立体控件参数。

适用于58x及后续芯片。 2.5D立方体图形展示场景,如正六面体、球形立体界面、装饰性立体表盘等

足球

lvsf_arctext

弧形文本控件

专业弧形文本显示控件,通过对单个文字逐一拍照处理,结合自定义角度、字间距参数,实现文本的圆弧排列展示。

文本需要按圆弧轨迹排列显示的场景,如圆形表盘文字、弧形装饰文本等

弧形文本

lvsf_ezipa

APNG动画控件

一站式封装APNG动图核心功能,支持APNG的播放、暂停、循环播放、封面自定义设置等全量操作。

需展示带透明度效果的图片序列动效场景

apng

lvsf_gif_anim

GIF动画控件

完整封装GIF动图播放控制功能,支持播放、暂停、循环播放、封面自定义设置等操作,接口简洁易调用。

GIF动图作为背景、表盘界面元素、装饰性动效的展示场景

gif动画

lvsf_seq_frame

帧序列播放控件

通用帧序列播放控件,支持多张图像的单次播放、连续播放、循环播放;同时支持帧间隔自定义、播放延迟启动、指定帧索引精准播放等精细化控制。

适用于多帧图片序列的动效展示场景,图片格式只能为png格式

序列帧

lvsf_video

视频播放控件

专业视频播放控件,支持单视频播放、批量视频列表播放,同时实现循环播放、顺序播放等常规播放逻辑,满足通用视频业务需求。

视频播放器、视频表盘、视频背景等各类视频播放展示场景

视频案例