Video Tutorial
Welcome to the tutorial on how to use the app. Here, you will find explanations of functionality and design, with video demonstrations.
- On Startup
- Selecting Origin and Destination
- Moving to Destination
- Running on Device that doesn't support Bluetooth
This is the first screen of the app. Listed are nearby devices your phone is able to connect with Bluetooth, and the devices' Bluetooth addresses.
When using the Naviglass project, you would wear the Naviglass virtual reality glasses and select the Naviglass Raspberry Pi from this list. Then, your phone would pair with the Pi.
Side Note: app has a bug where if you change orientation of the phone, it restarts. Please lock the orientation to prevent app from restarting.
If Bluetooth is turned OFF, the app requests permission to turn ON.
The app requests permission to access phone Location/GPS. If Location is turned OFF, app sends a notification: "Location is disabled. App requires location access".
If you click on a device from the list of Bluetooth devices, a map (powered by Google Maps) occupies full-screen. In the video, it's a world map at first, because app does not know your phone's whereabouts. After you manually turn on Location on Settings, your location is positioned on the center of the map.
Side Note: In rare circumstances, location needs to be refreshed on phone. In this case, app sends notification: "Unable to retrieve last known location. Please move device". You should shake the phone or move a few steps.
You can refresh the list of Bluetooth devices by swiping down on the list. If a nearby device was initially undetected and is not on the list, it would appear after the refresh.
Your location is automatically labeled as the Origin. You can select and change your Destination by clicking on a place on the map, or by searching for a place on the Google Maps toolbar. The route is drawn on map in solid red line.
After selecting final destination, you would click button SET DESTINATION on bottom left. This button signals the app to send information about destination and route to Raspberry Pi via Bluetooth.
Side Note: The app only supports destinations reasonably close to the origin because of limitations of the Pi. If destination is too far away, app sends a notification: "Map image is too big for the phone. Please select a closer destination"
In this video, continued from previous video, the user starts from origin and drives towards destination. Location of the user is indicated on map by the blue dot.
You can move the map around and change its zoom. However, at any time you move, the map automatically adjusts to center your new location and returns to default zoom level.
You can reference the map for directions. However, if you are wearing Naviglass glasses, the glasses would show you the route and the view around you.
If the app is started on a device that does not have Bluetooth functionality, it will close itself and send a notification: "Bluetooth is not available in this device. Terminating application". This is because the app requires Bluetooth connection to communicate with the Pi. The app would terminate itself and send a similar notification if the user was to deny the app's request to turn on Bluetooth after startup.