MATVT：安卓电视虚拟鼠标完整使用指南

想要在安卓电视上获得类似电脑鼠标的操控体验吗？MATVT（Mouse for Android TV Toggle）这款开源工具让你的普通遥控器瞬间变身触控神器，无需额外硬件就能实现光标移动、点击和滑动操作，彻底解决智能电视操作难题！

项目简介：重新定义电视操控

MATVT是一款专为安卓电视和翻盖手机设计的虚拟鼠标工具，通过简单的遥控器按键映射，即可实现完整的鼠标功能。无论是浏览网页、操作应用还是管理文件，都能获得更流畅的交互体验。

核心功能亮点

基础鼠标操控 - 通过方向键移动光标，中心键完成点击操作

智能边框穿越 - 光标从屏幕边缘无缝穿越，操作更加便捷

个性化鼠标样式 - 多种尺寸和皮肤选择，满足不同使用需求

安装配置：三步快速上手

准备工作

确保你的设备满足以下条件：

• 安卓电视或翻盖手机（Android 7.0+系统）
• 带有方向键和至少一个闲置按键的遥控器
• 可选：彩色按键和Info键

详细安装步骤

1. 获取安装文件 克隆项目仓库获取最新源码：

   git clone https://gitcode.com/gh_mirrors/ma/matvt
   

   或直接下载发布版APK，注意区分电视版和手机版

2. 授予必要权限 安装完成后，务必进入系统设置 → 特殊应用权限 → 授予MATVT"悬浮窗权限"

3. 激活服务功能 进入辅助功能设置，启用MATVT服务并配置BossKey

使用教程：完整操作指南

基础键位功能

• 方向键（DPAD）：控制光标移动，中心键执行点击
• 彩色按键：红/绿键实现上下滑动，黄/蓝键实现左右滑动
• Info键：快速切换鼠标显示和隐藏状态
• BossKey：循环切换鼠标模式、滚动模式和方向键模式

高级配置选项

在app/src/main/res/values/strings.xml配置文件中，你可以自定义以下参数：

• 鼠标移动灵敏度调节
• 自动隐藏时间设置
• 边缘滚动功能开关
• 自定义BossKey按键

常见问题解决方案

遥控器失灵怎么办？

这是未正确授予悬浮窗权限导致的常见问题。解决方法：

1. 连接物理鼠标到电视USB接口
2. 进入设置 → 辅助功能 → 禁用MATVT服务
3. 重新授予权限后再次启用服务

兼容性说明

项目已在索尼安卓电视（Android 9）验证通过，理论支持所有安卓7.0+系统设备。社区反馈显示小米、TCL等品牌电视均可正常运行。

隐私安全保证

MATVT完全开源且免费，不包含任何广告、跟踪代码或付费功能，所有操作均在本地完成，确保用户数据安全。

进阶使用技巧

性能优化建议

• 根据遥控器按键反馈速度调整鼠标灵敏度
• 合理设置自动隐藏时间，节省屏幕空间
• 开启边缘滚动功能，提升操作效率

个性化设置

通过项目中的核心引擎模块（app/src/main/java/io/github/virresh/matvt/engine/）可以进一步定制鼠标行为，满足特殊使用需求。

社区参与指南

MATVT是一个完全开源的项目，欢迎通过以下方式参与：

• 代码贡献：提交PR改进功能
• 问题反馈：在官方仓库提交使用体验
• 文档完善：帮助优化使用指南

项目持续改进离不开社区的贡献和支持，让我们一起打造更好的安卓电视操控体验！