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, Rotate screen, Fullscreen, File upload, Camera, Battery, GPS, Identifers, Network and Baseband, Phone, Resolution and Disk I/O.

Sound volume

You can control the volume of the sound emitted by your virtual device by clicking Volume up or Volume down.

Rotate screen

You can rotate the screen of your virtual device by clicking Rotate.

Full-screen

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

File upload

You can upload files from your computer to the virtual device. To do so, click Upload and browse for the file you wish to upload.

Camera

The Camera 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 an Android built-in camera. The video stream comes from a real physical webcam connected or integrated into your computer.
To use the Camera widget, click Snapshot.

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

From Resolution active, select a resolution with a ratio that matches your webcam orientation (for example 1024x800 for a portrait image or 800x1024 for a landscape orientation source).

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:

  1. Click Battery.
  2. Modify the charge level using the slider or enter a value in the Charge level field.
  3. Modify the state of charge by checking the State of charge box:
    • Check to activate the Charging state. This simulates that the power supply is plugged in and the battery is charging.
    • Uncheck to activate the Discharging state. This simulates that the power supply is unplugged and the battery is discharging.

GPS

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

  1. Click GPS.
  2. Set the latitude value you wish to simulate using the Latitude field. The latitude value must range from -90° to 90°.
  3. Set the longitude value you wish to simulate using the Longitude field. The longitude value must range from -180° to 180°.
  4. Set the altitude value you wish to simulate using the Altitude field. The altitude value must range from -10000m to 10000m.
  5. Set an accuracy value using the slider or by entering a value in the Accuracy field. The accuracy value must range from 0m to 200m.
  6. Set a bearing value using the compass or by entering a value in the Bearing field. The bearing value must range from 0° to 359.99°.

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

You can also define a location using the Map button. Once a location selected, click Capture to retrieve its coordinates.

Capture

The Capture widget allows you to take a screenshot or screencast of virtual devices. This way, you can broadcast images or videos of your applications.
To take a screenshot of your virtual device, click Screenshot active and screenshot.
To take a screencast of your virtual device:

  1. Click Capture active.
  2. Click Record to start recording.
  3. Record your sequence.
  4. Click Capture inactive to stop recording.

Screenshots and screencasts are stored in your Downloads folder.

Identifiers

The Identifiers widget shows Device ID and Android ID numbers. You can view and edit these values at any time, without having to reboot your virtual device.
To use the Identifiers widget, click Identifiers

Android ID

An Android ID is a 64-bit number randomly generated when the user first sets up the device. It remains the same for the whole lifetime of the user's device. Android 4.2.2 and greater versions support multiple user accounts, each one having a unique Android ID.When clicking GENERATE, a random Android identifier is generated. Valid Android ID numbers are 16-hexadecimal digits long.

You are not allowed to set an empty Android ID.

Device ID / IMEI / MEID

By default, a new virtual device is deployed with the default device ID number 00000000000000 0. When clicking GENERATE, a random identifier is generated. As IMEI or MEID numbers are used as device ID, Genymotion generates numbers compliant with the GSM 02.16 standard and the 3GPP2 specification (14 digits or hexadecimal digits + a checksum digit).
Valid characters for setting device ID/IMEI/MEID are:

  • lower-case and upper-case letters [a-z, A-Z]
  • digits [0-9]
  • dots [ . ]
  • dashes [ - ]
  • underscores [ _ ]

Network and Baseband

The Network and Baseband widget allows you to test how your application reacts with different network quality and performance types. You can also test different mobile network operators with different SIM operators.

Network

  1. Click Network active.
  2. Select a network profile from the Network Speed drop-down list. Network profiles and their corresponding values are listed in the table below.
Upload speed Download speed Upload delay Download delay Upload packet loss Download packet loss DNS delay
No data 0Kb/s 0Kb/s 0ms 0ms 100% 100% 0ms
GPRS 40Kb/s 40Kb/s 500ms 500ms 0.01% 0.01% 1000ms
Edge 200Kb/s 240Kb/s 400ms 400ms 0.01% 0.01% 800ms
3G 1.5Mb/s 7.2Mb/s 100ms 100ms 0.01% 0.01% 200ms
4G 5.5Mb/s 17.9Mb/s 50ms 50ms 0.01% 0.01% 100ms
4G 5.5Mb/s 17.9Mb/s 50ms 50ms 0.01% 0.01% 3000ms (high DNS delay)
4G 5.5Mb/s 17.9Mb/s 50ms 50ms 10% 10% 100ms (high packet losses)
Wifi 33.0Mb/s 40.0Mb/s 0ms 0ms 0% 0% 0ms

Baseband

  1. Click Network widget button.
  2. In MCC/MNC, enter a Mobile Country Code for the SIM operator.
  3. In MSIN, enter a mobile subscription identification number used by the SIM operator.
  4. In Name, enter a name for the SIM operator.
  5. In Phone Number, enter the phone number corresponding to the SIM.

You can then specify the mobile network information:

  1. In MCC/MNC, enter the Mobile Country Code or Mobile Network Code you wish to test.
  2. Enter the name of the operator.

Phone

The Phone widget allows you to test applications relying on telephony features and observe their behavior when receiving a call or a text message. To use the Phone widget, click Text and call.

To simulate an incoming call:

  1. Enter an incoming phone number.
  2. Click Call.

To simulate an incoming message:

  1. Enter an incoming phone number.
  2. Enter a text message.
  3. Click Send message.

The text message is displayed in the virtual device via a notification and 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.

As the speed limit provided by this feature comes on top of the one already defined in the AWS or GCP instance, make sure the profile you wish to apply does not exceed the disk performance already provided in the instance. If so, the widget will not be able to emulate the expected disk performance. For more information, refer to the AWS documentation or GCP documentation.

To simulate high or poor disk performance:

  1. Click Disk IO.
  2. From Profile, select a type of device:
    • High-end device: Read speed limit at 200MiB per second.
    • Mid-range device: Read speed limit at 100MiB per second.
    • Low-end device: Read speed limit at 50MiB per second.
    • Custom device: enter the read speed limit you wish to emulate in MiB.
  3. Click Update.

When switching from a device profile to another, the disk cache is automatically cleared. You can force clearing the cache by clicking Clear Cache.

  • Recent Apps widget Recent Apps: brings the Android Recents Screen which lists recently accessed activities and tasks.
  • Home widget Home: emulate the Home button of a real device. Navigate to Android Home page.
  • Back widget Back: emulate the Back button of a real device. Kills the current activity and resumes the previous one.

Power

The Power Widget Power simulates a real device power button. Left click on the widget to put the virtual device to sleep or long lest-click to simulate a power button hold (reset or power off).

A short press on this button does not shut down the instance, and you will still be charged by the cloud provider. To shutdown an instance, go to your cloud provider console and stop it.