# HoverClock

**Repository Path**: firexmoon/hover-clock

## Basic Information

- **Project Name**: HoverClock
- **Description**: 悬浮式计时器（Android APP），一个简洁高效的Android悬浮窗计时器应用，可在您使用其他应用时保持计时功能。
- **Primary Language**: Kotlin
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-13
- **Last Updated**: 2025-04-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# HoverClock - 悬浮式计时器

HoverClock是一个简洁高效的Android悬浮窗计时器应用，可在您使用其他应用时保持计时功能。

## 功能特点

- **悬浮窗设计**：无需切换应用，始终保持在屏幕顶层
- **可拖拽定位**：自由拖拽悬浮窗到任意位置
- **计时器功能**：
  - 分秒精确计时（00:00格式）
  - 一键开始/暂停计时
  - 一键重置计时器
- **半透明设计**：透明背景不会完全遮挡屏幕内容
- **简洁界面**：简约设计风格，专注于核心功能

## 技术特点

- 使用Kotlin语言开发
- 基于Android系统级WindowManager实现悬浮窗
- 实现触摸事件处理实现拖拽功能
- 利用Handler和Runnable实现精确计时
- 针对不同Android版本适配悬浮窗权限

## 实现思路

- 通过Android Service组件在后台运行
- 使用WindowManager实现悬浮窗口
- 自定义触摸事件处理实现拖拽功能
- 支持Android 10.0及以上系统

## 使用说明

1. 首次使用需授予悬浮窗权限
2. 点击"启动悬浮计时器"按钮打开悬浮窗
3. 计时器操作：
   - 点击"开始"按钮启动计时
   - 计时过程中点击"停止"按钮暂停计时
   - 点击"复位"按钮重置计时器
4. 随时可通过"关闭悬浮计时器"按钮关闭悬浮窗

## 运行环境

- Android 10.0+(API 30+)
- 需开启悬浮窗权限