Countless hours can be spent trying to pick movies and shows that both you and your partner are interested in watching. Scrolling through movie titles and arguing over who gets the final say isn't the ideal way to spend a movie night. Cuddlebug offers a seamless way to choose the best titles for you and your partner, or even your friends!
-
Have a swiping functionality for users to swipe through movies (liking and disliking them)
-
Have a MyList page that allows users to review their past liked movies
-
Have a friends feature where users can add friends who use the app and compare movie lists
-
Create an all in one platform for browsing movies efficiently displaying all relevant information (Imdb score, description, title, year of release etc.)
-
Written in Java anticipating release on Android OS
MyList: Page dedicated to listing liked movies specific to each user account
FriendList: Page dedicated to listing users connected through the application
ExploreMovies: Page dedicated to swiping through movie posters (liking and disliking movies)
CardStack: Visual stacked image representation of movies displayed on main page of application
Yuyakaido. "Yuyakaido/CardStackView." GitHub, github.com/yuyakaido/CardStackView.
CuddleBug is a fun, attractive alternative to movie selection. We aim to acquire an up to date list of relevant films/tv shows available in Canada, design a modern, intuitive GUI for selection and have a user account system in place that permits sharing data between two or more accounts.
This process will help reduce time wasted trying to browse movies/tv shows a user might want to watch at any given time. Instead of taking the time to browse for a title before watching, CuddleBug users will have access to a pre-compiled list of all the movies they want to watch, alongside the movies their friends or partner may want to watch with them.
CuddleBug offers the following features:
-
Account authentication through email or google account
-
Viewing all users on the application
-
Adding and removing friends and viewing movies liked in common
-
Viewing movie titles, posters, ratings, descriptions and year of release
-
Liking and disliking movie selections
-
Viewing previously liked movies
End users consist of a wide variety of demographics, mostly those who are subscribed to streaming services or rent/purchase movies often.
|
Age
|
Varies anywhere from young adolescents to elderly
| |
Gender
|
Equal use from all genders
| |
Language and Culture
|
Currently English and French are the only languages supported
| |
Educational Level
|
All levels of education.
| |
Frequency of Use
|
We expect a high frequency of use, specifically concerning the MyList feature
| |
Motivation to Use
|
Motivation depends on each user's movie/tv watching habits. More motivation amongst those who spend more time watching.
|
These characteristics do not reflect any data collected during testing. They are only projections of our expected user base as we have yet to publish the app to market. Once published, Google Analytics will provide a detailed report on more specific characteristic details.
The CuddleBug experience is constrained by missing features that we look to implement moving forward. Several functionalities including the ability to filter and curate a given user's movie selection based on their preferences and a set of filters. Such a feature would require database manipulation, where custom queries could be sent to our API and processed in a way that returns the specific data requested. From the front end, a dropdown menu or search bar would need to be added so that users can make these requests from their end. Fortunately this was the only deliverable featured from our project proposal which did not make its way to the current application build.
The friends feature is also constrained by the inability to search for specific users by name or email. Currently, users can only add friends from a list that includes all other registered accounts on the app. With an increase in account registration, this will need to be addressed as the list of friends to add will quickly become too large to scroll through. This feature can be implemented by adding additional query options to our friends endpoint such as by name, email or phone number.
Given the time restrictions imposed by our deadlines, the MyList, ExploreMovies and Friends features are implemented in a basic manner to lay the foundation for development moving forward. We hope to better curate movies and improve our apps connectivity in the iterations following this report.
-
Compiled in compileSdkVersion 28
-
minSdkVersion 24
-
Google firebase authentication and firestore
-
CardStackView by github.com/yuyukaido
-
License agreement link https://opensource.org/licenses/Apache-2.0
The following requirements do not reflect the final version of CuddleBug. Version updates will continue following 12/09/2020.
Use Cases
|
MyList Class
| |
Actors
|
Teens, Adults
| |
Description
|
The user is able to view all of the movies they have previously liked and read additional information regarding the movie such as plot, actors, release date and genre.
| |
Data
|
List of ItemModel (Movie Objects) retrieved from our REST API
| |
Stimulus
|
Android Lifecycle Method → onCreateView triggers an asynchronous call to fetch for all liked movies given a user_id
| |
Response
|
A ListView is populated with the movie data and each corresponding movie is shown with its title and release date
| |
Comments
|
For new users, the list will appear empty as they have no previous entries.
|
|
FriendList Class
| |
Actors
|
Teens, Adults
| |
Description
|
The user is able to view all of the friends they've connected with on the application. In addition, they are able to view the movies which they have in common.
| |
Data
|
List of Friends (Friend Objects) retrieved from our REST API
List of Movies in Common between 2 users → retrieved from API
| |
Stimulus
|
Android Lifecycle Method → onCreateView triggers an asynchronous call to fetch for all friends and movies in common
| |
Response
|
A ListView is populated with the friend data and each corresponding friendship is displayed with their name
A Fragment is presented when a ListItem is clicked, displaying movies in common
| |
Comments
|
For new users or individuals who haven't added friends, there will be no content displayed in the ListView
|
CardStack
|
CardStack Class
| |
Actors
|
Teens, Adults
| |
Description
|
The user is able to view all of the new movies - objects they haven't liked before. Users will be able to swipe left or right depending on if they disliked or liked the movie, respectively.
| |
Data
|
List of ItemModel (Movie Objects) retrieved from REST API
| |
Stimulus
|
Android Lifecycle Method → onCreateView triggers an asynchronous call to fetch for all movies
| |
Response
|
A CardStackView is populated with all the movies, one card is presented at a time to the user
| |
Comments
|
There is a limit of 140 movies stored within the database.
|
Use Case Diagram
-
Application should feel fluid and responsive
-
Support a second language
-
Allow Google SignIn and Authentication
-
Be visually appealing and fun to use
|
Class
|
Functions
|
Description
| |
LoginActivity
|
-
firebaseAuthWithGoogle
-
signIn
-
UpdateUI
-
onActivityResult
|
Handles user login functionality.
A user can either login using Google Account Authentication or with a previously registered email.
| |
RegisterActivity
|
-
callAPI
-
registerNewUser
-
doInBackground
|
Registers a new account using a provided email, password and account name
| |
SplashActivity
|
- onCreate
|
Loading screen that displays when app is started. Allows sufficient time for data to be requested from API.
| |
ExploreActivity
|
- onCreate
|
Generates main explore page and declares MyList, Explore and Settings fragments
| |
Explore_Movies_Fragment
|
-
GetLikedMoviesQuery
-
onPostExecute
-
AsyncGet
-
AsyncPost
|
Populates CardStack object with a list of movie titles.
If user swipes right on images, the relevant movie information is posted to MyList
| |
My_List_Fragment
|
-
callAPI
-
AsyncGetLiked
-
onPostExecute
-
MovieDetailsQuery
-
onPostExecute
|
Populates ListView with liked movies from the user's account
| |
Settings_Fragment
|
-
openDrawer
-
closeDrawer
-
Logout
-
onNavigationItemSelected
|
Displays user's account information and app instructions.
Can navigate to side menu for friend adding features
| |
CardStackAdapter
|
-
ViewHolder
-
getItem
|
Handles swiping card functionality for movie cards. The entire list of movies is pulled from the movie API and displayed on screen.
Behaves according to swipe direction and posts results in MyList.
| |
AddedFriendsFragment
|
-
CallApi
-
AsyncGetFriends
-
onPostExecute
|
Displays the user's list of friends based on who they've added.
Once a friend's username is clicked, their list of movies is generated
| |
FriendModel
|
- FriendModel
|
Returns all relevant friend data from local friend list
| |
Friends
|
-
callAPI
-
callAddFriendAPI
-
onPostExecute
-
userAdapter
|
Locates other user accounts on the app and displays them for the user to add
| |
MoviesFriendFragment
|
-
callAPI
-
AsyncGetCommonMovies
-
onPostExecute
|
Compares and retrieves the all movies in common form user account and friend account.
| |
ItemModel
|
-
getPoster
-
getTitle
-
getYear
-
getRating
-
getImdbID
|
Returns all relevant movie data from the local movie array list.
|
|
Dates
|
Activities
| |
September 28, 2020
|
-
First meeting takes place,
-
Decided on app to be a movie selection service,
-
Github created,
-
Project proposal written,
| |
October 5, 2020
|
-
Searched for movie API,
-
Created starting layout:
-
Login page,
-
Main page,
| |
October 12, 2020
|
- Reading week,
| |
October 19, 2020
|
-
Starting working on login page using firebase,
-
Pages created:
-
MyList,
-
Explore Movies,
-
Settings,
-
Created tab at bottom of screen to easily navigate through pages,
| |
October 26, 2020
|
-
Continued work on login page:
-
Google authentication,
-
Regular email login,
-
Registration page,
| |
November 2, 2020
|
-
Started working on swiping functionality ,
-
Used hardcoded movies to test,
| |
November 9, 2020
|
-
Swiping functionality completed,
-
Login page completed:
-
Google authentication completed,
-
Basic login completed,
-
Registration completed,
| |
November 16, 2020
|
-
Empty fragment created containing:
-
Friends list,
-
Add friends,
-
logout,
| |
November 23, 2020
|
-
Movie database created,
-
API documentation/instructions written and shared,
| |
November 26, 2020
|
- Swiping function works with movies from database,
| |
November 28, 2020
|
-
Friends list completed,
-
Add friends completed,
| |
November 30, 2020
|
-
Logout functionality completed,
-
Content added to settings page,
| |
December 7, 2020
|
- Presentation day,
| |
December 8, 2020
|
-
App instructions added to settings page,
-
App functional in french,
-
Movie descriptions added,
| |
December 9, 2020
|
-
Project completed,
-
Submitted to mylearningspace,
|
Credentials used for testing:
Username: [email protected]
password:123456
Pasword: 123456
|
Page
|
Action
|
Result
| |
Login Page
|
Invalid credentials
|
-
Toast message: "Login Failed"
-
Both fields remain filled with invalid credentials until user deletes them
|
|
|
Valid credentials
|
-
Takes user to MyList only if user has registered properly
-
All of users data will be saved after logout as information is saved to database
-
Sign in remembered until logout
|
|
|
Google sign in
|
-
Button activates pop up that allows user to choose google account to use to sign in
-
Clicking account will lead to user being sent to main page in the app
-
For first time users this also acts as a registration page
|
|
|
Registration page
|
-
If all fields empty
-
Toast message: "Please enter email..."
-
If only email field entered:
-
Toast message: "Please enter password!"
-
If email and password fields entered:
-
Toast message: "Please enter a Name!"
-
If only confirm password field empty:
-
Toast message: "Password does not match Confirmed Password!"
-
If password and confirm password fields do not match:
-
Toast message: "Password does not match Confirmed Password!"
-
If all fields completed correctly:
-
Toast message: "Registration success"
-
Takes user to 'MyList' page
-
Password only accepted if length is greater than 5 characters
-
Username only accepted if it is in email format:
-
Example: [email protected]
| |
Logout
|
Functionality
|
-
Found on Settings page after top left image clicked
-
Message displayed:
-
"Are you sure you want to logout?"
-
If "NO" clicked user stays on settings page
-
If "YES" clicked user is logged out properly and will have to log back in to access account again
| |
MyList Page
|
Purpose of page
|
- This page only displays data that consists of movies the user has liked
|
|
|
Remove movie
|
- Cannot currently remove movies from list
|
|
|
Click on a movie
|
-
This displays movie description
-
To make movie description disappear:
-
Click on movie title again
| |
Explore Movies Page
|
Purpose of page
|
- To like and dislike movies
|
|
|
Swiping
|
-
Swipe left:
-
This action dislikes a movie
-
Toast message: "Disliked"
-
Swipe right:
-
This action likes a movie
-
Toast message: "Liked"
-
Swipe up and down:
-
User is unable to swipe up or down
| |
Settings page
|
Purpose of page
|
-
Information displayed:
-
Users name
-
Email
-
Instructions:
-
Explore movies page
-
Settings
|
|
|
Top left image clicked
|
-
Displays fragments:
-
Friends List
-
Add Friend
| |
Add friends page
|
Purpose of page
|
-
To add friends
-
Contains a list of current users
|
|
|
Adding functionality
|
-
Click users plus button to add them
-
The added users name is taken away from list after added
-
No functionality to remove friend
| |
Friends list
|
Purpose of page
|
-
Contains list of friends,
-
User must select a friend to see movies both users have liked
|
|
|
Functionality
|
-
Can click on friends and will take user to a section that shows common liked movies
-
User cannot remove any movies from this list
-
Cannot remove friend(s)
|
|
Iterations
|
Description
| |
Iteration 1
|
Basic XML page layout designed and created. This includes the login activity and the explore activity
| |
Iteration 2
|
Submitted iteration 1 buttons, swiping function with hardcoded movies.
| |
Iteration 3
|
Swiping through movies populated by database. Fully functional database that handles movies and users.
| |
Iteration 4
|
Add friends, friends list and my list page completed.
|
For testing purposes, use the following login information:
Credentials used for testing:
Username: [email protected]
password:123456
Or register your own account!
Registration is handled by Google Firebase Authentication. Registration requires a user to either link an active google account or create an account by providing their own email and password.
- For Google SignIn, simply click the sign in button with the Google logo next to it
- For non-Google accounts, users must click the register button which and fill out all the required information under the registration page
- Once an account has been created, users can Login by entering their credentials in the Login page
Once logged in, users will be brought to the Explore page, where movies appear in a stack-like display. By swiping right on the movie poster, it is added to the user's movie list. If disliked, it will be discarded and essentially popped from the stack.
The MyList page displays the titles of the movies that have been liked by the account alongside their year of release. Click on the movie title for a more detailed description
From the settings page, a user is able to view their information and manage their account. By clicking on the 3 lines on the top left of the page, additional options are revealed
The settings pullout menu will either redirect to the Friends List page, the Add Friend Page or the Logout button
- Friends List displays the user's current friend list. By clicking on a specific friend, a list of common movies between accounts becomes visible
- Friends can also be added from the Add Friends page
To logout click the logout button and confirm by clicking yes
