Ориентация экрана и полноэкранный режим в браузерной игре: Fullscreen API и Screen Orientation

Коротко

Полноэкранный режим включается вызовом requestFullscreen() только из обработчика нажатия, а альбомную ориентацию фиксирует screen.orientation.lock('landscape') — но по данным MDN на 09.11.2026 блокировка работает в Chrome и Firefox для Android и не работает в Safari. На iPhone полноэкранного режима для элементов страницы нет совсем, поэтому игре нужен запасной путь: подсказка «поверните телефон» и пауза до поворота. Ниже — таблица поддержки, цепочка вызовов с запасными путями и сторож паузы, проверенные в Node.js 24.

Содержание

  1. Два разных API: экран и поворот
  2. Поддержка браузерами на 09.11.2026
  3. Полноэкранный режим: только по нажатию
  4. Ориентация: узнать можно везде, зафиксировать — не везде
  5. iPhone: игра без полноэкранного режима
  6. Пауза при выходе из полноэкранного режима и повороте
  7. Код на JavaScript
  8. Практический сценарий: аркада в альбомной ориентации
  9. Когда вам это не подойдёт

Два разных API: экран и поворот

Fullscreen API и Screen Orientation API решают разные задачи и поддерживаются по-разному. Первый растягивает один элемент страницы — обычно контейнер с canvas — на весь экран и прячет интерфейс браузера. Второй сообщает, как повёрнут экран, а в части браузеров ещё и фиксирует поворот.

ЗадачаВызовСобытие
Войти в полноэкранный режимelement.requestFullscreen()fullscreenchange на document
Выйти из негоdocument.exitFullscreen()fullscreenchange
Узнать, кто на весь экранdocument.fullscreenElement—
Узнать ориентациюscreen.orientation.typechange на screen.orientation
Зафиксировать ориентациюscreen.orientation.lock('landscape')—
Снять фиксациюscreen.orientation.unlock()—

Обычно их вызывают вместе: сначала полноэкранный режим, потом блокировка поворота. Многие браузеры разрешают блокировку только в полноэкранном режиме — MDN так и пишет: блокировка обычно включена на мобильных устройствах и когда документ показан на весь экран.

Поддержка браузерами на 09.11.2026

Чтение ориентации работает везде, полноэкранный режим — почти везде, кроме iPhone, а блокировка поворота — в основном на Android. Данные — из таблиц совместимости MDN и caniuse, проверено 09.11.2026:

БраузерrequestFullscreen()orientation.type и changeorientation.lock()
Chrome на компьютереда, с версии 71да, с 38метод есть, но всегда отклоняется с NotSupportedError
Chrome на Androidда, с 71да, с 38да, с 38
Firefox на Androidда, с 64да, с 43да, с 144; раньше метод был, но завершался ошибкой
Firefox на компьютереда, с 64да, с 43с 144 — только на планшетах с Windows (по заметкам к выпуску)
Safari на macOSда, с 16.4; раньше — с префиксом webkitда, с 16.4нет
Safari на iPadчастично, с 16.4: кнопка поверх игры, которую нельзя скрыть, и выход свайпом внизда, с 16.4нет
Safari на iPhoneнет для элементов страницы: caniuse отмечает «только iPad» во всех версиях до 27.2да, с 16.4нет
Android WebView (игра внутри приложения)даданет

Ещё две цифры для масштаба. MDN помечает Fullscreen API и lock() как «Limited availability» — не Baseline, а Screen Orientation API в целом — как Baseline с марта 2023 года. По caniuse полная поддержка Fullscreen API есть у 83,99% пользователей и частичная — ещё у 13,54%.

Таблицы меняются с каждым выпуском браузера: строку про Android WebView в данных MDN исправили 14.10.2026. Перед выпуском игры перепроверьте их на страницах из списка источников.

Полноэкранный режим: только по нажатию

Войти в полноэкранный режим можно только в ответ на действие игрока — нажатие кнопки, касание или клавишу. MDN называет это требованием кратковременной активации: активацию дают pointerdown, touchend или keydown (кроме Esc), и через некоторое время она истекает. Вызов при загрузке страницы или по таймеру отклоняется, и обещание завершается ошибкой TypeError.

