Skip to content

Features and Emulated Sensors

To simulate various behaviors of your application according to specific use cases, Genymotion provides easy-to-use widgets which emulate the following sensors and features:

Sound volume

You can control the volume of the sound emitted by your virtual device by clicking or

Rotate screen

You can rotate the screen of your virtual device by clicking

Full-screen

You can turn the full-screen mode on or off by clicking

Install Apps

The Install Apps widget allows you to upload and install .apk files, or install Google Play Store from the Open GApps package.

Click to open the widget:

Install apps widget window

Then, you can either:

  • Install the Open GApps package to get Google Play Store. To do so, click INSTALL GAPPS and follow the instructions. For more details, please refer to Basic Steps - Installing Open GApps.
  • Drag'n drop an .apk file. The file will be automatically deployed.
  • Browse your computer to upload an .apk file. The file will be automatically deployed.

File upload

Installing an .apk or uploading any files from your computer to the virtual device can be achieved with the File Upload widget.

Click to open the Widget:

File upload widget

Click BROWSE to browse for the file you wish to upload.

Info

  • .apk files will be automatically installed.
  • .zip files will be automatically flashed.
  • Any other file type will just be uploaded to the device sdcard/Download folder.
  • You may have to restart your virtual device to see a newly uploaded file.

Clipboard

The Clipboard widget allows you to copy and paste text to and from the virtual device.

Copy to the virtual device

  1. Click to open the clipboard widget:
    Clipboard widget window
  2. Paste your text into the clipboard text field.
  3. Click COPY TO DEVICE
  4. On the device display, hold the mouse left button and select Paste as on a real Android device:
    Paste from clipboard to Android device

Copy from the virtual device

  1. On the device display, select the text you wish to copy, hold the left mouse button and select Copy:
    Copy from Android device to clipboard widget
  2. Click , the copied text is displayed in the clipboard text window:
    Clipboard widget window with copied text
  3. Copy the content of the clipboard widget to your computer clipboard.

Camera

The Camera injection widget allows you to send a video stream from a virtual device to the Android system. With this widget, you can test an Android application that uses Android built-in cameras.

The default video stream is a simple video placeholder - you can also use the video stream from a real physical webcam connected or integrated into your computer.

To toggle the Camera injection widget, click in the right toolbar.

Make sure your camera is allowed to access the virtual device.

Battery

The Battery widget allows you to test how your application reacts with different battery charge levels and states of charge.

To use the Battery widget, click

Battery widget

Then, you can:

  • Modify the charge level using the slider or entering a value in the Charge level section.
  • Toggle the State of charge.

GPS

The GPS widget allows real-time activation and modifications of a position, accuracy and bearing.

Click to open the GPS widget:

GPS widget

Set a value for each parameter:

Value range
Latitude -90° to 90°
Longitude -180° to 180°
Altitude -10000m to 10000m
Accuracy 0m to 200m
Bearing 0° to 359.99°
Speed 0 m/s to 399.99 m/s

Many applications do not rely on GPS orientation, but use the device accelerometer or gyroscope to determine the device bearing instead. These features are not supported yet.

You can also:

  • Click MAP to open the built-in map and select a location.
  • Click SET TO MY POSITION to get your current position (as returned by your browser).

    You have to allow your browser to access your location.

Then, click APPLY to set the values.

Capture

The Capture widget allows you to take a screenshot of the virtual device display.

Click to take a screenshot and save it on your computer.

Screen record

The Screen record widget allows you to record the virtual device display.

Click to start recording, and click again to stop and save the screen record on your computer.

Identifiers

The Identifiers widget shows Android ID and Device ID/IMEI/MEID. You can view or edit these values, without having to reboot your virtual device.

Click to open the Identifiers widget:

Identifiers widget

Input values, or click to generate random values.

Click APPLY to set the values.

Info

  • You cannot set an empty Android ID.
  • By default, a new virtual device is deployed with device ID "000000000000000".
  • Valid characters for setting device ID/IMEI/MEID are lower-case and upper-case letters [a-z, A-Z], digits [0-9], dots [ . ], dashes [ - ] and underscores [ _ ].

Network

The Network widget allows you to test how your application reacts with different network quality and performance types.

This feature is no longer available for Android 8.1 and below

Click to open the widget:

Network widget

