- Docs
- Resources
- Agent Pool & Device Farm
- Live device sessions
Live device sessions
A live session streams a device’s screen to your browser and sends your clicks back as taps. Use it to explore an app, check a fix by hand, or prepare a device before a run.
In short
On this page you can
- Open the screen of a phone or emulator attached to your own agent.
- Take a Device Farm device so nobody else and no run can use it meanwhile.
- Tap, swipe and use Back, Home, Recent Apps, volume, rotate and lock keys.
- Install a build from the App Library on a farm device.
- Release the device when you are done.
How to use it
- Local device: Test Agents › Connected Devices › Use Device Live.
- Farm device: Devices › Use device on an Available card › Take device.
- Wait for the label to change from Preparing and Connecting to Live.
- Click to tap, drag to swipe, and use System Keys.
- Click Release or close the window to free the device.
Two ways to go live#
| Device on your agent | Device Farm device | |
|---|---|---|
| Where | Test AgentsConnected DevicesUse Device Live | DevicesUse deviceTake device |
| Needs | A MOBILE project, your Localhost agent online, the device listed under Connected Devices | The Device Farm right, a device in state Available |
| Who | You, for devices on your own agent | Admins and on-premise users: any device of your company. Cloud users: devices assigned to your company |
| Holds the device | No; a running test can still use it | Yes; it shows Busy “In live use” and runs cannot take it |
Open a device on your agent#
Find the device
In Test Agents, under Connected Devices, find the phone or emulator. If the list is empty, see Connected Devices.
Click Use Device Live
The button on the device row opens a window titled with the agent name and the platform.
The status goes from Preparing to Connecting to Live, and the screen appears.
Take a Device Farm device#
Open the device
In Devices, filter for Available and click Use device on a card. The device view opens with an empty frame: “Take the device to mirror its screen and send input.”
Take it
Click Take device.
The screen appears in the frame, the holder line says “You have this device” and the card shows Busy to everyone else.
Work on it
Tap, swipe and use the keys (below). The expand button in the frame’s toolbar makes the phone bigger without restarting the stream.
Release it
Click Release, or close the device view.
The device returns to Available.
If your browser crashes
The device is held for you on a lease of 180 seconds that renews while the stream is open. If the browser or network dies, the device frees itself at the latest about three minutes later. Admins can free it at once with Force release.
What you can do in a session#
- Click to tap, click and drag to swipe. Typing on your keyboard is not passed to the device yet; use the on-screen keyboard of the device.
- System Keys: Back, Home, Recent Apps, Volume Up, Volume Down, Rotate, Lock Screen / Wake. They become active when the stream is ready (“Will be active when stream is ready.”).
- Restart on a device of your agent reboots it after “Reboot device?” (“The live stream will be lost.”). The window shows “Restarting device…”; when the device is back, click Reconnect. On farm devices, admins restart from the device controls next to the keys.
- Install App under the phone of a farm device (admins and on-premise users) installs a build from the App Library, whether or not you have taken the device.
- Full screen enlarges the window of a device on your agent; on farm devices the expand button in the frame toolbar does the same.
- The footer shows the stream Codec:
h264orwebrtcfor Android,mjpegfor iOS.
| Platform | Watch | Control |
|---|---|---|
| Android phone or emulator | Yes | Taps, swipes, system keys, restart |
| iOS device or simulator (agent or node on a Mac) | Yes | Not yet: “iOS control will be active in Phase 4 (Mac agent required).” Restart is disabled. |
When the connection drops#
The window shows its state at the top: Preparing, Connecting, Live, “Reconnecting… (n/3)”, Connection failed, Error or Closed.
- If the first connection takes too long, or the stream breaks, the window retries by itself up to three times with growing pauses. The exact timings are in Live session timings.
- After the third failed retry you see “Connection failed” with “The device stream could not be started. The device may be busy with a running test or temporarily unreachable. Try reconnecting.” and a Try Again button.
- Permission errors (for example “This device is not available to your company.”) are not retried; they would only fail again.
Rules that apply#
- A farm device must be Available. A Busy or Offline device cannot be taken.
- In the cloud service, live control works on devices assigned to your company. Shared devices are used by runs only.
- The usage mode (Automation, Manual, Dual use) does not block a live session; it only keeps automatic runs off Manual devices.
If something goes wrong#
Didn’t find your answer?Write to support with your project name and what you see on screen.
info@smartestqa.ai