y83 code / справочник

Запись экрана

Запись экрана телефона в файл: можно записать демонстрацию, показать настройки или просто снять, что происходит на экране.

раздел
Подсистемы приложения
пунктов возможностей
17
источник
docs/about/record.md

Возможности

  • Выбор качества: сколько данных тратится на секунду записи, размер картинки и количество кадров в секунду настраиваются отдельно. Чем выше, тем чётче картинка и тем больше файл.
  • Звук: системный (что звучит на телефоне), микрофон (ваш голос), оба сразу или без звука вовсе.
  • Показ касаний — можно включить, и на записи будет видно, куда вы нажимаете. Настройка системная, Android, а не только в приложении.
  • Обратный отсчёт перед стартом: можно отменить, если не успели подготовиться.
  • Во время записи видно таймер, размер файла и оценку, сколько ещё хватит места.
  • Пауза и остановка прямо во время записи.
  • История прошлых записей: открыть, поделиться, скопировать путь, удалить или отправить в видеоредактор для обрезки.
  • Перед стартом приложение проверяет, всё ли готово, и говорит об этом до записи, а не после.

Технические данные

ПараметрЗначение
Куда пишетпапка «Загрузки» телефона
Форматобычный видеофайл, открывается любым проигрывателем
Свободного места нужноне меньше 512 МБ
Системный звукс Android 10 и новее
Микрофонвключается по запросу
Настройкизапоминаются между запусками
Работа через сервернет, всё делается на телефоне

Что проверяется перед стартом

Запись не начинается вслепую. Сначала проверяется: разрешена ли запись экрана, хватает ли свободного места, не садится ли телефон от нагрузки, включён ли показ касаний в системе и есть ли доступ к микрофону. Если что-то не так, это показывается до старта — чтобы не записать лишнего и обнаружить потом, что звука не было.

Что записать нельзя

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

Системный звук — только на Android 10 и новее. На более старых версиях из звука доступен только микрофон.

Что агент умеет с записью

  • Начать запись с заданными параметрами.
  • Узнать статус: идёт ли запись и сколько секунд уже записано.
  • Остановить запись.
  • Открыть экран записи, чтобы вы увидели настройки глазами.
  • Снять один снимок экрана, не начиная запись.

Запись запускается и останавливается по команде агента, но только если разрешение на запись экрана уже выдано ранее. Без системного подтверждения телефона не начнётся ни вручную, ни по команде.

Ограничения

  • Без системного разрешения запись не запускается.
  • Если свободно меньше 512 МБ, запись не стартует.
  • Защищённые приложения и страницы в запись не попадают.
  • Системный звук доступен с Android 10.

Источник: docs/about/record.md. Страница собрана из документации проекта при сборке сайта — без пересказа.