# FloatingBall

**Repository Path**: Woody00h/FloatingBall

## Basic Information

- **Project Name**: FloatingBall
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-11-10
- **Last Updated**: 2025-11-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FloatingBall

一个悬浮球应用程序，提供便捷的屏幕边缘吸附和锁屏功能。

## 功能特性

- 屏幕边缘吸附：悬浮球可自动吸附到屏幕边缘，方便单手操作。
- 锁屏功能：支持通过悬浮球快速锁定屏幕。
- 悬浮窗权限管理：自动检测并引导用户开启悬浮窗权限。
- 无障碍服务：通过无障碍服务实现锁屏功能。

## 安装说明

1. 下载并安装 APK 文件。
2. 首次启动时，应用会提示您开启悬浮窗权限。
3. 进入设置页面，开启无障碍服务。

## 使用说明

1. 启动应用后，悬浮球会出现在屏幕上。
2. 拖动悬浮球到屏幕边缘，松手后悬浮球会自动吸附到边缘。
3. 点击悬浮球，可以触发锁屏操作。

## 主要组件

- `FloatingBallService`: 实现悬浮球的创建、拖动、边缘吸附等功能。
- `LockScreenAccessibilityService`: 通过无障碍服务实现锁屏功能。
- `MainActivity`: 应用主界面，负责权限请求和启动服务。

## 贡献指南

欢迎贡献代码！请遵循以下步骤：

1. Fork 本仓库。
2. 创建新分支 (`git checkout -b feature/new-feature`)。
3. 提交更改 (`git commit -am 'Add new feature'`)。
4. 推送分支 (`git push origin feature/new-feature`)。
5. 创建 Pull Request。

## 许可证

本项目采用 MIT 许可证。详情请查看 LICENSE 文件。