Этот репозиторий GitHub (https://github.com/Genymobile/scrcpy) является единственным официальным источником проекта. Не загружайте релизы со случайных сайтов, даже если их название содержит scrcpy
.
произносится как « скрин копия »
Это приложение отражает устройства Android (видео и аудио), подключенные через USB или TCP/IP, и позволяет управлять устройством с помощью клавиатуры и мыши компьютера. Он не требует root- доступа. Он работает на Linux , Windows и macOS .
Он фокусируется на:
яркость : родная, отображает только экран устройства
производительность : 30~120 кадров в секунду, в зависимости от устройства
качество : 1920×1080 или выше
низкая задержка : 35~70 мс
низкое время запуска : ~ 1 секунда для отображения первого изображения
ненавязчивость : на устройстве Android ничего не установлено
преимущества пользователя : нет аккаунта, нет рекламы, интернет не требуется.
свобода : бесплатное программное обеспечение с открытым исходным кодом.
Его особенности включают в себя:
пересылка звука (Android 11+)
запись
зеркалирование с выключенным экраном устройства Android
копипаста в обе стороны
настраиваемое качество
зеркальное отображение камеры (Android 12+)
зеркалирование в качестве веб-камеры (V4L2) (только для Linux)
физическая симуляция клавиатуры и мыши (HID)
поддержка геймпада
режим OTG
и многое другое…
Для устройства Android требуется API не ниже 21 (Android 5.0).
Пересылка звука поддерживается для API >= 30 (Android 11+).
Убедитесь, что вы включили отладку по USB на своих устройствах.
На некоторых устройствах (особенно Xiaomi) вы можете получить следующую ошибку:
java.lang.SecurityException: Injecting input events requires the caller (or the source of the instrumentation, if any) to have the INJECT_EVENTS permission.
В таком случае вам необходимо включить дополнительную опцию USB debugging (Security Settings)
(это пункт, отличный от USB debugging
), чтобы управлять ею с помощью клавиатуры и мыши. После установки этой опции необходима перезагрузка устройства.
Обратите внимание, что отладка по USB не требуется для запуска scrcpy в режиме OTG.
Линукс
Окна
macOS
Вариантов много, они описаны на отдельных страницах. Вот лишь некоторые распространенные примеры.
Снимите экран в формате H.265 (лучшее качество), ограничьте размер до 1920, ограничьте частоту кадров до 60 кадров в секунду, отключите звук и управляйте устройством, имитируя физическую клавиатуру:
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 # короткая версия
Запишите камеру устройства в формате H.265 с разрешением 1920x1080 (и микрофон) в файл MP4:
scrcpy --video-source=камера --video-codec=h265 --camera-size=1920x1080 --record=file.mp4
Захватите переднюю камеру устройства и выставьте ее как веб-камеру на компьютере (в Linux):
scrcpy --video-source=камера --camera-size=1920x1080 --camera-facing=front --v4l2-sink=/dev/video2 --no-playback
Управляйте устройством без зеркалирования, имитируя физическую клавиатуру и мышь (отладка по USB не требуется):
scrcpy --otg
Управляйте устройством с помощью геймпада, подключенного к компьютеру:
scrcpy --gamepad=uhid scrcpy -G # короткая версия
Приложение предоставляет множество функций и возможностей настройки. Они описаны на следующих страницах:
Связь
Видео
Аудио
Контроль
Клавиатура
Мышь
Геймпад
Устройство
Окно
Запись
Туннели
ОТГ
Камера
Видео4Linux
Ярлыки
Часто задаваемые вопросы
Переводы (не обязательно актуальные)
Инструкции по сборке
Разработчики
Представляем scrcpy
Scrcpy теперь работает без проводов
Scrcpy 2.0, со звуком
Вы можете открыть проблему для отчетов об ошибках, запросов на добавление функций или общих вопросов.
Для сообщений об ошибках сначала прочтите FAQ, возможно, вы сразу найдете решение своей проблемы.
Вы также можете использовать:
Reddit: r/scrcpy
Твиттер: @scrcpy_app
Я @rom1v, автор и сопровождающий scrcpy .
Если вам нравится это приложение, вы можете поддержать мою работу с открытым исходным кодом:
Спонсоры GitHub
Либерапей
PayPal
Copyright (C) 2018 Genymobile Copyright (C) 2018-2024 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.