Cool_Tools/escrcpy

Fork 0

mirror of https://github.com/viarotel-org/escrcpy.git synced 2024-11-23 23:21:02 +01:00

viarotel b5809937d6 docs: 📝 Update README

2024-11-07 10:25:35 +08:00

25 KiB

Raw Blame History

Escrcpy

📱 Отображение и управление вашим Android-устройством с графическим интерфейсом Scrcpy на базе Electron. English

Особенности

🏃 Синхронность: Использование веб-технологий для более быстрой синхронизации с Scrcpy
🤖 Автоматизация: Автоподключение устройств, автоисполнение изображений, пользовательские скрипты, запланированные задачи
💡 Настройка: Управление несколькими устройствами, независимые конфигурации, пользовательские заметки, импорт/экспорт настроек
🔗 Обратный тетеринг: Обратный тетеринг с помощью Gnirehtet
🎨 Темы: Светлая тема, темная тема, переключение в зависимости от системы
😎 Легковесность: Нативная поддержка, отображает только экран устройства
⚡️ Производительность: От 30 до 120 кадров в секунду в зависимости от устройства
🌟 Качество: 1920×1080 или выше
🕒 Низкая задержка: 35~70 мс
🚀 Быстрый запуск: Отображение первого изображения примерно за 1 секунду
🙅‍♂️ Ненавязчивость: Нет остаточных установок на Android-устройстве
🤩 Пользовательские преимущества: Без аккаунта, без рекламы, не требуется интернет
🗽 Бесплатно и с открытым исходным кодом

Получение программного обеспечения

Скачать можете в Releases

Быстрый старт

Подключение по USB

Примечание: Если телефон запрашивает разрешение на отладку, нажмите "Разрешить"

Включите режим разработчика и отладку по USB на вашем Android-телефоне
Откройте Escrcpy и подключите ваш Android-телефон к компьютеру
В списке устройств Escrcpy должно обнаружить ваш телефон, нажмите "Начать зеркалирование"
Наслаждайтесь!

Подключение по Wi-Fi

Примечание: Для беспроводной отладки необходимо включить беспроводную отладку на странице беспроводной отладки телефона, чтобы получить IP-адрес (обычно IP, назначенный при подключении к Wi-Fi) и номер порта (по умолчанию 5555) устройства

Следуйте шагам 1-2 из раздела "Подключение по USB"
Введите IP-адрес устройства и номер порта, полученные на предыдущем шаге, в Escrcpy и нажмите "Подключить устройство"
В списке устройств Escrcpy должно обнаружить ваш телефон, нажмите "Начать зеркалирование"
Наслаждайтесь!

macOS и Linux

Примечание: Эти платформы не имеют встроенного Scrcpy, необходимо установить его вручную

Ознакомьтесь с документацией по установке для Linux
Ознакомьтесь с документацией по установке для macOS
После успешной установки зависимостей следуйте шагам из разделов "Подключение по USB" и "Подключение по Wi-Fi"

Обратный тетеринг Gnirehtet

Примечание: macOS не имеет встроенного Gnirehtet. Необходимо установить его вручную, чтобы использовать эту функцию Руководство по установке.

Gnirehtet встроен в приложения для Windows и Linux, чтобы обеспечить обратный тетеринг с ПК на Android-устройства.

Разработчики

Если вы разработчик и хотите запустить или помочь улучшить этот проект, ознакомьтесь с документацией по разработке

Горячие клавиши

См. scrcpy/doc/shortcuts

Операции с устройством

Пакетная обработка

Пакетное создание скриншотов
Пакетная установка приложений
Пакетное управление файлами
Пакетное выполнение скриптов
Пакетные запланированные задачи

Модель управления

Зеркалирование
Запись
Запись с камеры
Запись аудио
Камера
Гибкий запуск
OTG

Панель взаимодействия с устройством

Переключатель
Домой
Назад
Запустить приложение
Выключение экрана (экспериментально)
Уведомление
Питание
Поворот
Громкость
Скриншот
Перезагрузка
Установить приложение
Файловый менеджер
Выполнить скрипт
Запланированная задача
Gnirehtet
Группа зеркалирования (отказаться)

Настройки

Постоянно улучшаются. В настоящее время поддерживаются следующие общие настройки

Общие

Тема
Язык
Путь сохранения файлов
Путь к Adb
Путь к Scrcpy
Путь к Gnirehtet
Параметры Scrcpy
Автоподключение устройства
Автозапуск зеркалирования
Исправление Gnirehtet
Отладка
Плавающая панель управления

Управление видео

