MATVT：无需额外硬件的Android TV虚拟鼠标控件安装与配置指南

MATVT（Mouse for Android TV Toggle）是一个专为Android TV设计的开源虚拟鼠标解决方案，它允许用户通过电视遥控器控制光标，无需任何额外硬件即可实现点击、滑动等操作。

项目概述

MATVT主要使用Java语言开发，基于Android SDK构建，利用Android的辅助功能服务来模拟鼠标行为。该项目支持Android 7及以上版本的设备，能够将遥控器的DPAD、颜色按钮、Info键等转换为虚拟鼠标的指令。

安装准备

在开始安装前，请确保：

• 您的Android TV设备运行Android 7或更高版本
• 设备支持侧加载应用或您具备ADB工具使用知识
• 下载正确的APK版本（TV版本与Flipphone版本区分）

安装步骤

方法一：通过USB侧载安装

1. 从项目发布页面下载适用于Android TV的APK文件
2. 将APK文件复制到USB存储设备
3. 在电视上使用文件管理器找到并安装APK

方法二：使用ADB命令安装（高级用户）

adb install 路径/至/matvt-TV版本.apk

配置步骤

1. 授予覆盖权限

安装完成后，进入电视的"设置" > "特殊应用权限"，找到MATVT并授予"在其他应用上层显示"的权限。这一步至关重要，如果跳过此步骤直接启用辅助服务，可能导致遥控器输入被拦截而无法使用。

2. 启用辅助服务

在授予覆盖权限后，进入"设置" > "辅助功能" > "服务"，找到MATVT服务并启用它。

3. 初次使用

• 按下遥控器的Info键激活鼠标模式
• 系统可能会提示确认权限，请按照屏幕指示操作
• 鼠标会自动在短暂不活动后隐藏，按下相关按钮重新显示

功能配置

MATVT提供丰富的自定义选项，可通过配套的GUI应用进行配置：

鼠标外观设置

• 鼠标大小：调整光标显示尺寸
• 鼠标图标：选择不同的光标样式（包括浅色和透明样式）
• 边框窗口：启用后防止光标在屏幕边缘环绕

按键行为设置

• 禁用Boss键：完整遥控器可禁用Boss键功能
• Boss键切换行为：设置按键在不同模式间循环切换
• 覆盖激活键：自定义Boss键的键值
• 自动检测Boss键：自动识别遥控器按键代码

滚动设置

• 滚动速度：调整鼠标滚动时的速度
• 边缘自动滚动：当鼠标触达屏幕边缘时自动滚动内容

使用技巧

• 基本操作：使用DPAD移动光标和进行单击操作
• 颜色按钮：RED和GREEN按钮用于上下滑动，YELLOW和BLUE按钮用于左右滑动
• 即时切换：Info键可立即切换鼠标可见性
• 动量移动：长时间按住按键可增加移动速度或发送多个滑动指令

故障排除

常见问题解决

遥控器失灵怎么办？ 如果因配置错误导致遥控器无法使用，您需要：

1. 使用物理鼠标连接到电视
2. 进入辅助功能设置禁用MATVT服务
3. 重新按照正确顺序配置权限

鼠标不显示？ 确保已正确完成以下步骤：

1. 授予覆盖其他应用的权限
2. 启用辅助功能服务
3. 按下Info键激活鼠标模式

注意事项

• 首次安装时请严格遵循权限授予顺序
• 不同电视型号的兼容性可能有所差异
• 建议定期检查项目更新以获取最新功能和完善

MATVT为Android TV用户提供了便捷的虚拟鼠标解决方案，通过合理的配置和使用，可以显著提升在大屏幕设备上的操作体验。

MATVT基本鼠标操作功能演示

鼠标在屏幕边框的环绕效果

多种鼠标尺寸和皮肤样式选择