# 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 and Resolution.
# 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 .
You can turn the full-screen mode on or off by clicking .
# 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 and browse for the file you wish to upload.
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.
The Clipboard widget allows you to copy and paste text to and from the virtual device.
# Copy to the virtual device
- Click .
- Paste your text into the clipboard text field.
- From within the virtual device, hold the left mouse button in the field you wish to paste to.
- Click Paste as on a real Android device.
# Copy from the virtual device
- From within the virtual device, select the text you wish to copy and hold the left mouse button.
- Click Copy or Cut as on a real Android device.
- Click . The copied text is displayed in the clipboard text window.
- The text is automatically copied to your OS clipboard.
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 .
Make sure your camera is allowed to access the virtual device.
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 .
- Modify the charge level using the slider or enter a value in the Charge level field.
- 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.
The GPS widget allows real-time activation and modifications of a position, accuracy and bearing. To use the GPS widget:
- Click .
- Set the latitude value you wish to simulate using the Latitude field. The latitude value must range from -90° to 90°.
- Set the longitude value you wish to simulate using the Longitude field. The longitude value must range from -180° to 180°.
- Set the altitude value you wish to simulate using the Altitude field. The altitude value must range from -10000m to 10000m.
- 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.
- 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 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.
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 and .
To take a screencast of your virtual device:
- Click .
- Click to start recording.
- Record your sequence.
- Click to stop recording.
Screenshots and screencasts are stored in your Downloads folder.
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 .
# 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 [ _ ]
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:
- Click .
- 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|
|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)|
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 .
To simulate an incoming call:
- Enter an incoming phone number.
- Click Call.
To simulate an incoming message:
- Enter an incoming phone number.
- Enter a text message.
- Click Send message.
The text message is displayed in the virtual device via a notification and can also be read in the Messaging application.
The Resolution feature allows you to increase or decrease the resolution of the displayed content in your virtual device. To use this feature, click and select a resolution between 240p, 360p, 480p, 720p and 1080p.
# Navigation Widgets
- Recent Apps widget : brings the Android Recents Screen which lists recently accessed activities and tasks.
- Home widget : emulate the
Homebutton of a real device. Navigate to Android Home page.
- Back widget : emulate the
Backbutton of a real device. Kills the current activity and resumes the previous one.
The Power Widget 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).
To be sure to switch off a device properly, and avoid extra charges, you should avoid using the Power Widget. Please refer to Stopping a virtual device instead.