Escrcpy
Отображение и управляйте устройством Android с помощью графического интерфейса SCRCPY Powered By Electron. 中文文档
Функции
- ? Синхронный: польза от веб -технологий для синхронизации с Scrcpy быстрее
- ? Автоматизация: устройства автоматического соединения, автоматические изображения, пользовательские сценарии, запланированные задачи
- Настройка: управление несколькими устройствами, независимые конфигурации, пользовательские заметки, импорт/экспорт конфигурации/экспорт
- ? Беспроводная связь: быстрое соединение, сканируя QR -код
- ? Обратное привязка: Gnirehtet обратное привязка
- ? Темы: режим света, темный режим, системный переключение
- ? Легкий вес: нативная поддержка, только экран отображения устройства
- ⚡ Производительность: 30-120 кадров в секунду в зависимости от устройства
- ? Качество: 1920 × 1080 или выше
- Низкая задержка: 35 ~ 70 мс
- Быстрый стартап: отображать первое изображение примерно на 1 секунду
- ? ♂️ Неструвтузие: Остаток установки не остается на устройстве Android
- ? Пользовательские преимущества: нет учетной записи, нет рекламы, не требуется интернет
- ? Бесплатный и открытый исходный код
Установка
Ручная установка через выпущенные пакеты
Просмотреть адрес выпуска
macOS можно установить через Homebrew
Смотрите Homebrew-escrcpy
Быстрый старт
USB -соединение
ПРИМЕЧАНИЕ. Если телефон предлагает отладку авторизации, нажмите «Разрешить
- Включить режим разработчика и отладку USB на вашем телефоне Android
- Откройте ESCRCPY и подключите свой телефон Android к компьютеру
- Список устройств в Escrcpy должен был обнаружить ваш телефон, нажмите «Запуск зеркалирования»
- Наслаждаться!
Wi -Fi Connection
Сканировать QR -код для подключения
- Следуйте шагам 1-2 из USB-соединения
- Включить и введите беспроводную отладку в режиме разработчика
- Нажмите «Пара устройства с помощью QR -кода»
- Начните наслаждаться!
Подключиться через IP -адрес
Примечание. Если исходное беспроводное соединение не удается, вам может потребоваться беспроводное сочетание. Пожалуйста, обратитесь к FAQ
Примечание. Вам необходимо включить беспроводную отладку и получить беспроводной адрес вашего устройства (обычно IP -адрес, назначенный при подключении к Wi -Fi) и номер порта (по умолчанию 5555) со страницы беспроводной отладки
- Следуйте шагам 1-2 из USB-соединения
- Введите полученный IP -адрес устройства и номер порта в ESCRCPY, затем нажмите «Подключить устройство»
- На этом этапе список устройств ESCR
- Начните наслаждаться!
macos && linux
Примечание: эти платформы не поставляются с интегрированной SCRCPY, вам нужно установить их вручную
На [email protected]+ Двоирные файлы Scrcpy предварительно интегрированы, что устраняет необходимость в ручной установке Scrcpy.
- См. Установочный документ для Linux
- См. Установочный документ для MacOS
- Следуйте шагам в USB -соединении и соединении Wi -Fi после успешного установки зависимостей
Gnirehtet обратное привязка
Примечание: MacOS не имеет встроенного встроенного. Вам нужно вручную установить его, чтобы использовать это руководство по установке функции.
Gnirehtet встроен в приложения Windows и Linux, чтобы обеспечить обратное привязку от ПК к устройствам Android.
Разработчики
Если вы разработчик и хотите запустить или помочь улучшить этот проект, пожалуйста, посмотрите документацию по разработке
Ярлыки
Обратитесь к Scrcpy/Doc/Shortcuts
Работа устройства
Партийная обработка
- Экраны перехвата партии
- Приложение для установки партии
- Управление пакетным файлом
- Скрипт выполнения партии
- Партия запланированная задача
Модель управления
- Зеркало
- Запись
- Запись камеры
- Запись аудио
- Камера
- Обычай
- Otg
Устройство взаимодействия
- Выключатель
- Дом
- Назад
- Приложение Start (зеркальная группа)
- Выключить экран (экспериментальный)
- Уведомление
- Власть
- Ротация
- Объем
- Скриншот
- Перезагрузить
- Установить приложение
- Файловый менеджер
- Скрипт выполнения
- Запланированное задание
- Gnirehtet
Предпочтения
Непрерывно улучшается. В настоящее время поддерживает следующие общие конфигурации
Общий
- Тема
- Язык
- Путь хранения файлов
- ADB PATH
- Scrcpy Path
- Гнирехтет путь
- Параметры SCRCPY
- Auto-Connect Device
- Автопокатное зеркалирование
- Gnirehtet Fix
- Отлаживать
- Плавающая панель управления
Видео управление
- Отключить переадресацию видео
- Максимальный размер
- Видео битрейт
- Обновление частоты
- Видеокодек
- Ориентация отображения
- Угол вращения
- Экранная обрезка
- Монитор
- Видео буфер
- Приемник (V4L2) буфер
Управление устройством
- Показать точки прикосновения
- Продолжайте бодрствовать
- Выключить экран во время управления
- Выключить экран после управления
- Отключить автоматический экран во время управления
- Смоделировать вспомогательный дисплей
Управление окном
- Ширина окна
- Высота окна
- Окно X-координат
- Окно y-координат
- Безграничный режим
- Полноэкранный режим
- Всегда на вершине
- Отключить заставку
Аудио контроль
- Отключить пересылку звука
- Сохраняйте звук устройства
- Аудио источник
- Аудиокодек
- Аудио битрейт
- Аудио буфер
- Аудио выходной буфер
Аудио/видеозапись
- Запишите видео -формат
- Запишите видео ориентацию
- Продолжительность записи
- Отключить воспроизведение видео
- Отключить воспроизведение звука
Входной элемент управления
- Мышиный режим
- Привязка мыши
- Режим клавиатуры
- Метод впрыска клавиатуры
- Геймпад
Управление камерой
- Источник камеры
- Размер камеры
- Соотношение камеры
- Частота кадров
Следующие шаги?
Приоритет от высокого до низкого:
- Улучшенный логотип ✅
- Функция обновления программного обеспечения ✅
- Записать и сохранить аудио/видео ✅
- Устройство быстрого управления взаимодействием ✅
- Пользовательские зависимости ADB и SCRCPY ✅
- Пользовательские имена устройств ✅
- Предпочтения экспорта и импорта ✅
- Индивидуальная конфигурация устройства ✅
- Поддержка MacOS и Linux ✅
- Интернационализация ✅
- Темный режим ✅
- Обратное привязка (гнирехтет) ✅
- Камера зеркалирование ✅
- Многоэкранное сотрудничество ✅
- Нажатие файла, вращение экрана, управление звуком ✅
- Пакетная подключение исторических устройств ✅
- Встроенный терминал ✅
- Автопокатирование зеркалирования ✅
- Гибкий запуск зеркалирования ✅
- Переработка партии ✅
- Запланированные задачи ✅
- Графический файловый диспетчер ✅
- Плавающийся контроль ✅
- Улучшенная запись ✅
- Приложение Start (многопоточное) ✅
- Край главного окна скрыт ✅
- Групповые устройства (фильтрация замечаний) ✅
- Улучшенный опыт подключения к устройству истории ✅
- Управление файлами поддерживает каталог загрузки и отображение прогресса?
- Картирование ключей игры?
Часто задаваемые вопросы
Компьютер не может обнаружить устройство после подключения
- Пожалуйста, отключите и подключите ваше устройство, и убедитесь, что устройство предоставило USB -отладому разрешение.
- Если это все еще не работает, ваш компьютер может пропустить необходимые драйверы. Пожалуйста, установите драйверы, используя сторонние инструменты, такие как DriverWizard, и попробуйте еще раз.
Невозможно войти в китайский
В [email protected]+ и выше, решение заключается в следующем:
- Настройки ESCRCPY: перейдите к
Preferences → Input Control → Keyboard Mode и выберите режим uhid . - Подготовка метода ввода устройства: установите метод ввода, который поддерживает физические клавиатуры (рекомендуется вход WeChat) и завершите установку.
- Начало зеркалирование: нажмите
Start Mirroring в Escrcpy. Проверка: Settings устройства → System → Language & Input должны отображать параметры для Physical Keyboard и On-screen Keyboard . - Настройки ввода устройства: включите метод ввода WeChat в настройках
On-screen Keyboard . Настройте макет клавиатуры в настройках Physical Keyboard , чтобы соответствовать клавиатуре компьютера (нужно сделать только один раз). - Подготовка ввода компьютера: установите режим ввода на английский (важно).
- Переключение языка ввода: используйте
Ctrl + Shift для переключения между английским и китайским. - Начните использовать.
Скачать метод ввода WeChat
Подсказки беспроводного соединения: целевой компьютер активно отказывается от доступа
Первое беспроводное соединение может потребовать сочетания. В качестве альтернативы, вставьте USB, чтобы обеспечить успех установления соединения и авторизации, прежде чем использовать беспроводную связь.
Нажатие беспроводного режима после подключения через кабель данных не имеет ответа
Пожалуйста, нажмите еще раз или нажмите устройства обновления. Обычно это не будет превышать два щелчка. Если все еще не работает, пожалуйста, предоставьте модель устройства и версию Android для проблем
Почему строка управления взаимодействием устройства не разработана как автоматически прилипающее плавающее меню?
Важно отметить, что, в принципе, ESCRCPY является просто версией GUI, основанной на SCRCPY, хотя она расширяет некоторые функциональность. Однако эти расширения не влияют на ядро Scrcpy. Чтобы реализовать эту конкретную функцию, мне придется изменить базовый код SCRCPY, что затрудняет ESCRCPY, чтобы оставаться в синхронизации с обновлениями SCRCPY, и недостатки перевесят преимущества.
Поэтому, после тщательного рассмотрения, мы решили принять существующее решение и рассчитываем на Scrcpy добавить нативную поддержку интерактивной панели управления в будущем.
Некоторые устройства могут видеть скриншоты после подключения, но не могут работать
Примечание. В частности, для телефонов Xiaomi это требует не только обеспечения отладки USB, но и для отладки USB (настроек безопасности), что позволяет разрешить изменение разрешений или моделирование кликов с помощью отладки USB.
Пожалуйста, обратитесь к подробным инструкциям по причинам, почему мыши и клавиатура не работают
Загрузка подсказка для обнаружения антивируса, вызывая нормально загружать
После отзывы Defender Windows может иногда блокировать программные пакеты от загрузки из -за отсутствия подписания сертификатов. Вы можете попробовать следующие решения:
- Открыть
Windows Security Center . - Выберите
Virus & threat protection . - В
Virus & threat protection settings нажмите Manage settings . - Найдите
Real-time protection , вы можете попробовать нажать отключить, если разрешается разрешение. Если невозможно отключить защиту в режиме реального времени, пожалуйста, пропустите этот шаг. - Прокрутите страницу, найдите
Exclusions , нажмите Add or remove exclusions . - Добавьте путь к папке, где вы загружаете программные пакеты в качестве элемента исключения, то есть добавьте папку в
Excluded list .
Не удалось получить список устройств или ошибки при запуска зеркалирования/записи
Обычно это вызвано неправильным путем для Adb или Scrcpy , вы можете попробовать следующие решения:
- В меню выберите
Preferences , а затем нажмите кнопку «Сбросить конфигурацию» в правом верхнем углу Global Mode . - Перейдите на страницу
Device List и попробуйте снова включить зеркалирование. - Убедитесь, что вы загрузили и установили последнюю версию
Escrcpy . - Нажмите
Ctrl + Shift + I , чтобы открыть инструменты разработчика и проверить любые сообщения об ошибках. - Если есть ошибки, сделайте снимок экрана и отправьте свою проблему с помощью скриншота на странице «Проблемы с обратной связью».
Окно macOS минимизировано в системном значке лотка, не найденной
Как правило, это вызвано слишком большим количеством икон в системном лотке, переполненном и скрыванием значка Escrcpy. Попробуйте использовать следующие инструменты:
После успешной установки MacOS, когда я пытаюсь ее открыть, я получаю подсказку, говоря, что файл поврежден.
Обычно это связано с тем, что пакет программного обеспечения не подписан. Вы можете попробовать следующие решения:
- Открыть терминал и выполнить
sudo spctl --master-disable чтобы разрешить программное обеспечение из любого источника. - Открыть терминал и выполнить
sudo xattr -r -d com.apple.quarantine /Applications/Escrcpy.app чтобы попытаться исправить поврежденную программу.
Невозможно найти входную точку DiscardVirtualMemory в ядре динамической библиотеки ссылок.
Поддержите только версии Windows 10 и выше.
Аудио захватывает исключение, вызывая сбой зеркалирования.
Обычно это происходит потому, что вашему компьютеру не хватает аудио вывода или у вас низкая версия Android (Android 11+).
Пожалуйста, попробуйте disabling audio forwarding через preferences settings для решения этой проблемы.
Microsoft Store Version Version Mirror Erry Startup
Это вызвано файлами в каталоге установки, в которых отсутствуют исполняемые разрешения.
Вам необходимо настроить пути файла для scrcpy и adb (гарантируя, что у них есть исполняемые разрешения). При использовании обратного привязанности настройте gnirehtet аналогичным образом.
Не мог выполнить "ADB Start-Server"
Это может быть связано с китайскими или специальными символами в пути установки. Пожалуйста, попробуйте изменить путь установки.
Невозможно открыть после установки в системе Linux
Новые ограничения были реализованы для приложений Appimage в некоторых популярных распределениях, таких как Ubuntu 24.04, ограничивая использование песочниц. Временный обходной путь выглядит следующим образом:
sudo chmod 4755 /opt/Escrcpy/chrome-sandbox
Получить помощь
Поскольку это проект с открытым исходным кодом, полностью запускающийся пожертвованиями, поддержка ограничена, и обновления могут не быть в фиксированном графике.
Благодарности
Этот проект был бы невозможным без следующих проектов с открытым исходным кодом:
- Scrcpy
- adbkit
- электрон
- Vue
- Gnirehtet
Спонсорский проект
Если этот проект помог вам, вы можете купить мне кофе, чтобы удержать меня энергией и улучшить проект! ?
Участники
Спасибо за их вклад!
Участники
Звездная история