# ScrcpyAutoScroller

**Repository Path**: washala/ScrcpyAutoScroller

## Basic Information

- **Project Name**: ScrcpyAutoScroller
- **Description**: 这是一个利用Scrcpy和ADB工具，自动滑动手机视频的Python脚本，适用于需要批量观看短视频的场景。随机的间隔滑动时间、随机的滑动距离，能有效的避免系统检测封禁。兼容Scrcpy 3.1版本。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-03-20
- **Last Updated**: 2025-12-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ScrcpyAutoScroller / Scrcpy自动刷视频助手

[English Documentation](README-en.md) | 中文文档

这是一个利用Scrcpy和ADB工具，自动滑动手机视频的Python脚本，适用于需要批量观看短视频的场景。随机的间隔滑动时间、随机的滑动距离，能有效的避免系统检测封禁。兼容Scrcpy 3.1版本。

## 试用场景

- 支付宝APP-视频
- 淘宝APP-视频
- 其他可以刷视频赚钱赚积分的位置

## 特点

- **自动滑动**: 以随机时间间隔自动滑动切换视频
- **智能坐标**: 根据设备屏幕尺寸自动计算最佳滑动参数
- **随机滑动高度**: 每次滑动可使用随机高度，更加接近人工操作
- **可调串流质量**: 可设置码率、帧率和编码器，平衡画质与性能
- **音频支持**: 可选择启用音频转发(Android 11+)
- **摄像头支持**: 可选择使用设备摄像头作为视频源(Android 12+)
- **OTG模式**: 支持不启用USB调试的控制模式
- **游戏手柄**: 支持使用游戏手柄控制设备
- **自定义选项**: 支持完全自定义所有参数
- **运行统计**: 提供详细的运行统计信息
- **便捷启动器**: 支持Windows和Linux系统的图形化菜单启动器

## 需求

- Python 3.6+
- 已安装的Scrcpy环境 (兼容Scrcpy 3.1+)
- 已连接并开启USB调试的Android设备(除OTG模式外)
- 对于音频功能，需要Android 11+
- 对于摄像头功能，需要Android 12+

## 安装

1. 确保您已安装Scrcpy 3.1+，且目录中包含`adb.exe`和`scrcpy.exe`
2. 将脚本文件放置在Scrcpy目录的`scripts`子文件夹中:
   - `auto_video_scroller.py` - 主Python脚本
   - `win-start.bat` - Windows启动器
   - `linux-start.sh` - Linux启动器

## 快速启动

### Windows用户

双击运行`win-start.bat`文件，从菜单中选择预设配置：

```
================================================
              Scrcpy自动刷视频启动器
================================================

 请选择一个配置:

 [1] 默认配置 (滑动间隔25-30秒, 视频码率4M)
 [2] 高画质模式 (H.265编码, 8M码率, 60fps)
 [3] 低延迟模式 (滑动间隔10-15秒, 低码率)
 [4] 固定滑动模式 (固定滑动高度25%)
 [5] 开启音频模式 (启用音频转发, Android 11+)
 [6] 摄像头模式 (使用前置摄像头, Android 12+)
 [7] 抖音启动模式 (默认配置并启动抖音)
 [8] 抖音极速版启动模式 (默认配置并启动抖音极速版)
 [9] 淘宝视频启动模式 (默认配置并启动淘宝)
 [10] 支付宝视频启动模式 (默认配置并启动支付宝)
 [11] 自定义参数模式
 [12] 退出

================================================
```

### Linux用户

首先给Shell脚本添加执行权限：

```bash
chmod +x linux-start.sh
```

然后运行启动器：

```bash
./linux-start.sh
```

## 手动执行

在命令行中直接运行Python脚本:

```bash
python auto_video_scroller.py
```

这将使用默认设置启动自动滑动:
- 屏幕大小: 0.6倍原尺寸
- 滑动间隔: 25-30秒随机
- 滑动高度: 屏幕高度的30%-32%随机
- 视频码率: 4M (中等质量)
- 帧率: 30fps
- 编码器: H.264

## 参数说明

### 基本参数

| 参数 | 描述 | 默认值 |
|------|------|--------|
| `--min-time` | 滑动之间的最小等待时间(秒) | 25.0 |
| `--max-time` | 滑动之间的最大等待时间(秒) | 30.0 |
| `--window-size` | 窗口大小比例 | 0.6 |
| `--min-swipe-percent` | 最小滑动高度(屏幕百分比) | 30.0 |
| `--max-swipe-percent` | 最大滑动高度(屏幕百分比) | 32.0 |
| `--swipe-percent` | 固定滑动高度(屏幕百分比) | 未设置 |
| `--no-scrcpy` | 不启动Scrcpy(自行启动) | 未设置 |
| `--custom-swipe` | 使用自定义滑动坐标 | 未设置 |
| `--start-x` | 自定义滑动起点X坐标 | 自动计算 |
| `--start-y` | 自定义滑动起点Y坐标 | 自动计算 |
| `--end-x` | 自定义滑动终点X坐标 | 自动计算 |
| `--end-y` | 自定义滑动终点Y坐标 | 自动计算 |

