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. The page documents how to use each widget.
- Sound Volume
- Rotate Screen
- Full-screen
- Clipboard
- Copy/Paste to the virtual device
- Copy/Paste from the virtual device
- File upload
- Camera and Microphone
- Battery
- GPS
- Capture
- Identifiers
- Network
- Baseband
- Phone
- Disk I/O
- Biometrics
- Navigation Widgets
- Power
Sound Volume
- You can control the volume of the sound emitted by your virtual device by clicking the volume controls.
- This feature is not available with Android Automotive.
Rotate Screen
- You can rotate the screen of your virtual device by clicking the rotate icon.
- This feature is not available with Android Automotive.
Full-screen
- You can turn the full-screen mode on or off by clicking the full-screen icon.
Clipboard
- This feature is not available with Android Automotive.
Copy/Paste to the virtual device
- 1. Click the clipboard icon to open the widget window.
- 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.
- A visual representation of the clipboard is displayed in the clipboard text window.
- The text is copied to the virtual device clipboard.
Copy/Paste 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 the clipboard to view the copied text in the clipboard window.
- 4. The text is automatically copied to your OS clipboard.
File upload
- You can upload files from your computer to the virtual device.
- 1. Click to open the widget window.
- 2. Click BROWSE to browse for the file you wish to upload.
- Uploaded files are stored in /sdcard/Download on the virtual device.
- You can also install the Open GApps package by clicking INSTALL OPEN GAPPS.
Camera and Microphone
- This feature is not available with Android Automotive.
- The Camera and Microphone injection widget allows you to send a video and audio stream from a virtual device to the Android system.
- The video stream comes from a real physical webcam and microphone connected or integrated into your computer.
- To use the Camera and Microphone injection widget:
- Click Allow your web browser to access your host webcam and microphone when prompted.
- The widget enables testing of an Android application that uses an Android built-in camera and microphone.
Battery
- This feature is not available with Android Automotive.
- 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 the battery widget to modify the charge level using the slider or enter a value in the Charge level field.
- You can toggle the State of charge: check to simulate Charging or uncheck to simulate Discharging.
GPS
- 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.
- The GPS widget allows real-time activation and modifications of a position, accuracy and bearing.
- To use the GPS widget, click the GPS widget and then set the following values:
- Value range
- Latitude: -90° to 90°
- Longitude: -180° to 180°
- Altitude: -10000 m to 10000 m
- Accuracy: 0 m to 200 m
- Bearing: 0° to 359.99°
- Speed: 0 m/s to 399.99 m/s
- You can also:
- Click My Position to get your current position.
- Click Map to open the built-in map and set your location. Once done, click Capture to retrieve the coordinates.
- Click Submit to apply the change.
Capture
- The Capture widget allows you to take a screenshot or screencast of virtual devices. This allows broadcasting images or videos of your applications.
- To open the capture window, click the Capture widget and choose an action:
- Screenshot: take a screenshot of your virtual device display.
- Screencast: record your device display. Click to stop recording.
Identifiers
- This feature is not available with Android Automotive.
- The Identifiers widget shows Android ID and Device ID numbers.
- You can view and edit these values at any time, without rebooting the virtual device.
- To use the Identifiers widget, click the ID widget.
Network
- The Network widget allows you to test how your application reacts with different network quality and performance types.
- Click the network widget to open it.
- By default, Wifi is enabled. To disable Wifi and simulate Mobile Data transfer speed, uncheck Wifi, select a Network Type and a Signal Strength from the drop-down lists.
- Network profiles and their values with max Signal strength (Great) are listed in the table:
| Download speed | Upload speed | Upload/Download delay (in ms) | Upload/Download packet loss |
| Unlimited | No Limit | No Limit | No Limit |
| 2G GSM | 14Kb/s | 14Kb/s | 500 |
| 2G GPRS | 57Kb/s | 28Kb/s | 300 |
| 2G EDGE | 236Kb/s | 236Kb/s | 75 |
| 3G UMTS | 384Kb/s | 384Kb/s | 75 |
| 3G HSDPA | 13.98Mb/s | 5.76Mb/s | 10 |
| 4G LTE | 173Mb/s | 58Mb/s | 5 |
| 5G | 1174Mb/s | 211Mb/s | 5 |
- 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 testing of different mobile network operators with different SIM operators.
- To open the widget window, fill the fields with the desired values:
- Network Operator: MCC/MNC
- Name
- SIM Operator: MCC/MNC
- MSIN
- Name
- Phone Number
- Click UPDATE to apply the changes.
- Phone
- Phone is only simulated: it is not possible to send or receive calls or messages to/from physical phones or tablets.
- The Phone widget allows testing of applications relying on telephony features and observing behavior when receiving a call or text message.
- To open the Phone widget, click the phone icon. Then enter a fictitious incoming phone number and:
- Click Call to simulate an incoming call.
- Enter a text message and click Send message to simulate an incoming 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 emulating devices with slow internal storage.
- It can be very handy when an app requires reading large amounts of data from the disk.
- The widget speed limit is added on top of the Cloud provider’s limit; ensure the chosen profile does not exceed the disk performance provided by the instance. If it does, the widget cannot emulate the expected disk performance.
- To open the widget:
- In Profile, select a device type:
- 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 in MiB.
- Click UPDATE to apply the change.
- When switching profiles, the disk cache is automatically cleared. You can force clearing the cache by clicking CLEAR CACHE.
Biometrics
- This feature is not available with Android Automotive.
- This feature requires Android 13 and above.
- The Biometrics widget allows simulation of fingerprint recognition.
- To use the Biometrics widget:
- Click the Biometrics widget to open it.
- The icons become available when fingerprint enrollment starts in Android.
- Authentication required will turn to Yes, enabling one of the following scenarios:
- recognized: fingerprint matched and recognized.
- unrecognized: fingerprint not matched or recognized.
- dirty: fingerprint is dirty.
- partial: only part of fingerprint is matched.
- insufficient: fingerprint quality is not good enough to be recognized.
- too fast: fingerprint capture was too fast to be recognized.
- Important Note: In order to use this widget in any application asking for Fingerprint authentication, you must configure one fingerprint in Android. Follow these steps in Android:
- Go to Settings.
- Then Security & privacy.
- Then Device unlock and Fingerprint.
- Select a screen lock method.
- Enter your Pattern, PIN or Password and click NEXT.
- Confirm and proceed to the setup.
- Use the Biometric widget to configure one finger.
Navigation Widgets
- The navigation widgets emulate the Android navigation buttons:
- Recents: bring the Android Recents Screen which lists recently accessed activities and tasks.
- Home: navigate to Android Home page.
- Back: kill the current activity and resume the previous one.
Power
- The Power Widget emulates a real device power button.
- The Power widget does not shut down the instance; the instance remains charged by the Cloud provider.
- To shutdown an instance safely, use Power Off and Reboot or do it from the Cloud provider EC2 dashboard.
- Sleep mode: click the sleep icon.
- Power off/Reset: click and hold the power button.
---
Note: The content above reflects the sections and details presented in the page, reorganized for readability while preserving the meaning and instructions from the source.