---
title: "Ориентация экрана и полноэкранный режим в браузерной игре: Fullscreen API и Screen Orientation"
description: "Как перевести браузерную 2D-игру в полноэкранный режим и удержать альбомную ориентацию: requestFullscreen только по нажатию, screen.orientation.lock() с запасным путём, подсказка «поверните телефон» для iPhone и пауза при выходе из полноэкранного режима. Таблица поддержки Chrome, Firefox и Safari — по MDN и caniuse на 09.11.2026. Код проверен в Node.js 24."
slug: orientaciya-ekrana-i-polnoekrannyj-rezhim-v-brauzernoj-igre
date: 2026-11-09
updated: 2026-11-09
scheduled_at: "2026-11-09T14:00:00+03:00"
rubric: ustrojstvo-2d-igr
tags: ["fullscreen-api", "orientaciya-ekrana", "mobilnye-igry", "javascript", "razrabotchikam"]
reading_time: 14
draft: false
summary: "Полноэкранный режим включается вызовом requestFullscreen() только в обработчике нажатия, а альбомную ориентацию фиксирует screen.orientation.lock('landscape') — но по данным MDN на 09.11.2026 блокировка работает в Chrome и Firefox для Android и не работает в Safari. На iPhone Fullscreen API для элементов страницы недоступен совсем, поэтому игре нужен запасной путь: подсказка «поверните телефон» и пауза до поворота. В статье — таблица поддержки, цепочка вызовов с запасными путями и сторож паузы, проверенные в Node.js 24 на 5 смоделированных браузерах."
---

## Коротко

Полноэкранный режим включается вызовом `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.type` | `change` на `screen.orientation` |
| Зафиксировать ориентацию | `screen.orientation.lock('landscape')` | — |
| Снять фиксацию | `screen.orientation.unlock()` | — |

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

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

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

| Браузер | `requestFullscreen()` | `orientation.type` и `change` | `orientation.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`.

```js
// Полноэкранный режим с запасными путями: стандартный метод, префикс 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(' → '));
```

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

```text
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. Движок в разработке и публично пока не открыт, заявку можно оставить на [странице раннего доступа](/early-access?utm_source=blog&utm_medium=article&utm_campaign=orientaciya-ekrana-i-polnoekrannyj-rezhim-v-brauzernoj-igre) (подача заявки не гарантирует приглашение).

**Источники (проверено: 09.11.2026):** [MDN — Element: requestFullscreen()](https://developer.mozilla.org/en-US/docs/Web/API/Element/requestFullscreen) (требование кратковременной активации, `TypeError`, `navigationUI`, политика `fullscreen` для фреймов, «Limited availability»); [MDN — Transient activation](https://developer.mozilla.org/en-US/docs/Glossary/Transient_activation) (какие события дают активацию, срок истекает); [MDN — ScreenOrientation: lock()](https://developer.mozilla.org/en-US/docs/Web/API/ScreenOrientation/lock) (блокировка обычно на мобильных и в полноэкранном режиме, ошибки `NotSupportedError`, `SecurityError`, `AbortError`); [MDN — Screen Orientation API](https://developer.mozilla.org/en-US/docs/Web/API/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](https://developer.mozilla.org/en-US/docs/Mozilla/Firefox/Releases/144) (`lock()` и `unlock()` для Android и планшетов с Windows, выпуск 14.10.2025); [caniuse — Fullscreen API](https://caniuse.com/fullscreen) (iOS Safari — частичная поддержка «только iPad» до 27.2, 83,99% + 13,54%) и [caniuse — Screen Orientation](https://caniuse.com/screen-orientation). Окружения браузеров в коде — наша модель по этим таблицам, вывод — наш прогон в Node.js 24.

**Читайте также:**
- [HUD и адаптивный интерфейс браузерной игры: якоря, масштаб, размер цели касания](/blog/interfejs-poverh-igry-schetchik-ochkov-i-knopki)
- [Пиксель-арт в браузере без размытия: image-rendering, целочисленное масштабирование и devicePixelRatio](/blog/piksel-art-v-brauzere-bez-razmytiya)
- [Действия ввода вместо клавиш: KeyboardEvent.code, Gamepad API, мёртвая зона](/blog/vvod-klaviatura-gejmpad-kasanie-v-2d-igre)
