---
name: uloop-game-view-mode
toolName: game-view-mode
description: "Show which view the Game tab is showing, switch it between the Game view and the Device Simulator (rotating the simulated device to match the Game view's orientation), or pick the simulated device by name. Use before Play when the UI must be checked in a device frame."
---

# uloop game-view-mode

Show which view the Game tab is showing, switch it between the Game view and the Device Simulator (rotating the simulated device to match the Game view's orientation), or pick the simulated device by name.

## Usage

```bash
uloop game-view-mode [--to <GameView|Simulator>] [--device <name>] [--list-devices]
```

## Parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `--to` | string | unset | `Simulator` switches the current Game view tab to the Device Simulator in place and rotates the device to match the Game view (landscape or portrait) when Player Settings allow that orientation; `GameView` switches back. Omit to report the current view without changing it. |
| `--device` | string | unset | Shows the named device in the Device Simulator and implies `--to Simulator` when `--to` is omitted. Case-insensitive: a whole name wins, then a name ending in the given words (`iPhone 12` picks `Apple iPhone 12`, not `Apple iPhone 12 mini`), then any name containing them. Several matches or none: nothing changes, `Success` is `false`, and `AvailableDevices` lists the candidates or every device. |
| `--list-devices` | flag | - | Adds `AvailableDevices`, the names of every device the Simulator can show, to the response. |

## Output

Returns JSON containing:

- `Success`: `false` when the Device Simulator is not available, when `--device` matches several devices or none, or when `--device` is combined with `--to GameView`. Nothing changes in those cases.
- `PreviousView`: View before the request: `GameView`, `Simulator`, `None` (no Play Mode view open), or `Other` (a third-party Play Mode view).
- `View`: View after the request, same values.
- `Changed`: Whether the tab was swapped, a view was opened, or the shown device changed.
- `SimulatorOrientation`: Orientation the Simulator renders (`Portrait`, `PortraitUpsideDown`, `LandscapeLeft`, `LandscapeRight`). Present only when the current view is the Simulator.
- `Device`: Name of the device the Simulator shows. Present when the request succeeded and the current view is the Simulator.
- `AvailableDevices`: Device names. Present with `--list-devices`, and when `--device` matched several devices (the candidates) or none (every device).
- `Message`: Human-readable status.
- `Warning`: Present when the device was not rotated or the Simulator renders a different orientation than requested.

## Examples

```bash
# Report which view is showing
uloop game-view-mode

# Play in the Device Simulator, rotated like the Game view
uloop game-view-mode --to Simulator
uloop control-play-mode --action Play

# Show a particular device (implies --to Simulator)
uloop game-view-mode --device "iPhone 12"

# Which devices can be shown?
uloop game-view-mode --list-devices

# Back to the plain Game view
uloop game-view-mode --to GameView
```

## Notes

- The tab is replaced in place, exactly like the Game / Simulator dropdown in the Game view toolbar. No second window is opened, and the device selected in the Simulator is kept unless `--device` names another one.
- Already showing the requested view: nothing changes and `Changed` is `false`. With `--device`, only the device changes.
- No Play Mode view open: a new window of the requested kind is opened; the Simulator keeps its own rotation because there is no Game view shape to copy.
- The orientation comes from the Game view's rendering resolution (wider than tall is landscape; square counts as portrait). A Free Aspect tab uses the tab's own shape, so set `set-game-view-size` first when the shape must be exact.
- When Player Settings allow no orientation on the wanted side (for example a portrait-only project and a landscape Game view), the device is not rotated and `Warning` says so. Fix the Default Orientation or the allowed auto-rotation flags in Player Settings if landscape is really wanted.
- Device names come from the project. Unity 2022 ships real devices (`Apple iPhone 12`, `Google Pixel 5`, ...); Unity 6 ships generic ones (`iOS Notch Device (1170x2532)`, `Tablet Small (1536x2048)`, ...) and real names need the Device Simulator Devices package. When unsure, run `--list-devices` first.
- Works in Edit Mode, Play Mode, and while paused; the play state is never changed. Start or stop playing with `control-play-mode` separately.
- Editors without the Device Simulator (Unity 2020 and older without the package) return `Success: false` and leave the view untouched.