Scrcpy 项目使用教程

Scrcpy 项目使用教程

项目地址:https://gitcode.com/gh_mirrors/scr/scrcpy

1. 项目介绍

Scrcpy 是一个开源项目，旨在通过 USB 或 TCP/IP 连接，将 Android 设备的屏幕镜像到计算机上，并允许用户使用计算机的键盘和鼠标来控制 Android 设备。该项目由 Genymobile 开发，支持 Linux、Windows 和 macOS 平台。Scrcpy 不需要在 Android 设备上安装任何应用，也不需要 root 权限，因此非常轻量且易于使用。

Scrcpy 的主要特点包括：

• 轻量级：原生应用，仅显示设备屏幕。
• 高性能：支持 30~120fps 的帧率，具体取决于设备。
• 高质量：支持 1920×1080 或更高的分辨率。
• 低延迟：35~70ms 的延迟。
• 快速启动：约 1 秒内显示第一个图像。
• 非侵入性：不会在 Android 设备上安装任何东西。
• 自由开源：基于 Apache 2.0 许可证发布。

2. 项目快速启动

2.1 安装 Scrcpy

在 Linux 上安装

在大多数 Linux 发行版上，你可以通过包管理器安装 Scrcpy。例如，在 Ubuntu 上，可以使用以下命令：

sudo apt update
sudo apt install scrcpy

在 Windows 上安装

你可以从 Scrcpy 的 GitHub 发布页面 下载预编译的 Windows 二进制文件。下载后，解压并运行 scrcpy.exe。

在 macOS 上安装

你可以使用 Homebrew 安装 Scrcpy：

brew install scrcpy

2.2 连接 Android 设备

确保你的 Android 设备已启用 USB 调试。你可以通过以下步骤启用：

1. 打开设备的“设置”应用。
2. 进入“关于手机”或“关于设备”。
3. 连续点击“版本号”7 次，直到提示“开发者模式已启用”。
4. 返回“设置”主界面，进入“开发者选项”。
5. 启用“USB 调试”。

2.3 启动 Scrcpy

将 Android 设备通过 USB 连接到计算机，然后在终端或命令行中运行以下命令：

scrcpy

Scrcpy 将自动检测连接的设备并开始镜像其屏幕。

3. 应用案例和最佳实践

3.1 远程控制

Scrcpy 不仅支持通过 USB 连接，还支持通过 TCP/IP 连接。这对于需要在不同网络环境下控制 Android 设备非常有用。你可以通过以下步骤实现：

1. 在 Android 设备上启用无线调试：

   adb tcpip 5555
   

2. 获取设备的 IP 地址，通常可以在“设置” -> “关于手机” -> “状态”中找到。
3. 使用 IP 地址连接设备：

   adb connect <设备IP>:5555
   

4. 启动 Scrcpy：

   scrcpy --serial <设备IP>:5555
   

3.2 录制屏幕

Scrcpy 还支持录制 Android 设备的屏幕。你可以使用以下命令开始录制：

scrcpy --record file.mp4

录制完成后，按 Ctrl+C 停止录制。

3.3 镜像屏幕时关闭设备屏幕

在镜像屏幕时，你可以选择关闭 Android 设备的屏幕以节省电量：

scrcpy --turn-screen-off

4. 典型生态项目

4.1 ADB (Android Debug Bridge)

Scrcpy 依赖于 ADB 来与 Android 设备进行通信。ADB 是 Android SDK 的一部分，提供了与 Android 设备交互的命令行工具。你可以通过 ADB 执行各种操作，如安装应用、调试应用、传输文件等。

4.2 SDL2

Scrcpy 使用 SDL2 库来处理图形和输入事件。SDL2 是一个跨平台的多媒体库，支持音频、键盘、鼠标、操纵杆和图形硬件的底层访问。

4.3 FFmpeg

Scrcpy 使用 FFmpeg 来处理视频编码和解码。FFmpeg 是一个强大的多媒体框架，能够解码、编码、转码、复用、解复用、流式传输、过滤和播放几乎所有格式的多媒体文件。

通过这些生态项目的支持，Scrcpy 能够提供高效、稳定的 Android 设备镜像和控制功能。

scrcpy 项目地址: https://gitcode.com/gh_mirrors/scr/scrcpy