Gaia/Music: Difference between revisions

756 bytes added ,  28 October 2013
m
Add a Security Review section
No edit summary
m (Add a Security Review section)
 
(33 intermediate revisions by 9 users not shown)
Line 1: Line 1:
=UX Feature Spec (Draft)=
== Design Specs ==
== Contacts ==
For the latest UX specifications, please visit:  
UX: Patryk Adamczyk, patryk (on IRC)<br>
https://mozilla.box.com/applications
Dev: TBD<br>
 
Eng: TBD<br>
== Requirements ==
== Music Library==
=== Music Library===
===Overview===
====Overview====
At app launch, the user is presented with a library. The library should include the following options:
At app launch, the user is presented with a library. The library should include the following options:
*Playlists
*Playlists
*Podcasts
*Podcasts [P2]
*Audiobooks
*Audiobooks [P2]
Only applies to music files (not the above), filters your music based on metadata (ID3):  
Only applies to music files (not the above), filters your music based on metadata (ID3):  
*Artist
*Artist
*Song
*Song
*Album
*Album
*Genre
*Genre (probably not needed, since this filter is less useful as often artists will vary genres from album to album. Auto tagging in many apps is inconsistent, so you will get numerous similarly named genres that may not represent the actual artist's genre)


===Layout===
====Layout====
The library lists should be visual and typographic.<br>
The library lists should be visual and typographic.<br>
In portrait orientation when the user clicks on any category they should see a list formatted in this manner:<br>
In portrait orientation when the user clicks on any category they should see a list formatted in this manner:<br>
[album art] text based on filter type
[album art] text based on filter type


(Landscape support would be nice to have for v.1)
In landscape orientation, the view should be more visual, more focused on album art. When the user clicks on any category they should see:<br>
In landscape orientation, the view should be more visual, more focused on album art. When the user clicks on any category they should see:<br>
[large album art]<br>
[large album art]<br>
small text based on filter type
small text based on filter type


===Quick Browsing===
====Quick Browsing====
Each browsing list should contain:
Each browsing list should contain:
*Search input field, to search the entire music library
*Search: search entire music library
*Quick index browsing: A-Z column, when the user touchs a letter the list quickly scrolls to that letter in the list
*Index list: Sorted alphabetically, with index component that enables user to jump to letter.
*Inertial scrolling, the fast the user touch scrolls down the page, the quicker the scrolling becomes.
*Back
*Back Button: back 1 level


==Sync==
===Sync===
===Playlist Support===
====Playlist Support====
User can (manually) import (copy) a playlist from popular desktop apps such as iTunes or Windows Media Player.
User can (manually) import (copy) a playlist from popular desktop apps such as iTunes or Windows Media Player.


===Management within the device.===
====Management within the device.====
The user can:
The user can:
*1. organize the tracks in the playlists
*1. create a new playlist, place tracks within this playlist
*2. rate music
*2. organize the tracks in existing playlists
*3. edit the metadata
*3. rate music
*4. the system tracks the quantity of playbacks for each track
Would be nice to have...
*4. edit the metadata
*5. the system tracks the quantity of playbacks for each track


==Playback==
===Playback===
When playing audio files, the player should contain the following:
When playing audio files, the player should contain the following:


===Music Control Buttons:===
====Music Control Buttons:====
*Play / Pause
*Play / Pause
*Skip to Next track
*Skip to Next track
Line 56: Line 58:
*Volume Control (adjusted by touch and hardware volume rocker)
*Volume Control (adjusted by touch and hardware volume rocker)


===Indicators:===
====Indicators:====
*Playback time elapsed
*Playback time elapsed
*Playback time remaining
*Playback time remaining
Line 64: Line 66:
*Album art or default album graphic
*Album art or default album graphic


===Global Navigation:===
====Navigation:====
*Back Button: back 1 level to music library
*Back: to music library
*Album Track List Button
*Album: view album track list
 
 
== Requirements (Apps) ==
 
* Users have the ability to search within application contexts


=== Search ===
* Search music
* Filters
** by Artist
** by Album
** by Song (all)
===System Control during Playback===
Nice to have's:


==System Control during Playback (Indication)==
*Status Bar: “now playing” when music is playing.  
*Status Bar: “now playing” when music is playing.  
*Task Switcher: The music player should be easily accessed through the task switcher, ideally with playback controls (play / pause, skip to next track, skip to previous track)
*Task Switcher: The music player should be easily accessed through the task switcher, ideally with playback controls (play / pause, skip to next track, skip to previous track)
*Lock Screen: The music player should be easily accessed through the task switcher, ideally with playback controls (play / pause, skip to next track, skip to previous track, volume indication / scrubber)
*Lock Screen: The music player should be easily accessed through the task switcher, ideally with playback controls (play / pause, skip to next track, skip to previous track, volume indication / scrubber)
=== Bluetooth file sharing ===
* Ability to share music using Bluetooth file transfer.
== Development ==
[https://github.com/mozilla-b2g/gaia/tree/master/apps/music Source code on Github]
== Security Review ==
The security review of this app can be found [https://wiki.mozilla.org/Security/Reviews/Gaia/Music here].
Confirmed users
152

edits