Skip to content

User Guide

Shehan Madhusanka edited this page May 20, 2022 · 7 revisions

Installation

First, download the source code and run the Android studio application after connecting your mobile device to the laptop or computer. This application is compatible with devices android version 5 or higher.

Visit https://github.com/sheiiz/e18-co225-android-bluetooth-chatapp to download the source code.


Log in features

On the welcome to SkyChat page, if you already have an account you can log in to your account by inputting your username and password. If you do not have an account click on the “Don’t have an account?” to complete the process.


Registration for a new account

On the create a new account page insert your username and desired password. By clicking on the image, the user can choose an image for his/her account. If you already have an account click on the “Already have an account” to input your username and password.


Menu Bar

The menu bar has three components

  • Bluetooth Icon - To turn on/off Bluetooth
  • Search icon
  • More options
    • Create a new group
    • Settings
    • Exit


Home View

The home page consists of three fragments.


Chats

It displays previous chats that a particular user had. Inside each chat, its chat history is displayed and at the top right corner, there are two buttons: listen and connect. To start a two-way chat one should click listen and the other should click connect. Also, you can add a new chat by clicking on one of the paired devices listed under the devices fragment.


Group Chats

This fragment contains the group chats of which a particular user is a member. You can also start a new group chat by clicking the create a new group in the more option.


Devices

When the user enables Bluetooth, paired devices and available devices which are near to this device are listed under this fragment. By clicking one of the paired devices, the user can start a two-way chat when one party clicks the listen and the other party clicks the connect. If a user clicks an available device, it will direct to a two-way chat. Since those devices are not paired, after clicking the listen and connect buttons each party receives a notification to pair the devices.

Two buttons are available at the bottom of this fragment.

  • SCAN FOR DEVICES - scan the devices nearby and list them under paired devices or available devices.
  • MAKE DISCOVERABLE - on the visibility of the device for 300 milliseconds


More Option

This consists of three options.


Create A New Group

Using this user can create a new group chat. By clicking on the image, the user can choose a group icon for the chat. After clicking the CREATE GROUP button the new group will list in the group chat fragment.



Settings

Users can change the settings of their accounts by setting a new username and a new password.


Exit

By clicking this you can log out from the application.