# 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:

Icon Feature Icon Feature
Volume up Volume down Sound volume Rotate Rotate screen
Fullscreen Full-screen Upload File upload
Clipboard Clipboard Snapshot Camera
Battery Battery GPS GPS
Screenshot active Capture Device ID Identifiers
Network active Network Text and call Phone
Resolution Resolution Disk IO Disk I/O
Recent Apps Home Back Navigation widgets Power Power

# 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

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

To do so, click Upload and BROWSE to browse for the file you wish to upload.

Note

You may have to restart your virtual device to see a newly uploaded file. In order to do so, you can call adb reboot command on this device, once connected with our gmsaas CLI tool.

You can also install the Open GApps package by clicking on INSTALL OPEN GAPPS.

# Clipboard

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

# Copy to the virtual device

  1. Click Clipboard
  2. Paste your text into the clipboard text field.
  3. From within the virtual device, hold the left mouse button in the field you wish to paste to.
  4. Click Paste as on a real Android device.

# Copy from the virtual device

  1. From within the virtual device, select the text you wish to copy and hold the left mouse button.
  2. Click Copy or Cut as on a real Android device.
  3. Click Clipboard, the copied text is displayed in the clipboard text window.
  4. The text is automatically copied to your OS clipboard.

# 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 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 use the Camera widget, click Snapshot

Important

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:

  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 plugged-in power supply and charging battery.
    • Uncheck to activate the Discharging state. This simulates unplugged power supply and discharging battery.

# 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 a value for the following fields:
Field Description Value range
Latitude Sets the latitude you wish to simulate. -90° to 90°
Longitude Sets the longititude you wish to simulate. -180° to 180°
Altitude Sets the altitude you wish to simulate. -10000m to 10000m
Accuracy Sets the accuracy using the slider or by entering a value. 0m to 200m
Bearing Sets the bearing by using the compass or entering a value. 0° to 359.99°

Note

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 define a location using the Map button. Once a location is 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 open the widget, click Capture active and select an action:

Icon
Screenshot Take a screenshot of your virtual device.
Start Recording Record your device display. Click Capture inactive to stop recording.

When done, select a folder on your computer to save your screenshot or video.

# 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 Device ID

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 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 000000000000000. 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

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

To test network quality and performance types:

  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.
Profile Upload speed Download speed Upload/Download delay (in ms) Packet loss DNS delay (in ms)
No data 0Kb/s 0Kb/s 0 100% 0
GPRS 40Kb/s 40Kb/s 500 0.01% 1000
Edge 200Kb/s 240Kb/s 400 0.01% 800
3G 1.5Mb/s 7.2Mb/s 100 0.01% 200
4G 5.5Mb/s 17.9Mb/s 50 0.01% 100
4G
(high DNS delay)
5.5Mb/s 17.9Mb/s 50 0.01% 3000
4G
(high packet losses)
5.5Mb/s 17.9Mb/s 50 10% 100
Wifi 33.0Mb/s 40.0Mb/s 0 0% 0

# Phone

Note

Phone is only simulated - it is not possible to call or send messages to real mobile phones or tablets with Genymotion.

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

Simulate an incoming call
  1. Enter an incoming phone number.
  2. Click Call.
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.

# Resolution

The Resolution feature allows you to increase or decrease the resolution of the displayed content in your virtual device. To use this feature, click Resolution and select a resolution between 240p, 360p, 480p, 720p and 1080p.

# 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.

To simulate high or poor disk performance:

  1. Click Disk IO

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

    Profile Read speed limit
    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.
  3. Click Update.

Note

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

Icon
Recent Apps Brings the Android Recents Screen which lists recently accessed activities and tasks.
Home Emulates the Home button of a real device. Navigate to Android Home page.
Back Emulates 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.
A click on the widget will only turn off the screen.
A long press will show the Android power off menu. You will be able to reboot or shutdown the instance (depending on the Android version).

Warning

To be sure to switch off a device properly, and avoid extra charges, please refer to Stopping a virtual device instead.