Genymobile/scrcpy
Hiển thị và điều khiển thiết bị Android của bạn
README
[!CẢNH BÁO] Kho lưu trữ GitHub này (https://GitHub.com/Genymobile/scrcpy) là nguồn chính thức duy nhất cho dự án. Không tải xuống các bản phát hành từ các trang web ngẫu nhiên, ngay cả khi tên của chúng chứa
scrcpy.
scrpy (v4.1)
phát âm là "chàeen copy"
Ứng dụng này phản chiếu các thiết bị Android (video và âm thanh) được kết nối qua USB hoặc TCP/IP và cho phép điều khiển bằng bàn phím và chuột của máy tính. Nó không yêu cầu gốc truy cập hoặc một ứng dụng được cài đặt trên thiết bị. Nó hoạt động trên Linux, cửa sổvà macOS.

Nó tập trung vào:
- sự nhẹ nhàng: gốc, chỉ hiển thị màn hình thiết bị
- hiệu suất: 30~120fps, tùy thuộc vào thiết bị
- chất lượng: 1920×1080 trở lên
- độ trễ thấp: 35~70 mili giây
- thời gian khởi động thấp: ~1 giây để hiển thị hình ảnh đầu tiên
- tính không xâm phạm: không còn gì được cài đặt trên thiết bị Android
- lợi ích người dùng: không cần tài khoản, không quảng cáo, không cần internet
- sự tự do: phần mềm mã nguồn mở và miễn phí
Các tính năng của nó bao gồm:
- chuyển tiếp âm thanh (Android 11+)
- ghi âm
- hiển thị ảo
- phản ánh với Tắt màn hình thiết bị Android
- sao chép-dán theo cả hai hướng
- chất lượng cấu hình
- phản chiếu máy ảnh (Android 12+)
- phản chiếu dưới dạng webcam (V4L2) (Chỉ dành cho Linux)
- thể chất bàn phím và chuột mô phỏng (HID)
- tay cầm chơi game hỗ trợ
- Chế độ OOT
- và hơn thế nữa…
Điều kiện tiên quyết
Thiết bị Android yêu cầu ít nhất API 21 (Android 5.0).
Chuyển tiếp âm thanh được hỗ trợ cho API >= 30 (Android 11+).
Hãy chắc chắn rằng bạn đã bật gỡ lỗi USB trên (các) thiết bị của bạn.
Trên một số thiết bị (đặc biệt là Xiaomi), bạn có thể gặp lỗi sau:
Injecting input events requires the caller (or the source of the instrumentation, if any) to have the INJECT_EVENTS permission.
Trong trường hợp đó, bạn cần kích hoạt một lựa chọn bổ sung USB debugging (Security Settings) (đây là một mục khác với USB debugging) để điều khiển nó bằng bàn phím và chuột. Việc khởi động lại thiết bị là cần thiết sau khi tùy chọn này được đặt.
Lưu ý rằng không cần phải gỡ lỗi USB để chạy scrcpy trong Chế độ OOT.
Tải ứng dụng
- Linux
- cửa sổ (đọc làm thế nào để chạy)
- macOS
Những lời khuyên cần biết
- Giảm độ phân giải có thể cải thiện đáng kể hiệu suất (
scrcpy -m1024) - Nhấp chuột phải yếu tố kích hoạt
BACK - Nhấp chuột giữa yếu tố kích hoạt
HOME - Alt+f chuyển đổi toàn màn hình
- Có nhiều thứ khác phím tắt
Ví dụ sử dụng
Có rất nhiều lựa chọn, tài liệu trong các trang riêng biệt. Đây chỉ là một số ví dụ phổ biến.
Chụp màn hình ở H.265 (chất lượng tốt hơn), giới hạn kích thước ở mức 1920, giới hạn tốc độ khung hình ở 60fps, tắt âm thanh và điều khiển thiết bị bằng cách mô phỏng bàn phím vật lý:
scrcpy --video-codec=h265 --max-size=1920 --max-fps=60 --no-audio --keyboard=uhid scrcpy --video-codec=h265 -m1920 --max-fps=60 --no-audio -K # short versionKhởi động VLC trong màn hình ảo mới (tách biệt với màn hình thiết bị):
scrcpy --new-display=1920x1080 --start-app=org.videolan.vlcBắt đầu VLC trong một cái mới uốn cong hiển thị bằng H.265 với tốc độ bit 16 Mbps, đồng thời giữ cho màn hình hoạt động để không tắt:
scrcpy --new-display -x --keep-active --start-app=org.videolan.vlc --video-codec=h265 -b16MGhi camera của thiết bị ở H.265 ở 1920x1080 (và micrô) thành tệp MP4:
scrcpy --video-source=camera --video-codec=h265 --camera-size=1920x1080 --record=file.mp4Chụp camera trước của thiết bị và hiển thị dưới dạng webcam trên máy tính (trên Linux):
scrcpy --video-source=camera --camera-size=1920x1080 --camera-facing=front --v4l2-sink=/dev/video2 --no-playbackĐiều khiển thiết bị mà không cần phản chiếu bằng cách mô phỏng bàn phím và chuột vật lý (không cần gỡ lỗi USB):
scrcpy --otgĐiều khiển thiết bị bằng gamepad cắm vào máy tính:
scrcpy --gamepad=uhid scrcpy -G # short version
Tài liệu người dùng
Ứng dụng này cung cấp rất nhiều tính năng và tùy chọn cấu hình. Chúng được ghi lại trong các trang sau:
- Kết nối
- Video
- Âm thanh
- Kiểm soát
- Bàn phím
- Chuột
- Tay cầm chơi game
- Thiết bị
- Cửa sổ
- Ghi âm
- Hiển thị ảo
- Đường hầm
- otg
- Máy ảnh
- Video4Linux
- Phím tắt
Tài nguyên
- Câu hỏi thường gặp
- Bản dịch (không nhất thiết phải cập nhật)
- Hướng dẫn xây dựng
- Nhà phát triển
- Xác minh chữ ký phát hành
bài viết
Liên hệ
Bạn có thể mở một vấn đề để biết các báo cáo lỗi, yêu cầu tính năng hoặc các câu hỏi chung.
Để báo cáo lỗi, vui lòng đọc Câu hỏi thường gặp đầu tiên, bạn có thể tìm ra giải pháp cho vấn đề của mình ngay lập tức.
Bạn cũng có thể sử dụng:
- Reddit:
r/scrcpy - BlueSky:
@scrcpy.bsky.social - Twitter:
@scrcpy_app
Đóng góp
tôi là @rom1v, tác giả và người duy trì cẩn thận.
Nếu bạn đánh giá cao ứng dụng này, bạn có thể hỗ trợ công việc nguồn mở của tôi:
Giấy phép
Copyright (C) 2018 Genymobile
Copyright (C) 2018-2026 Romain Vimont
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Dự án cùng danh mục
😎 Danh sách tuyệt vời về tất cả các loại chủ đề thú vị [LƯU Ý: Yêu cầu kéo tạm thời bị vô hiệu hóa cho đến khi tôi có cơ hội bắt kịp những chủ đề hiện có]
:books: Sách lập trình được cung cấp miễn phí
Danh sách các hướng dẫn dựa trên dự án được tuyển chọn
Tất cả các thuật toán được triển khai trong Python
Tài liệu chuẩn bị phỏng vấn viết mã được tuyển chọn dành cho các kỹ sư phần mềm bận rộn