Отключить передачу видео
Максимальный размер
Битрейт видео
Частота обновления
Кодек видео
Ориентация дисплея
Обрезка экрана
Монитор
Видео буфер
Буфер приемника (v4l2)

Управление устройством

Показать точки касания
Не выключать экран
Выключить экран во время управления
Выключить экран после управления
Отключить автоматическое включение экрана во время управления
Эмуляция вспомогательного дисплея

Управление окном

Ширина окна
Высота окна
Координата окна X
Координата окна Y
Безрамочный режим
Полноэкранный режим
Всегда сверху
Отключить заставку

Управление аудио

Отключить передачу аудио
Сохранить аудио устройства
Источник аудио
Кодек аудио
Битрейт аудио
Аудио буфер
Буфер аудио вывода

Запись аудио/видео

Формат записи видео
Ориентация записываемого видео
Длительность записи
Отключить воспроизведение видео
Отключить воспроизведение аудио

Управление вводом

Режим мыши
Привязка мыши
Режим клавиатуры
Метод ввода с клавиатуры
Геймпад

Управление камерой

Источник камеры
Размер камеры
Соотношение сторон камеры
Частота кадров камеры

Что дальше?

Приоритет от высокого к низкому:

Улучшенный логотип ✅
Функция обновления программного обеспечения ✅
Запись и сохранение аудио/видео ✅
Панель быстрого взаимодействия с устройством ✅
Пользовательские зависимости Adb и Scrcpy ✅
Пользовательские имена устройств ✅
Экспорт и импорт настроек ✅
Индивидуальная конфигурация устройств ✅
Поддержка macOS и Linux ✅
Интернационализация ✅
Темный режим ✅
Обратный тетеринг (Gnirehtet) ✅
Зеркалирование камеры ✅
Многодисплейное взаимодействие ✅
Передача файлов, поворот экрана, управление аудио ✅
Пакетное подключение исторических устройств ✅
Встроенный терминал ✅
Автозапуск зеркалирования ✅
Гибкий запуск зеркалирования ✅
Пакетная обработка ✅
Запланированные задачи ✅
Графический файловый менеджер ✅
Плавающая панель управления ✅
Улучшенная запись ✅
Запустить приложение (многопоточное) ✅
Улучшен опыт подключения истории устройств 🚧
Управление файлами поддерживает каталог загрузки и отображение прогресса 🚧
Группировка устройств 🚧
Карта клавиш для игр 🚧

Часто задаваемые вопросы

Компьютер не может обнаружить устройство после подключения

Пожалуйста, отключите и снова подключите ваше устройство и убедитесь, что устройство предоставило разрешение на отладку по USB.
Если это не помогло, возможно, на вашем компьютере отсутствуют необходимые драйверы. Пожалуйста, установите драйверы с помощью сторонних инструментов, таких как DriverWizard, и попробуйте снова.

Невозможно ввести китайские символы

В Scrcpy@2.4+ и выше, решение следующее:

Настройки Escrcpy: Перейдите в Настройки → Управление вводом → Режим клавиатуры и выберите режим uhid.
Подготовка метода ввода на устройстве: Установите метод ввода, поддерживающий физические клавиатуры (рекомендуется WeChat Input Method) и завершите настройку.
Запуск зеркалирования: Нажмите Начать зеркалирование в Escrcpy. Проверка: В Настройки устройства → Система → Язык и ввод должны отображаться опции Физическая клавиатура и Экранная клавиатура.
Настройки ввода на устройстве: Включите WeChat Input Method в настройках Экранной клавиатуры. Настройте раскладку клавиатуры в настройках Физической клавиатуры, чтобы она соответствовала клавиатуре компьютера (нужно сделать только один раз).
Подготовка ввода на компьютере: Установите режим ввода на английский (важно).
Переключение языка ввода: Используйте Ctrl + Shift для переключения между английским и китайским.
Начните использовать.

Скачать WeChat Input Method

При беспроводном подключении появляется сообщение: Удаленный компьютер принудительно разорвал существующее подключение

Первое беспроводное подключение может потребовать сопряжения. Либо подключите USB, чтобы обеспечить установление соединения и успешную авторизацию перед использованием беспроводного подключения.

Нажатие на беспроводной режим после подключения через кабель не реагирует

Пожалуйста, нажмите еще раз или нажмите "Обновить устройства". Обычно не требуется более двух нажатий. Если все еще не работает, пожалуйста, предоставьте модель устройства и версию Android в разделе Issues

Почему панель управления устройством не спроектирована как автоматически прикрепляющееся плавающее меню?