### Scrcpy 3.1 参数

| 参数 | 描述 | 默认值 |
|------|------|--------|
| `--video-bit-rate` | 视频串流码率 | 4M |
| `--max-fps` | 最大帧率 | 30 |
| `--video-codec` | 视频编码器(h264或h265) | h264 |
| `--audio` | 启用音频转发(Android 11+) | 禁用 |
| `--video-source` | 视频源(display或camera) | display |
| `--camera-size` | 摄像头分辨率 | 未设置 |
| `--camera-facing` | 摄像头方向(front或back) | back |
| `--start-app` | 启动指定应用包名 | 未设置 |
| `--otg` | 使用OTG模式(不需要USB调试) | 未设置 |
| `--gamepad` | 启用游戏手柄支持(auto或uhid) | 未设置 |
| `--version` | 显示版本信息 | - |

## 视频码率设置

在Scrcpy 3.1中，视频码率使用`--video-bit-rate`参数设置，必须以固定值形式指定:

| 设置 | 码率值 | 画质水平 |
|------|-------|---------|
| 低质量 | 2M | 节省流量，适合较慢的连接 |
| 中等质量 | 4M | 默认设置，平衡画质和性能 |
| 高质量 | 8M | 清晰画质，需要更快的连接 |
| 超高质量 | 12M | 非常清晰，需要很快的连接 |

## 使用示例

### 基本使用 - 自动滑动短视频
```bash
python auto_video_scroller.py
```

### 调整滑动时间间隔
```bash
python auto_video_scroller.py --min-time=10 --max-time=15
```

### 使用固定滑动高度
```bash
python auto_video_scroller.py --swipe-percent=25
```

### 启用H.265编码和高质量视频
```bash
python auto_video_scroller.py --video-codec=h265 --video-bit-rate=8M --max-fps=60
```

### 启用音频转发(Android 11+)
```bash
python auto_video_scroller.py --audio
```

### 使用摄像头作为视频源(Android 12+)
```bash
python auto_video_scroller.py --video-source=camera --camera-size=1920x1080 --camera-facing=front
```

### 自动启动特定应用
```bash
python auto_video_scroller.py --start-app=com.ss.android.ugc.aweme  # 启动抖音
python auto_video_scroller.py --start-app=com.ss.android.ugc.aweme.lite  # 启动抖音极速版
python auto_video_scroller.py --start-app=com.taobao.taobao  # 启动淘宝
python auto_video_scroller.py --start-app=com.eg.android.AlipayGphone  # 启动支付宝
```

### 使用OTG模式(不需要USB调试)
```bash
python auto_video_scroller.py --otg
```

### 启用游戏手柄支持
```bash
python auto_video_scroller.py --gamepad=uhid
```

### 自定义滑动坐标
```bash
python auto_video_scroller.py --custom-swipe --start-x=500 --start-y=1000 --end-x=500 --end-y=600
```

### 组合使用
```bash
python auto_video_scroller.py --window-size=0.8 --min-time=15 --max-time=20 --video-codec=h265 --video-bit-rate=6M --max-fps=45 --audio
```

## 注意事项

1. 请确保设备已连接并启用USB调试(除OTG模式外)
2. Android 11+设备支持音频转发
3. Android 12+设备支持摄像头功能
4. 对于H.265编码，设备需要支持HEVC编码器
5. 某些应用可能会检测自动化操作，使用时请注意
6. 滑动坐标是基于设备的分辨率动态计算的，可能需要根据您的应用进行微调
7. 按Ctrl+C可随时停止脚本运行

## 故障排除

如果遇到问题，请尝试以下方法:

1. 检查设备连接: `adb devices`
2. 确保脚本位于正确的目录
3. 手动启动Scrcpy，然后使用`--no-scrcpy`选项运行脚本
4. 检查Scrcpy版本支持的参数: `scrcpy --help`
5. 对于Scrcpy 3.1及以上版本，必须使用固定值码率(如 4M, 8M)，不支持百分比格式
6. 如果使用摄像头功能，确保已授予Scrcpy摄像头权限

## 更新历史

- **2025-03-20**: 
  - 增加对Scrcpy 3.1新功能的支持
  - 添加H.265编码、音频转发、摄像头、OTG和游戏手柄支持
  - 更新了参数设置和使用示例
- **2025-03-19**: 
  - 修复了码率参数格式问题，不再使用百分比
  - 增加了码率值自动转换功能
  - 更新了默认码率为4M
- **2025-03-17**: 
  - 修复了与Scrcpy 3.1兼容性问题
  - 更新了码率参数从`--bit-rate`到`--video-bit-rate`
- **2025-03-15**: 
  - 添加了随机滑动高度(30%-32%)
  - 增加了视频码率和帧率控制参数
- **2025-03-12**: 优化了滑动算法，改进了窗口大小设置
- **2025-03-10**: 首次开发