Skip to content

Latest commit

 

History

History
125 lines (70 loc) · 24.3 KB

GUIDE.ru-RU.md

File metadata and controls

125 lines (70 loc) · 24.3 KB

Руководство по Console Mode

Подробности, которые не поместились в README.

English · Português (Brasil) · Español · Deutsch · Français · Русский

Режимы и восстановление

Режим При выходе
Steam Big Picture Автоматическое восстановление (приложение остаётся в области уведомлений)
Playnite в полноэкранном режиме Автоматическое восстановление (приложение остаётся в области уведомлений)
Режим Xbox Вручную: нажмите «Восстановить сейчас», используйте меню в области уведомлений или снова откройте окно
Своё приложение Автоматическое восстановление, когда приложение (или выбранный отслеживаемый процесс) закрывается

Если приложение закроется или ПК выключится посреди сеанса, при следующем запуске Console Mode (в том числе при входе в Windows, если он запускается вместе с Windows) восстановит всё, что изменил сеанс: экраны, звук, RTSS, значки рабочего стола и указатель, и сообщит об этом.

Восстановить конфигурацию можно в любой момент из области уведомлений («Восстановить конфигурацию» / «Показать окно»). Если экраны закрыты чёрным экраном, ESC убирает затемнение.

Из меню сеанса есть два выхода. «Вернуться к ПК» завершает сеанс и возвращает экраны, разрешение, HDR, звук и ограничение FPS в прежнее состояние; приложение остаётся в области уведомлений. «Выйти из Console Mode» делает то же самое, а затем закрывает приложение, поэтому сочетания на геймпаде не работают, пока вы не откроете его снова. При первом открытии меню предлагает обзор, который объясняет каждый пункт; чтобы посмотреть его позже, нажмите в меню Y (△ на PlayStation) или F1 либо используйте «Система» → «Приложение» → «Обзор меню сеанса».

Меню работает и вне режима консоли — чтобы пользоваться ПК с дивана, ничего не запуская: пока Console Mode запущен (даже только в трее), сочетание для меню, значок в трее или consolemode://menu открывают его на игровом экране, если он включён, иначе на основном. Там можно переключать окна, менять громкость, разрешение, аудиовыход и HDR, открывать ControlFS и JoyChromium, скрывать указатель и управлять мышью с геймпада. Изменённое остаётся таким, пока вы не поменяете его снова, ведь сеанса, который можно отменить, нет; ограничение и счётчик FPS появляются только в сеансе. Если сочетание мешает в какой-нибудь игре, выключите Система → Геймпад → Меню сеанса вне режима консоли (значок в трее по-прежнему открывает меню).

Сочетание для представления задач делает с геймпада то же, что Win + Tab: открывает представление задач Windows со всеми открытыми окнами — в сеансе и вне его. Пока оно открыто, крестовина или левый стик выбирают окно (удержание повторяет), A открывает его, а B закрывает представление; повторное сочетание тоже закрывает. Оно сразу включено как Select + X; изменить или выключить его можно в «Система» → «Геймпад» → «Сочетание на геймпаде для представления задач» (подойдёт и одна кнопка Xbox с удержанием, если она не занята сочетанием для открытия Console Mode). Первые три раза перед открытием появляется подсказка с кнопками, потому что поверх представления ничего не показывается. С геймпадом Xbox выделение двигает сама Windows; с геймпадом PlayStation, который Windows там не понимает, — Console Mode (выключите «Управлять представлением задач геймпадом PlayStation», если пользуетесь DS4Windows или Steam Input и команды повторяются).

Интерфейс

У Console Mode один интерфейс, устроенный как у консоли: он занимает весь экран и работает с геймпадом Xbox или PlayStation, мышью или клавиатурой (щёлкните по вкладке или используйте Page Up / Page Down; Enter и Esc работают как A и B). При первом запуске обзор проводит по вкладкам, лаунчерам, кнопке «Играть», экранам, быстрым настройкам и сочетаниям геймпада; каждый шаг переходит к следующему сам, когда было время его прочитать (полоска под карточкой показывает, сколько осталось), A — дальше сразу, B — пропустить. Чтобы посмотреть его снова: «Система» → «Приложение» → «Обучение». Пока приложение загружается, показывается заставка с логотипом и звуком; любая кнопка её пропускает, иногда для сюрприза показывается заставка в духе Xbox 360 или PS4 со звуком консоли; в «Система» → «Приложение» можно выбрать стиль (после этого сюрпризов не будет), сразу посмотреть её и выключить заставку или только её звук.

В разделе «Система» → «Геймпад» выберите раскладку кнопок: «Автоматически», Xbox или PlayStation. Предпросмотр и подписи сочетаний следуют выбору, который сохраняется при закрытии приложения. Меняются только отображаемые символы; назначение кнопок геймпада остаётся прежним.