Отсюда три правила:

  1. Отдельная кнопка «Играть». Вызывайте requestFullscreen() первым действием в её обработчике, до загрузки уровня и прочих ожиданий.
  2. Растягивайте контейнер, а не canvas. Тогда поверх игры остаются ваши кнопки паузы и звука из HTML.
  3. Слушайте fullscreenchange. Игрок выходит клавишей Esc или жестом, и игра узнаёт об этом только из события: document.fullscreenElement становится null.

Если игра встроена в чужую страницу через iframe, у фрейма должен быть атрибут allow="fullscreen" (или allowfullscreen), иначе вызов отклоняется по политике разрешений. Сайты-каталоги вроде itch.io обычно дают свою кнопку полноэкранного режима или открывают игру на весь экран сами.

Параметр navigationUI: 'hide' просит браузер скрыть свои панели, но решение остаётся за браузером: значение по умолчанию — 'auto'.

Ориентация: узнать можно везде, зафиксировать — не везде

Текущий поворот показывает screen.orientation.type: одно из значений portrait-primary, portrait-secondary, landscape-primary, landscape-secondary. О повороте сообщает событие change. Это работает во всех основных браузерах, включая Safari с версии 16.4.

Блокировка screen.orientation.lock('landscape') возвращает обещание, и обрабатывать нужно оба исхода. По MDN обещание отклоняется с:

  • NotSupportedError — браузер не умеет фиксировать эту ориентацию (так всегда в Chrome на компьютере);
  • SecurityError — вкладка скрыта или фрейму не дано разрешение allow-orientation-lock;
  • AbortError — во время ожидания пришёл второй вызов lock() или unlock().

В Safari метода lock нет вовсе, поэтому перед вызовом проверяйте typeof screen.orientation.lock === 'function'. Ошибка блокировки — не повод прерывать игру: это сигнал включить запасной путь.

iPhone: игра без полноэкранного режима

На iPhone игра всегда идёт на странице с интерфейсом Safari вокруг, поэтому её раскладка должна выдерживать оба положения. Порядок действий:

  1. Подсказка вместо блокировки. Если игре нужна альбомная ориентация, а телефон в портретной, поверх игры показывается экран «поверните телефон», а игра стоит на паузе.
  2. Пересчёт размера по событию. После поворота меняется размер области просмотра: заново считайте размер холста и масштаб, как в статье про пиксель-арт без размытия.
  3. Безопасные зоны. В альбомной ориентации вырез экрана оказывается сбоку; отступы для HUD и размер зон касания разобраны в статье про интерфейс поверх игры.

На iPad полноэкранный режим есть, но с оговорками из таблицы: кнопка выхода поверх игры и выход свайпом вниз. Если в игре есть жест «провести вниз», на iPad он может выкинуть игрока из полноэкранного режима — назначьте этому действию другой жест или кнопку.

Пауза при выходе из полноэкранного режима и повороте

Игра встаёт на паузу сама, а продолжается только по нажатию игрока. Причин паузы две: выход из полноэкранного режима и поворот в неподходящую ориентацию.

Почему не продолжать автоматически: игрок, который вышел из полноэкранного режима, мог переключиться на сообщение или звонок. Если игра продолжится сама, он вернётся к уже проигранному уровню. Нажатие «Продолжить» в обработчике заодно даёт право снова вызвать requestFullscreen().

Сторож в коде ниже запоминает причину паузы. При повороте обратно в альбомную ориентацию он лишь разрешает продолжить (can-resume), а нажатие в портретной ориентации игру не запускает (still-portrait).

Код на JavaScript

Код содержит вход в игру с запасными путями и сторож паузы. Окружения браузеров здесь смоделированы объектами по таблице выше, поэтому код запускается в Node.js 24 (как модуль .mjs), а вывод совпадает с комментарием после кода. В браузере env.el — контейнер игры, env.screen — глобальный screen, а методы сторожа вызываются из обработчиков fullscreenchange и change.

// Полноэкранный режим с запасными путями: стандартный метод, префикс webkit, отказ
function requestFs(el) {
  if (el.requestFullscreen) return el.requestFullscreen({ navigationUI: 'hide' });
  if (el.webkitRequestFullscreen) { el.webkitRequestFullscreen(); return Promise.resolve(); } // старые Safari на iPad: без обещания
  return Promise.reject(new Error('fullscreen-unavailable'));
}

