# CC-Android

**Repository Path**: chandlerzz/cc-android

## Basic Information

- **Project Name**: CC-Android
- **Description**: 安卓手机记牌器
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-25
- **Last Updated**: 2026-05-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CC Android 连续截图应用

这是一个基于Android平台开发的连续截图应用，提供了自动连续截图功能和悬浮控制界面，方便用户快速进行屏幕截图操作。

## 功能特性

### 核心功能
- **连续截图**：自动以1秒间隔进行屏幕截图并保存到设备
- **悬浮按钮**：提供可拖动的悬浮控制界面，方便随时操作
- **一键启动**：通过主界面的"开始"按钮同时启动连续截图和悬浮按钮服务

### 辅助功能
- **权限自动管理**：自动请求所需的存储权限、悬浮窗权限和MediaProjection权限
- **服务通知**：前台服务通知，显示截图状态并提供停止按钮
- **截图结果提示**：通过系统通知提示截图成功或失败

## 技术实现

### 主要组件

1. **MainActivity.kt** - 主界面控制器
   - 提供用户交互界面
   - 管理权限请求流程
   - 启动和停止连续截图服务

2. **BackgroundScreenshotService.kt** - 后台连续截图服务
   - 以前台服务形式运行
   - 每秒执行一次截图操作
   - 使用MediaProjection API进行屏幕捕获

3. **FloatingButtonService.kt** - 悬浮按钮服务
   - 提供可拖动的悬浮控制按钮
   - 支持停止截图服务

4. **ScreenCaptureUtil.kt** - 截图工具类
   - 处理屏幕截图操作
   - 管理截图文件的保存和访问
   - 处理MediaProjection权限

### 技术栈
- Android Kotlin
- Android Service组件
- MediaProjection API
- Android Notification系统
- Android权限管理

## 使用说明

### 首次使用
1. 启动应用，点击主界面中间的"开始"按钮
2. 应用将依次请求以下权限：
   - 存储权限：用于保存截图文件
   - 悬浮窗权限：用于显示悬浮控制按钮
   - 屏幕捕获权限：用于进行屏幕截图
3. 授予所有权限后，应用将自动启动连续截图和悬浮按钮

### 日常使用
- **启动截图**：点击主界面的"开始"按钮
- **查看截图**：截图保存在设备的图片库中
- **停止截图**：
  1. 点击悬浮按钮
  2. 或点击通知栏中的"停止"按钮
  3. 或重新打开应用，通过界面控制

## 权限说明

### 必要权限
- **存储权限**：用于保存截图文件到设备存储
- **悬浮窗权限**：用于显示可拖动的悬浮控制按钮
- **屏幕捕获权限**：用于使用MediaProjection API进行屏幕截图

### 权限请求流程
1. 首先请求存储权限
2. 然后请求悬浮窗权限
3. 最后请求屏幕捕获权限

## 项目结构

```
app/src/main/
├── java/com/example/cc_andriod/
│   ├── MainActivity.kt              # 主界面控制器
│   ├── services/
│   │   ├── BackgroundScreenshotService.kt  # 后台连续截图服务
│   │   └── FloatingButtonService.kt        # 悬浮按钮服务
│   └── utils/
│       ├── ScreenCaptureUtil.kt     # 截图工具类
│       └── NotificationUtil.kt       # 通知工具类
└── res/
    ├── layout/                      # 布局文件
    └── menu/                        # 菜单文件
```

## 安装说明

### 从源码构建
1. 克隆项目到本地
2. 使用Android Studio打开项目
3. 连接Android设备或启动模拟器
4. 点击"Run"按钮构建并安装应用

### 从APK安装
1. 下载生成的APK文件
2. 在Android设备上启用"未知来源应用"安装
3. 点击APK文件进行安装

## 注意事项

- 应用需要Android 6.0 (API 23)及以上版本
- 连续截图会占用设备存储空间，请定期清理截图文件
- 在某些设备上，悬浮窗权限可能需要在系统设置中手动授予
- 屏幕捕获权限需要用户手动确认授予

## 开发说明

### 主要类说明

#### BackgroundScreenshotService
- 以前台服务运行，确保在后台持续执行
- 每秒执行一次截图操作
- 使用Handler和Runnable实现定时任务

#### FloatingButtonService
- 提供可拖动的悬浮控制按钮
- 支持停止连续截图服务

#### ScreenCaptureUtil
- 处理所有截图相关的操作
- 管理截图文件的保存路径
- 处理MediaProjection权限

## 更新日志

### 版本 1.0
- 初始版本
- 实现连续截图功能
- 实现悬浮按钮功能
- 自动权限管理

## 联系方式

如有问题或建议，请通过以下方式联系：
- GitHub Issues: [项目地址]()

---

**注意**：本应用仅供学习和测试使用，请勿用于非法用途。