/Vineyard

Vine client for Android TV

Primary LanguageJavaOtherNOASSERTION

Vineyard

==========

Loading Card

Vineyard is an unofficial Vine client for Android TV. The project currently consists of:

  • Android TV Application
  • Unit Tests
  • User Interface Tests

Release 1.0 of the application allows you to:

  • Browse feeds from a range of Video Categories
  • Watch Vine video posts
  • Search for Vine Users and Hashtags
  • View video grids for Users and Hashtags
  • Toggle the Auto-Loop option via Settings

#Screens

##Browse Fragment

The browse fragment is what is used to display the browseable categories, post and options card. The Icon Header Item Presenter is used to setup and display the categories in the headers dock, the Post Adapter and Card Presenter is used to display the Post cards and the Icon Item Presenter sets and displays the option and error message cards.

Main

Preview Post

##Playback Activity

The Playback Activity is used to play the video from a Vine post. Which used the PlaybackOverlayFragment to display the playback controls over the top of the PlaybackActivity.

Video

Video Related

##Search Fragment

The Search Fragment allows users to search for Vine Posts by either tags or usernames. The Tag Presenter is used to display the tag/username query results, the posts are then displayed beneath whenever a tag/username result becomes focused.

Search

Search No Results

##Post Grid Fragment

The Post Grid Fragment is used to show a grid of videos from either a Hashtag or User feed. This screen is launched when a hashtag/username result is clicked in the Search Fragment.

Post Grid

##AutoLoop Step Fragment

The AutoLoop Step Fragment is used to toggle the AutoLoop setting for post videos. When enabled, videos will automatically loop until the video is either stopped or skipped. If this is not enabled then videos will automatically play until the final one in the playlist is reached.

Settings

#Custom Components

Many of the screens used some of these custom components created especially for the needs of this app:

##Video Card View

Video Card View

This view extends the BaseCardView class so that we can make our own custom CardView. The functionality of this view is display a video preview of the vine post card that is currently in focus. It's made up of the following components:

##Pagination Adapter

Here I created a custom adapter by extending the standard ArrayObjectAdapter to allow the application to handle pagination requests. When the final item in a row of Posts becomes focused, the paginated request is triggered and the Loading Card View is displayed until the results are returned.

##Loading Card View

The Loading Card View again extends the BaseCardView class and is a simple cardview that displays a loading indicator to the user. This is used when Pagination is in use (using the PaginationAdapter) to notify the user that Posts are being loaded.

Loading Card

##Tag Card View

The Tag Card View again extends the BaseCardView class and is a simple cardview that displays either a hashtag or username. This is used to display the search results in the SearchFragment.

Tag Card

##Icon Card View

The Icon Card View again extends the BaseCardView class and is an interactable cardview that can be used to display an icon with both a title and description. Currently I use this for several different situations:

  • Displaying options

Options Card

  • Displaying a 'Try Again' card when there is an error fetching results

Try Again Card

  • Displaying a 'Check Again' card when an empty result list is returned

Check Again Card

#Building

To build, install and run a debug version, run this from the root of the project:

````./gradlew assembleDebug```

#Unit Tests

To run the unit tests for the application:

````./gradlew testDebugUnitTest```

#User Interface Tests

To run the user interface tests for the application:

````./gradlew connectedDebugAndroidTest```