// Блокировка ориентации: есть не везде, а где есть — часто только в полноэкранном режиме
async function lockLandscape(screenLike) {
  const o = screenLike.orientation;
  if (!o || typeof o.lock !== 'function') return 'no-lock-api';
  try { await o.lock('landscape'); return 'locked'; }
  catch (e) { return 'lock-failed:' + e.name; }
}

// Вызывается только из обработчика нажатия кнопки «Играть»
async function enterGame(env) {
  let fs = 'fullscreen';
  try { await requestFs(env.el); } catch (e) { fs = 'no-fullscreen'; }
  const lock = fs === 'fullscreen' ? await lockLandscape(env.screen) : 'skip-lock';
  const portrait = env.screen.orientation
    ? env.screen.orientation.type.startsWith('portrait')
    : env.height > env.width;
  const hint = lock !== 'locked' && portrait ? 'rotate-hint' : 'play';
  return [fs, lock, hint].join(' | ');
}

// Поддельные окружения для проверки в Node.js
const err = (name) => Object.assign(new Error(name), { name });
const ok = () => Promise.resolve();
const no = (name) => () => Promise.reject(err(name));
const orient = (type, lock) => ({ type, lock });

const envs = {
  'Chrome, Android':     { el: { requestFullscreen: ok }, screen: { orientation: orient('portrait-primary', ok) }, width: 390, height: 844 },
  'Chrome, компьютер':   { el: { requestFullscreen: ok }, screen: { orientation: orient('landscape-primary', no('NotSupportedError')) }, width: 1280, height: 720 },
  'Safari, iPad':        { el: { requestFullscreen: ok }, screen: { orientation: { type: 'portrait-primary' } }, width: 820, height: 1180 },
  'Safari, iPhone':      { el: {}, screen: { orientation: { type: 'portrait-primary' } }, width: 390, height: 844 },
  'вызов без нажатия':   { el: { requestFullscreen: no('TypeError') }, screen: { orientation: orient('landscape-primary', ok) }, width: 844, height: 390 },
};

for (const [name, env] of Object.entries(envs)) console.log(name.padEnd(18), '→', await enterGame(env));

// Пауза и возврат: игра сама не продолжается, нужен жест игрока
function createGuard(wantLandscape = true) {
  const s = { paused: false, reason: null, fullscreen: true, landscape: true, log: [] };
  const check = () => {
    const bad = !s.fullscreen ? 'exit-fullscreen' : (wantLandscape && !s.landscape ? 'portrait' : null);
    if (bad && !s.paused) { s.paused = true; s.reason = bad; s.log.push('pause:' + bad); }
    if (!bad && s.paused && s.reason === 'portrait') s.log.push('can-resume');
  };
  return {
    s,
    onFullscreenChange(isFs) { s.fullscreen = isFs; check(); },
    onOrientationChange(type) { s.landscape = type.startsWith('landscape'); check(); },
    tapResume() {
      if (!s.paused) return;
      if (wantLandscape && !s.landscape) { s.log.push('still-portrait'); return; }
      s.paused = false; s.reason = null; s.log.push('resume');
    },
  };
}

const g = createGuard();
g.onOrientationChange('portrait-primary');
g.tapResume();
g.onOrientationChange('landscape-secondary');
g.tapResume();
g.onFullscreenChange(false);
g.tapResume();
console.log(g.s.log.join(' → '));

Ожидаемый вывод программы:

Chrome, Android    → fullscreen | locked | play
Chrome, компьютер  → fullscreen | lock-failed:NotSupportedError | play
Safari, iPad       → fullscreen | no-lock-api | rotate-hint
Safari, iPhone     → no-fullscreen | skip-lock | rotate-hint
вызов без нажатия  → no-fullscreen | skip-lock | play
pause:portrait → still-portrait → can-resume → resume → pause:exit-fullscreen → resume

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

Практический сценарий: аркада в альбомной ориентации

