发布时间:2024年3月 | 最后更新:2024年12月

页面定位说明
本页面是王竹子的组件库资源中心,汇集了社区贡献与团队维护的高质量TV端开源组件。所有组件均经过多品牌电视设备的兼容性测试,支持Android TV、Web TV与鸿蒙大屏平台。开发者可以直接引入这些组件快速构建TV应用,无需从零实现焦点管理、列表滚动等基础能力。
焦点管理器组件
焦点管理器是TV端应用的核心基础设施。本组件提供声明式的焦点配置API,支持二维网格导航、焦点记忆、焦点陷阱(Focus Trap)与自定义焦点路径。通过简单的属性配置即可实现复杂的焦点导航逻辑,无需手动处理KeyEvent。
核心特性包括:自动计算最近邻焦点目标、支持焦点组(FocusGroup)嵌套、提供焦点变化事件回调、内置焦点动画引擎(支持自定义缓动曲线与持续时间)、以及焦点路径死角检测工具。
大屏视频播放器组件
专为TV端优化的视频播放器组件,基于ExoPlayer/IJKPlayer内核封装,提供统一的播放控制API。支持4K HDR硬解码、自适应码率切换(ABR)、画中画模式、弹幕渲染引擎与遥控器手势控制(长按快进/快退、数字键跳转)。
播放器UI完全适配TV端交互规范:控制栏通过焦点触发显示/隐藏、进度条支持D-Pad精确定位、音量/亮度通过方向键调节。与此同时提供无障碍语音播报支持,满足适老化设计要求。
高性能列表与网格组件
针对TV端低配设备优化的虚拟滚动列表组件,在1GB内存设备上实现60帧流畅滚动。核心优化策略包括:可视区域外元素回收复用、图片按需加载与内存缓存池、滚动惯性预测与预渲染、以及GPU加速的列表项动画。
支持横向滚动行(Row)、纵向瀑布流(Waterfall)、网格布局(Grid)三种模式,均内置焦点管理与滚动对齐(Snap)功能。
规则说明
所有组件遵循MIT或Apache-2.0开源协议,可自由用于商业项目。组件的版本放出遵循语义化版本规范(SemVer),主版本号变更可能包含不兼容的API修改。建议在生产环境中锁定次版本号,通过定期升级获取性能优化与问题修复。