Skip to main content

​
Overview

Flip Device simulates turning the phone over — from lying face-up to face-down (screen facing down), as if you flipped it on a table — and then back again. Use it to test features that respond to that motion, such as flip-to-mute or flip-to-silence.
Android emulators only. Flip is delivered through the Android emulator’s sensor console, so it works on Android emulators but not on physical devices. It is not supported on iOS — the iOS Simulator can’t inject accelerometer data, and the fallback (rotating to upside-down) is rejected by most iPhone apps, so flip steps should not be used in iOS tests.
Flip has no visible effect on its own — it only changes the simulated accelerometer reading. It does not rotate the screen. You’ll only observe a change if the app under test has a feature that explicitly listens for the flip gesture. There is no separate screen-rotation step.

​
How to use

Write a step in plain language:
  • Flip the device
  • Turn the phone face-down to mute the ringer

​
Hold and return (optional)

By default the device flips face-down, holds for about 800 ms, then flips back. You can optionally control this:
  • <ms> — hold face-down for that many milliseconds before returning (e.g. 2000)
  • no_return — flip face-down and stay there (no return motion)
Leave it out to use the default (face-down, ~800 ms, then back).

​
Example use cases

  • Flip-to-mute / flip-to-silence — silence a call or alarm by turning the phone over
  • Flip-to-pause media or similar gesture-driven features
Sensor injection on emulators is approximate — the emulator’s own sensor service can overwrite the injected values, so an app’s flip detector may not always register the gesture. For reliable flip-detection testing, use a physical device.

​
Platform support

Android emulators only. Not supported on physical devices or on iOS.