吃瓜五一
首页/TV端SDK与开源组件库

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

TV端SDK组件库界面展示

页面定位说明

本页面是吃瓜五一的组件库资源中心,汇集了社区贡献与团队维护的高质量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修改。建议在生产环境中锁定次版本号,通过定期升级获取性能优化与问题修复。

常见问题解答

这些组件支持哪些TV平台?
焦点管理器与列表组件支持Android TV 5.0+、Web TV(Chrome/Firefox内核)与鸿蒙OS 3.0+。视频播放器组件目前主要支持Android TV平台,Web版本正在开发中。
如何参与组件库的贡献?
欢迎通过代码仓库提交Pull Request。贡献前请阅读贡献指南,确保代码符合编码规范并通过所有单元测试。重大功能变更建议先提交RFC讨论。

TV端SDK与开源组件库

经过生产环境验证的TV端开源组件,开箱即用,加速您的智能电视应用开发