By default, Wifi is enabled. To simulate Mobile Data transfer speed, toggle Wifi off, select a Network Type and a Signal Strength from the drop-down lists.

Network profiles and their corresponding values with max Signal strength (Great) are listed in the table below:

Download speed Upload speed Upload/Download delay (in ms) Upload/Download packet loss
Unlimited No Limit No Limit No Limit 0
2G GSM 14Kb/s 14 Kb/s 500 0
2G GPRS 57Kb/s 28Kb/s 300 0
2G EDGE 236Kb/s 236Kb/s 75 0
3G UMTS 384Kb/s 384Kb/s 75 0
3G HSDPA 13.98Mb/s 5.76Mb/s 10 0
4G LTE 173Mb/s 58Mb/s 5 0
5G 1174Mb/s 211Mb/s 5 0

Baseband

SIM data (Baseband) is only simulated: it is not possible to send or receive calls or messages to/from physical phones or tablets.

Baseband emulation allows you to test different mobile network operators with different SIM operators.

Click to open the widget window:

Baseband

Fill the fields with the desired values:

Network Operator
MCC/MNC Enter a Mobile Country Code for the Network operator.
Name Enter a name for the Network Operator.
SIM Operator
MCC/MNC Enter a Mobile Country Code for the SIM operator.
MSIN Enter a mobile subscription identification number used by the SIM operator.
Name Enter a name for the SIM operator.
Phone Number Enter the phone number corresponding to the SIM.

Click APPLY to set the values.

Phone

It is not possible to send or receive calls or text messages to/from real phones or tablets.

The Phone widget allows you to simulate phone calls and text messages to test applications relying on telephony features and monitor their behavior.

Click to open the Phone widget:

Phone widget window

Enter a fictitious incoming phone number and:

  • Click CALL to simulate an incoming call
  • Enter some text and click SEND MESSAGE to simulate a text message.

Text messages are displayed in the virtual device via a notification, but they can also be read in the Messaging application.

Disk I/O

The Disk I/O widget allows you to emulate devices with slow internal storage. It can be very handy if your app requires reading large amount of data from the disk such as gallery apps that load locally stored images or game apps that load large files.

Click to open the widget:

Disk IO widget

From the Profile drop-down list, select a type of device:

  • High-end device: Read speed limit 200MiB per second.
  • Mid-range device: Read speed limit 100MiB per second.
  • Low-end device: Read speed limit 50MiB per second.
  • Custom device: Enter the read speed limit you wish to emulate in MiB.

Click APPLY to apply the change.

When switching from a device profile to another, the disk cache is automatically cleared. However, you can force clearing the cache by clicking CLEAR.

Biometrics

This feature is only available for Android 13 and 14 for the moment.

The Biometrics widget allows you to simulate fingerprint recognition.

Click to open the widget window:

Biometrics widget disabled

The icons will only become available when fingerprint enrollment starts in Android. At this moment, Biometric authentication required will turn to Yes:

Biometrics widget enabled

Then, you will be able to click on one of the icons to simulate the following scenarios:

  • Recognized: the fingerprint is matched and recognized.
  • Unrecognized: the fingerprint is not matched nor recognized.
  • Dirty: the fingerprint is dirty.
  • Partial: only part of the fingerprint is matched.
  • Insufficient: the fingerprint quality is not good enough to be recognized.
  • Too fast: the fingerprint capture has been made too fast to be recognized.

You can also toggle Automatic biometric authentication to automatically respond to a fingerprint enrollment with the Recognized scenario.

Important Note

In order to use this widget in any application asking for Fingerprint authentication, you need to configure one fingerprint in Android.

Follow these step, in Android:

  1. Go to "Settings".
  2. Then "Security".
  3. Then "Fingerprint".
  4. Then click on "Add fingerprint" and use the Biometric widget to configure one finger.

The navigation widgets emulate Android navigation buttons:

  • Created with Sketch. : List recently accessed activities and tasks.
  • Created with Sketch. : Navigate to Android Home page.
  • Created with Sketch. : Kill the current activity and resumes the previous one.

Power

The Power Widget simulates a real device power button:

  • Sleep mode: Click to put the device to sleep.
  • Power Off / Reboot: Click and hold the mouse button to show the Android power off menu (reboot, shutdown, etc.).

Using the power off button to shutdown the virtual device may not shutdown the instance completely and cause unwanted extra charges. See Stopping a virtual device for safer methods.