Важно отметить, что, по сути, Escrcpy — это просто графическая версия на основе Scrcpy, хотя она расширяет некоторый функционал. Однако эти расширения не влияют на ядро Scrcpy. Чтобы реализовать эту конкретную функцию, мне пришлось бы изменить основной код Scrcpy, что затруднило бы синхронизацию Escrcpy с обновлениями Scrcpy, и недостатки перевешивали бы преимущества.

Поэтому, после тщательного рассмотрения, мы решили принять существующее решение и надеемся, что в будущем Scrcpy добавит нативную поддержку панели интерактивного управления.

Некоторые устройства после подключения показывают скриншоты, но не позволяют управлять

Примечание: В частности, для телефонов Xiaomi требуется не только включение отладки по USB, но и включение опции "USB-отладка (настройки безопасности)", которая позволяет изменять разрешения или симулировать нажатия через отладку по USB.

Пожалуйста, ознакомьтесь с подробными инструкциями в разделе Причины, по которым мышь и клавиатура не работают

При загрузке появляется предупреждение о вирусе, не удается нормально скачать

По отзывам, Windows Defender может иногда блокировать загрузку программных пакетов из-за отсутствия подписи сертификата. Вы можете попробовать следующие решения:

Откройте Центр безопасности Windows.
Выберите Защита от вирусов и угроз.
В Параметры защиты от вирусов и других угроз нажмите Управление настройками.
Найдите Защита в режиме реального времени, вы можете попробовать отключить, если у вас есть соответствующие права. Если не удается отключить защиту в реальном времени, пропустите этот шаг.
Прокрутите страницу вниз, найдите Исключения, нажмите Добавить или удалить исключения.
Добавьте путь к папке, куда вы загружаете программные пакеты, в качестве исключения, т.е. добавьте папку в Список исключений.

Не удалось получить список устройств или ошибка при запуске зеркалирования/записи

Это обычно вызвано неправильным путем к Adb или Scrcpy, вы можете попробовать следующие решения:

В меню выберите Настройки, затем нажмите кнопку сброса конфигурации в правом верхнем углу Глобальный режим.
Перейдите на страницу Список устройств и попробуйте снова включить зеркалирование.
Убедитесь, что вы скачали и установили последнюю версию Escrcpy.
Нажмите Ctrl + Shift + I, чтобы открыть инструменты разработчика и проверить наличие сообщений об ошибках.
Если есть ошибки, сделайте скриншот и отправьте свой вопрос с изображением на страницу Feedback Issues.

В macOS после сворачивания окна в системный трей иконка не отображается

Это обычно происходит из-за слишком большого количества иконок в системном трее, что приводит к переполнению и скрытию иконки Escrcpy. Попробуйте использовать следующие инструменты:

После успешной установки на macOS при попытке открыть появляется сообщение, что файл поврежден

Обычно это связано с тем, что пакет программного обеспечения не подписан. Вы можете попробовать следующие решения:

Откройте Терминал и выполните sudo spctl --master-disable, чтобы разрешить программы из любого источника.
Откройте Терминал и выполните sudo xattr -r -d com.apple.quarantine [AppPath], чтобы попытаться исправить сообщение о поврежденном программном пакете.

Не удалось найти точку входа DiscardvirtualMemory в библиотеке Kernel32.dll.

Поддерживаются только версии Windows 10 и выше.

Исключение при захвате аудио вызывает сбой зеркалирования.

Это обычно происходит, потому что на вашем компьютере отсутствует аудиовыход или у вас низкая версия Android (Android 11+).

Попробуйте отключить передачу аудио через настройки предпочтений, чтобы решить эту проблему.

Ошибка запуска зеркалирования в версии Microsoft Store

Это вызвано отсутствием разрешений на выполнение файлов в каталоге установки.

Вам нужно настроить пользовательские пути к файлам для scrcpy и adb (убедившись, что у них есть разрешения на выполнение). Если вы используете обратный тетеринг, аналогично настройте gnirehtet.

Could not execute "adb start-server"

Это может быть вызвано наличием китайских или специальных символов в пути установки. Попробуйте изменить путь установки.

Получение помощи

Поскольку это проект с открытым исходным кодом, полностью поддерживаемый пожертвованиями, поддержка ограничена, и обновления могут не выходить по фиксированному расписанию.

Вопросы: Отправить отзыв
Email: viarotel@qq.com

Благодарности

Этот проект не был бы возможен без следующих проектов с открытым исходным кодом:

Поддержка проекта

Если этот проект помог вам, вы можете купить мне кофе, чтобы поддержать меня в улучшении проекта! 😛

Участники

Спасибо всем за их вклад!

25 KiB Raw Blame History Unescape Escape