Возьмём аркаду с опорным размером 1280×720, которая играется только в альбомной ориентации, и 5 устройств для проверки. Порядок работы:

  1. Кнопка «Играть». Первое действие обработчика — enterGame, только потом загрузка уровня.
  2. Подсказка поворота. Экран «поверните телефон» — в HTML поверх canvas; показывается при результате rotate-hint и при паузе с причиной portrait.
  3. Обработчики. document слушает fullscreenchange, screen.orientation — change; оба передают состояние сторожу.
  4. Кнопка «Продолжить». Вызывает tapResume, а если document.fullscreenElement пуст и браузер поддерживает режим — ещё и requestFullscreen().
  5. Проверка на устройствах. Ожидаемые результаты:
УстройствоПри нажатии «Играть»Что проверить руками
Телефон на Android, Chromeполный экран, поворот зафиксированНазад выводит из режима — игра на паузе
Ноутбук, Chrome или Firefoxполный экранEsc — пауза, «Продолжить» возвращает полный экран
iPad, Safariполный экран, подсказка в портретной ориентациисвайп вниз — пауза
iPhone, Safariподсказка «поверните телефон»после поворота игра ждёт нажатия
Игра во фрейме на чужом сайтебез полного экрана, если нет allow="fullscreen"игра всё равно запускается

Когда вам это не подойдёт

Связка полноэкранного режима и блокировки поворота полезна для мобильных аркад, но не для всех игр:

  • Игра в портретной ориентации или для любого положения. Головоломке на сетке или кликеру проще выдерживать оба положения, чем требовать поворот.
  • Только компьютер. На ноутбуке поворот не меняется, а полноэкранный режим — дело вкуса: часть игроков предпочитает окно рядом с другими вкладками. Дайте кнопку, но не включайте режим без спроса.
  • Игра внутри чужого приложения. В Android WebView блокировка не поддерживается, а полноэкранный режим зависит от настроек приложения-контейнера.
  • Нужна гарантия альбомной ориентации на iPhone. Из браузера её не получить; это задача нативной обёртки, а не веб-страницы.

Мы разрабатываем J2DRU — браузерный 2D игровой движок, рассчитанный на управление с клавиатуры, мыши, геймпада и касанием, с целевыми браузерами Chrome на компьютере и Android и Safari на macOS, iPhone и iPad. Движок в разработке и публично пока не открыт, заявку можно оставить на странице раннего доступа (подача заявки не гарантирует приглашение).

Источники (проверено: 09.11.2026): MDN — Element: requestFullscreen() (требование кратковременной активации, TypeError, navigationUI, политика fullscreen для фреймов, «Limited availability»); MDN — Transient activation (какие события дают активацию, срок истекает); MDN — ScreenOrientation: lock() (блокировка обычно на мобильных и в полноэкранном режиме, ошибки NotSupportedError, SecurityError, AbortError); MDN — Screen Orientation API (Baseline с марта 2023); данные совместимости MDN browser-compat-data для ScreenOrientation, Element.requestFullscreen, Document.exitFullscreen (версии браузеров в таблице; правка про Android WebView — 14.10.2026); MDN — Firefox 144 release notes for developers (lock() и unlock() для Android и планшетов с Windows, выпуск 14.10.2025); caniuse — Fullscreen API (iOS Safari — частичная поддержка «только iPad» до 27.2, 83,99% + 13,54%) и caniuse — Screen Orientation. Окружения браузеров в коде — наша модель по этим таблицам, вывод — наш прогон в Node.js 24.

Читайте также:

Частые вопросы

Почему requestFullscreen() не срабатывает при загрузке страницы?

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

Можно ли зафиксировать альбомную ориентацию на iPhone?

Нет. По данным MDN на 09.11.2026 Safari не поддерживает screen.orientation.lock() ни на компьютере, ни на iPhone и iPad, а полноэкранный режим для элементов страницы на iPhone недоступен. Остаётся подсказка «поверните телефон» и раскладка, которая выдерживает оба положения.

Как узнать текущую ориентацию экрана?

Свойство screen.orientation.type возвращает одно из четырёх значений: portrait-primary, portrait-secondary, landscape-primary или landscape-secondary, а событие change на screen.orientation сообщает о повороте. По MDN это работает во всех основных браузерах с марта 2023 года.

Что делать, когда игрок вышел из полноэкранного режима?

Слушать событие fullscreenchange на document и ставить игру на паузу, если document.fullscreenElement стал null. Продолжать игру стоит только по нажатию игрока — оно же может снова включить полноэкранный режим.