Scanning Angle Warnings
We did a good study about the scanning angle. Our conclusion is that to get better results you should keep your device tilted a little less than 45 degrees pointing down.
Here are some warnings you may get and what you should do:
Ceiling warning
The ceiling warning is displayed when the angle of the device is too high (scanning ceiling). Please, tilt your device down (a little less than 45 degrees should be fine).
Horizontal warning
Horizontal warning is displayed if you continue to scan in a too high scanning angle. For example, scanning kitchen fixed furniture would be okay for a brief moment of time with a higher scanning angle. If you get this warning, please tilt your device downwards a bit.
Excessive tilt warning
Floor warning is displayed when the angle of the device is too low (scanning floor). If you get this warning, please tilt your device upwards a bit.
Sideways Warning
Sideways warnings (left and right) are displayed when the user walks sideways / with device pointing to the wall. If you get this warning, please point the device to the walking direction (front).
Device Orientation Warnings
Portrait to landscape guidance
Portrait to landscape guidance is displayed when the scanning view is first launched and the device is in portrait orientation. This guidance can be dismissed by turning the device to landscape orientation (to the left), and this needs to be done in order to be able start recording.
Reverse-landscape warning
Reverse-landscape warning is displayed when the device is in reverse-landscape orientation (to the right). To dismiss this warning, the user needs to turn their phone (180 degrees) to the opposite landscape orientation.
Tracking Warnings
Insufficient lighting or features warning
This warning is displayed when scanning a space which is too dark or if the device has trouble finding its positioning (e.g. empty rooms with evenly colored walls and carpet). This warning displays the warning text, the orange borders and plays an error sound.
Moving too fast warning
This warning is displayed when the device or the user is moving too fast. This warning displays the warning text, the orange borders and plays an error sound.
Log in Warnings
Log in view has multiple warnings, and they’re all displayed in the orange pop-up warning.
| Warning message | Description |
|---|---|
| Wrong login details. | Email or password is incorrect. |
| Your token has expired please login again. | Login has expired. User has to re-login. |
| Finish your company details at https://app.cubi.casa/ | User needs to finish their company details (account creation). |
| Your token is invalid please login again. | Login has expired. User has to re-login. |
| Server is currently offline, we are working on it. | Server is offline, and login will not be possible. Please, try again in a few minutes. |
| Connection Error! Please check your internet connection. | Can’t login because the device is not connected to the internet. |
Pre-Scan Warnings
Pre-Scan view has multiple warnings, and they’re all displayed in the orange pop-up warning or in the basic error dialog.
| Error message | Description |
|---|---|
| Turn on Location Services. | Location Services are not turned on. User should enable Location to use the street name autofill. |
| Unable to use your current location. | App is unable to use the Location. |
| No Internet connection. Unable to get your current location. | Device is not connected to the internet and the App is unable to get the street name because of this. |
| Could not get your current location. | App is unable to get the Location. |
| Error message | Description |
|---|---|
| Something went wrong, please contact support. | Please, contact support. |
| We lost track of your phone, please try to scan again. Make sure to remove all external lenses from the device and not to enter small and dark spaces. | Scan drifted and the position data is incorrect. In this case the scan is terminated and not saved. Please, re-scan the whole property. |
| We are having trouble locating the device's position. Please start from a clear and non-obstructed place. | The scan could not be started, please, re-scan starting from a non-obstructed area. |
iOS counterpart will guide users to settings to enable location services for the App if the first permission prompt is denied.
Upload Warnings
A retry upload dialog is shown when the upload progress fails. User can choose to ‘Try Again’ which will continue the upload progress where it left off. Or ‘Cancel’ to exit the Upload if they want to try it later when they’ve a better internet connection for example.
Here are the list of the warnings messages you can get at this stage:
| Error message | Description |
|---|---|
| Can't send this order right now. Try again later. | Please, try again later. |
| Your account type is not suitable for the Android version. Please contact customer support. | Please, contact customer support. |
| Your package does not include scanning. Please contact customer support. | Please, contact customer support. |
| Your credentials have expired please login again. | Login has expired. User has to re-login. |
| Your key is invalid please login again. | Login has expired. User has to re-login. |
| Connection Error! Please check your internet connection. | Can’t send order because the device is not connected to the internet. |
Storage Space Warnings
Before starting a new scan from Pre Scan view or Draft Order Preview view we check how much available storage the device has. If the user’s storage space is almost full we display a warning in the basic error dialog. If the device doesn’t have enough storage space for a 5 minute scan we display a warning and scanning will be disabled. If the device has storage space for a 5-25 minute scan we display a warning but allow scanning.
| Warning message | Description |
|---|---|
| Your Storage space is almost full! Delete some files to make more space available. | Device doesn’t have enough storage space for a 5 minute scan. Please, clear some space on your device before trying again. |
| Your Storage space is almost full! You can scan for approximately | Device doesn’t have enough storage space for a long scan. Please, clear some space on your device before trying again. |
Internet Connection Warnings
The app has multiple internet connection checks around the App. On Android they display the same “Connection Error! Please check your internet connection.” message if the device is not connected to the internet. If a user gets this warning they should check their internet connection. If something still is not working in the App, they should go back one page/view (using the back button/arrow) and then open the page/view they were before.
For example, currently on Android when the On Device scan’s Order Preview view is opened without an internet connection, this warning will be displayed and the Send button will be disabled. To try again, please exit the send order view, and try to send the order again when the internet is available.
The iOS gives this warning in the send order view.
iOS exclusive scan warnings
Relocation
This warning appears when tracking is lost and it will prompt a relocation screen. Clicking the button it will open next prompt to guide user.
This prompt will instruct the user to scan previous place again to get tracking back in good state, clicking button will start the relocation.
This screen will show when the user is scanning previous space. And after successful relocation application will inform the user.
After this prompt user can continue with the scan normally.