На вкладке «Система» собраны все настройки, включая сочетания на геймпаде, Playnite, Android TV, своё значение FPS, вид счётчика FPS, аргументы своего приложения, отчёт диагностики и папку данных. Значения сохраняются после перезапуска приложения.

Откройте действие, сочетание для которого хотите настроить, выберите «Задать» или «Изменить», удерживайте нужную комбинацию на одном геймпаде и отпустите кнопки. «Удалить» отключает это сочетание. Во время записи кнопки геймпада не управляют интерфейсом; чтобы остановить запись, используйте «Отмена» или Esc. Вне записи B закрывает редактор. В поля адреса и своего значения FPS можно вводить текст с клавиатуры.

При возврате из Big Picture параметр «Сворачивать Steam в область уведомлений при возврате к ПК» закрывает окно клиента, но Steam продолжает работать. Если параметр выключен, клиент на рабочем столе остаётся открытым. Окна Steam не трогаются, если запущена игра или её состояние не удаётся проверить.

При смене основного экрана Windows может перемешать значки рабочего стола. Параметр «Возвращать значки рабочего стола на место» (включён по умолчанию) запоминает их расположение перед сеансом и возвращает значки после восстановления рабочего места. Если на рабочем столе включено «Упорядочить значки автоматически», параметр ничего не делает: Windows расставляет их сам. Параметр «Скрывать значки рабочего стола во время сеанса» (по умолчанию выключен) скрывает их на время сеанса, чтобы всё выглядело чисто, как на консоли, и показывает снова при возврате к ПК; уже скрытые значки остаются скрытыми, а после прерванного сеанса они появятся при следующем запуске.

Убирать указатель мыши (включено по умолчанию): когда лаунчер появляется на телевизоре, указатель перемещается в правый нижний угол игрового экрана, а через несколько секунд — ещё раз, потому что Steam снова ставит его в центр при открытии Big Picture. При возврате к ПК он возвращается на прежнее место. Полностью скрыть указатель по-прежнему можно в меню сеанса.

Параметр «Пробуждать ПК геймпадом» разрешает беспроводному адаптеру Xbox, Bluetooth или проводному геймпаду выводить ПК из спящего режима центральной кнопкой геймпада. Кнопка «Включить» запрашивает у Windows права администратора и отмечает у этих устройств Разрешить этому устройству выводить компьютер из ждущего режима. Выключенный ПК или ПК в режиме гибернации не проснётся, а некоторые ПК отключают питание Bluetooth во сне. Вместе с «Входить при подключении геймпада» ПК сразу проснётся в режиме консоли.

Профили для игр задают каждой игре Steam собственные разрешение, HDR, ограничение FPS и аудиовыход. Во время игры откройте меню сеанса и выберите «Профиль игры» → «Сохранить текущие настройки для…»: сохранится то, что игровой экран использует в этот момент. Когда эта игра в следующий раз запустится во время сеанса, Console Mode применит профиль, а после её закрытия экран вернётся в прежнее состояние. Игра определяется через Steam, независимо от того, запущена ли она из Big Picture, Playnite или приложения Xbox. Сохранённые профили перечислены в разделе «Система» → «При входе в режим консоли» → «Профили для игр», где их можно удалить.

Локальный API управления

Ссылки consolemode:// срабатывают без ответа. Инструменты, которым нужен ответ (агент удалённого управления, работающий как служба Windows, плагин Stream Deck, показывающий, включён ли режим консоли), могут использовать именованный канал \\.\pipe\ConsoleMode.Control, пока приложение запущено: отправьте одну строку JSON и получите одну в ответ.

→ {"cmd":"status"}          // or "start", "stop", "show"
← {"ok":true,"active":true,"restoring":false,"mode":"xboxMode","version":"1.5.0"}

start, stop и show делают ровно то же, что и соответствующая ссылка consolemode://, и отвечают, когда приложение завершит действие (ok:false с полем error, если режим консоли не запустился или восстановление не завершилось). status только читает состояние. Подключиться могут только вошедший в систему пользователь и LocalSystem; в сеть ничего не открывается.

Управление телевизором

В разделе «Система» → «Телевизор» можно включать телевизор и переключать его на HDMI-вход ПК при запуске режима консоли, а также, по желанию, переводить его обратно в режим ожидания после восстановления рабочего стола. Телевизор, который не отвечает, никогда не блокирует режим консоли: приложение записывает это в журнал и, как обычно, ждёт игровой экран.

По умолчанию выбрано «Не управлять»: ничего не отправляется, и запуск или восстановление ничем не замедляются. Если выбран способ управления, шаг с телевизором выполняется первым при запуске режима консоли и занимает не больше 30 секунд (худший случай, когда телевизор не отвечает и пробуется Wake-on-LAN); перевод в режим ожидания при восстановлении занимает не больше 15 секунд. Уже включённый телевизор обычно отвечает за секунду-две.

Большинство видеокарт ПК не умеют отправлять HDMI-CEC, поэтому приложение общается с телевизором по сети:

Google TV / Android TV

TCL, Sony, Hisense, Philips и другие телевизоры с Google TV или Android TV, через ADB (протокол отладки Android). На ПК ничего устанавливать не нужно.

  1. На телевизоре: «Настройки» → «Система» → «Об устройстве» (Settings → System → About), нажмите 7 раз на «Сборка ОС Android TV» (Android TV OS build), чтобы открыть параметры разработчика.
  2. «Настройки» → «Система» → «Для разработчиков» (Developer options): включите «Отладка по USB» (USB debugging; на некоторых телевизорах «Отладка по сети» / ADB over network).
  3. В Console Mode выберите «Google TV / Android TV (по сети)», введите IP-адрес телевизора («Настройки» → «Сеть» на телевизоре; зарезервируйте его в роутере) и HDMI-вход, к которому подключён ПК.
  4. Нажмите «Проверить». Телевизор спросит «Разрешить отладку с этого компьютера?» (Allow debugging from this computer?): отметьте «Всегда разрешать» (Always allow) и нажмите «Разрешить» (Allow).

Ключ ADB этого ПК хранится в зашифрованном виде для вашего пользователя Windows (DPAPI), поэтому телевизор спрашивает только один раз. Если папку данных скопировать другому пользователю Windows или на другой ПК, ключ там прочитать не удастся: приложение создаст новый, и телевизор снова спросит «Разрешить отладку?».

Для включения используется клавиша пробуждения Android, затем клавиша HDMI 1-4. Если телевизор её игнорирует, укажите в поле «Команда входа» любую shell-команду Android, которая открывает вход ПК. Если в режиме ожидания телевизор отключается от сети, заполните «MAC-адрес», чтобы приложение сначала отправило Wake-on-LAN (на телевизоре должна быть включена опция «Включение по сети» / «Включение по Wi-Fi», Wake on network / Wake on Wi-Fi).

Когда возвращается рабочий стол, сначала на телевизор отправляется команда при возврате к ПК (необязательно), например input keyevent 3 для его главного экрана или команда другого входа; затем режим ожидания, если он включён.

«Беспроводная отладка» (Wireless debugging) с кодом сопряжения (телефоны с Android 11+) — это другой протокол, обёрнутый в TLS, и он не поддерживается: используйте отладку по USB или по сети.

Дополнительные возможности

HDR

Включает HDR на игровом экране, пока активен режим консоли. При выходе HDR снова выключается (или возвращается в прежнее состояние).

VRR

Console Mode может переключать параметр Windows для оптимизации VRR. Для лучшего результата включите также VRR / G-SYNC / FreeSync в панели управления видеокарты (NVIDIA или AMD).

Ограничение FPS (RTSS)

Ограничивает частоту кадров во всех играх, пока работает режим консоли (полезно на телевизоре 60 Гц). Нужен установленный и запущенный RTSS. Прежнее ограничение возвращается при выходе.

Ограничения

  • Конфигурации с несколькими мониторами бывают очень разными; на некоторых системах восстановление может потребовать второй попытки из области уведомлений
  • Режим Xbox не определяет, когда закончился полноэкранный режим: восстанавливайте вручную
  • Ограничение FPS глобальное (ограничение RTSS), а не для каждого экрана
  • Сборка WinUI 3 пока компилируется только в Windows (net8.0-windows)

Решение проблем

Раскладка рабочего стола не восстановилась

Откройте меню в области уведомлений и выберите «Восстановить конфигурацию». Если раскладка всё ещё выглядит неправильно, снова выберите «Восстановить конфигурацию», когда Windows закончит применять изменения мониторов. Можно также снова открыть окно из области уведомлений и восстановить вручную.

Звук остался на прежнем выходе

Перед запуском режима консоли убедитесь, что нужный выход подключён и доступен в Windows. Для выходов HDMI/телевизора может понадобиться переподключить кабель и снова запустить режим.

Геймпад виден, но ничего не делает (DualSense / DualShock)

Откройте «Система» → «Ярлык, справка и данные» → «Проверка геймпада»: там в реальном времени видно, что Windows получает от каждого геймпада. Если при нажатии кнопок показания остаются пустыми, скорее всего, геймпад перехватывает Steam (запущенный Steam с поддержкой PlayStation в Steam Input превращает его в клавиатуру и мышь на рабочем столе). Закройте Steam или отключите поддержку PlayStation в Steam Input и проверьте снова. Если показаний по-прежнему нет, нажмите «Копировать диагностику» и вставьте результат в форму отзыва.

HDR или VRR не изменились

Убедитесь, что игровой экран поддерживает эту функцию и что HDR включён в Windows. Для VRR также включите G-SYNC или FreeSync в панели управления видеокарты, если это применимо.

Сборка из исходного кода (Windows)

Смотрите раздел английского руководства: GUIDE.md#build-from-source-windows.

Эта страница — перевод английского руководства. Если что-то расходится, актуальна английская версия.