Python Scrcpy Client 安卓设备投屏控制完全指南

Python Scrcpy Client 安卓设备投屏控制完全指南

【免费下载链接】py-scrcpy-client 项目地址: https://gitcode.com/gh_mirrors/py/py-scrcpy-client

Python Scrcpy Client 是一个基于 Python 的安卓设备投屏和控制工具，支持实时屏幕镜像、设备远程控制、触摸操作显示等强大功能。本项目基于 scrcpy 服务器 v1.20 版本实现，为开发者和用户提供了便捷的安卓设备管理解决方案。

项目概述

py-scrcpy-client 允许您实时查看和控制安卓设备，无需 root 权限即可实现高质量的屏幕镜像和设备操作。项目采用模块化设计，代码结构清晰，易于理解和使用。

快速开始

环境要求

• Python 3.8.1 及以上版本
• ADB 工具（Android Debug Bridge）
• 安卓设备开启开发者选项和 USB 调试

安装方式

通过 pip 安装基础版本：

pip install scrcpy-client

如需使用图形界面，安装完整版本：

pip install scrcpy-client[ui]

启动应用

安装完成后，可以通过以下命令启动图形界面：

py-scrcpy

项目结构解析

核心模块

• scrcpy/core.py - 核心客户端实现，负责设备连接、服务器部署和数据流处理
• scrcpy/control.py - 设备控制功能，包括按键、触摸、滚动等操作
• scrcpy/const.py - 常量定义，包含各种操作类型和配置参数

用户界面模块

• scrcpy_ui/main.py - 图形用户界面主程序
• scrcpy_ui/main.ui - 界面布局文件
• scrcpy_ui/ui_main.py - 自动生成的界面代码

辅助文件

• pyproject.toml - 项目配置和依赖管理
• scripts/ - 开发和测试脚本
• tests/ - 单元测试文件
• docs/ - 项目文档

核心功能详解

设备连接与初始化

Client 类在 core.py 中负责设备的初始化和连接管理，支持以下配置选项：

• 最大宽度设置
• 比特率调节
• 最大帧率控制
• 屏幕翻转功能
• 保持唤醒状态

控制功能

Control 类在 control.py 中提供完整的设备控制能力：

• 按键操作（keycode）
• 文本输入（text）
• 触摸操作（touch）
• 滚动控制（scroll）
• 剪贴板管理
• 电源模式设置

图形界面功能

main.py 中的主界面类提供：

• 设备选择功能
• 鼠标事件处理
• 键盘事件映射
• 实时画面显示

使用示例

基础使用

from scrcpy import Client

# 创建客户端实例
client = Client(device="你的设备序列号")

# 启动连接
client.start()

# 添加帧监听器
def on_frame(frame):
    # 处理每一帧画面
    pass

client.add_listener("frame", on_frame)

高级控制

# 发送按键事件
client.control.keycode(4)  # 返回键

# 发送文本
client.control.text("Hello World")

# 触摸操作
client.control.touch(100, 200, action=const.ACTION_DOWN)

配置选项

在创建 Client 实例时，可以通过以下参数进行配置：

• max_width: 最大显示宽度（0 表示不限制）
• bitrate: 视频比特率（默认 8000000）
• max_fps: 最大帧率
• flip: 是否翻转屏幕
• stay_awake: 保持设备唤醒
• connection_timeout: 连接超时时间

开发与贡献

项目使用 Poetry 进行依赖管理，开发环境配置如下：

# 安装开发依赖
poetry install

# 运行测试
pytest

# 代码检查
python scripts/check.py

技术特点

1. 高性能: 基于 scrcpy 服务器 v1.20，提供流畅的投屏体验
2. 易用性: 简洁的 API 设计和直观的图形界面
3. 跨平台: 支持 Windows、Linux、macOS 系统
4. 功能完整: 实现 scrcpy 服务器的所有控制功能

应用场景

• 安卓应用开发和测试
• 设备演示和教学
• 远程设备管理
• 自动化测试脚本

通过 py-scrcpy-client，您可以轻松实现安卓设备的远程控制和屏幕镜像，大大提高开发效率和使用便利性。

【免费下载链接】py-scrcpy-client 项目地址: https://gitcode.com/gh_mirrors/py/py-scrcpy-client