Homework 4 - MediaPlayer and Service

Transcription

1 Homework 4 - MediaPlayer and Service Due: 10/12/18 by 11:59pm I hope that you have fun completing this homework assignment. You are to develop an app that will play a streaming MP3 from FreeMusicArchive. You can also use another hosted (not saved locally on the device) MP3 of your choosing but be mindful of copyright laws when doing so. If you opt to use your own hosted MP3, ensure you have access to the album art or similar art resource to be used with your project. Ensure you bring your final application together with a clean and attractive UI. SUBMISSION INSTRUCTIONS Submit through Canvas REQUIREMENTS Version - Your app should work on Android or higher Archive - You can use any archive you want (zip, tar, bz2, ) Package Name - edu.fsu.cs.mobile.hw4 TEMPLATE FILES Sample Song: Arise by Podington Bear %2FUplifting%2FPodington_Bear_-_Arise.mp3 You can use any song from FreeMusicArchive (or another source as long as it is publicly available and you have permission) FEATURES MediaPlayerActivity - Buttons

2 Play Button - Plays/continues song Disabled when music is playing, enabled when paused or stopped Stop Button - Stops song. Playing restarts from beginning Disabled when music is stopped, enabled when playing or paused Can use MediaPlayer.stop() or pause() and seekto() Pause Button - Pauses song Disabled when music is paused or stopped, enabled when playing MediaPlayer UI - Two states: Empty and Ready Empty state: Display TextView with text No Song Available Display ImageView with default image (I Ready state: Once streaming url has been entered Song Title - actual name of song Song can be parsed from URL or hardcoded Artist Name - actual artist name Artist can be parsed from URL or hardcoded Album Cover - Default to any image (just used to indicate song not ready) Must be a DIFFERENT image. This DOES NOT have to be the actual album cover of the song, but just any other image to indicate song is ready to play StreamSongDialog - Allow user to enter url for song Can use any method to display to user (Dialog, DialogFragment, Fragment, etc) Once the user enters the url, clicking Stream starts the MyMediaService and displays the Ready UI. MyMediaService - Extends Service, simply contains MediaPlayer Use may use a Started or Bound Service Use one of the appropriate service communication methods discussed in class Receives commands from MediaPlayerActivity and performs actions on MediaPlayer Notifications - Song playing - Display notification when song is playing Clicking on song reopens application and does not interrupt MediaPlayer When song is paused or stopped, notification should be removed Options Menu A Stream option that will open StreamSongDialog An Exit button that will

3 i. Exit the app ii. Stop the MediaPlayer service THINGS TO NOTE 1. Your Activity should not actually play the music itself, that s what your Service is for. Clicking on the playback Buttons from within your Activity should make calls to the Service, and the Service should take the appropriate action. This prevents playback from being stopped when your Activity loses focus 2. Do not place the MP3 inside of your res/raw directory. You re supposed to pass the URL of the song to the MediaPlayer for streaming. However, you can use a raw MP3 file for testing your MyMediaService. GRADING You CANNOT receive extra credit if your assignment is submitted late Correct implementation of MediaPlayerActivity Correct menu implementation and functionality Service termination/preservation and Activity termination Initializing the streaming dialog Correct implementation of the media playback service Correct implementation of notifications/notification events BONUS A maximum of an additional 10 points may be obtained by completing any feature that is in required by the assignment. For example, add a seekbar to change the current location of the song that is playing. Similarly, add buttons to skip forward and backward by some number of seconds. Use SharedPreferences to save downloaded file URI and current track play time.

4 EXAMPLE Initial View Song and Artist are unknown, menu displaying streaming and exit options ( Settings option is extra credit)

5 Clicked Stream in menu Dialog displayed for user to enter URL to song Clicking STREAM initializes MyMediaService Song is ready UI updates with song title, artist, and new album art Now Play and Stop buttons are also enabled

6 Song is playing While the song is playing, a notification is displayed of which song is currently played When the MediaPlayer is paused or stopped, you should remove this notification Clicking this notification will reopen the MediaPlayerActivity if it is currently in the background, otherwise it will simply continue playing