Music Specification
The Music application is used to manage and play various types of music
files. The available files are listed using the Qtopia document model.
The music is categorized and information about the files is displayed.
Features
Supported Formats
Music supports a range of audio formats including:
- MP2 & MP3
- WAV (PCM GSM)
- AMR
Scanning for Music Documents
Scanning for music files incrementally searches the following locations:
- Directories returned by QPEApplication::documentDir()
- All mounted file systems returned by Storage::fileSystems() where the
file system is for a removable media device (for example SD cards, CF cards)
As the scanning takes place, a percentage progress indicator displays the
estimated completion of the document scanning, since it may take some time for large music collections.
It is possible to filter the list of files as it is being generated. This filtering is carried out by user specified category.
Re-scanning takes place when the program is notified of document changes.
Events that cause an update of the listed files include:
- Another application or process changing a property of an existing document.
- When a document is added or removed.
- When a removable storage card is inserted or removed and the corresponding
filesystem is mounted or unmounted. The application relists the files that
are now available due to the change in removable media.
Music Documents List
The following features are required:
- Sorting: it is possible to alphabetically sort the list of music files.
- Up/Down: it is possible for the user to reorder the list of files. It is expected that this will be possible using the directional keypad.
- Category: it is possible to select files and add them to a Category.
- Add to Category: it is possible for the user to create a new category and
for them to sort the music into different 'collections' using the
categories. This allows playlists to be created.
- The user is able to add files to a category as well as switch to a different category view.
- Properties: it is possible to display and edit the properties of an
individual music file. The following properties are available for editing:
- Document name
- Categories
- ID3 tags (where applicable)
- When available the media codec information including codec, bitrate etc is also displayed.
Playing Music Files
It is possible to select a music file from the list and play the file without
the music application already having been launched. When the file is played,
the appropriate decoder plugin will be found and initialized. The
music application then displays the user interface to control the playback of the file.
It is possible to install different decoder plugins on the device and for the player to detect them.
Music files are also played when selected
from the documents list of the Qtopia Launcher. When launched from the documents
list the player UI is displayed immediately, and the scanning for documents is avoided.
Playback Options
When a music file is selected and played the user is able to perform the following operations:
- Pause: halt the playback at the current position.
- Resume: continue playback at the current position.
- Fast forward / Rewind: move the slider or press the forward or backward buttons to move the position in the file to a position earlier or later in the track.
- Previous / Next track: skip to a previous or later track allowing movement forwards and backwards through the list of tracks.
- Looping: allows the same track to be repeatedly played.
- Hide: hide the application during playback. This allows other applications to be used while listening to music.
- Volume: adjustable while playing music. There is also an option to mute the sound.
Playback Keypad Support
For phones with keypads, there is a mapping of hardware keys to player actions.
During playback of a track the following mappings will be used:
- Key-Up: to increase the volume.
- Key-Down: to decrease the volume.
- Key-Select: to Pause/Resume.
- Key-Left: if held for greater than a few hundred milliseconds, it seeks forward through the track, otherwise if it is not held it skips to and plays the next track.
- Key-Right: if held, the player seeks backwards through the track, else if the button is tapped it plays the previous track.
Playback Status
When a music file is played the following information is displayed (if available):
- The name of the track
- Track duration
- Current position in the track
Copyright © 2005 Trolltech
| Trademarks
| Qtopia version 2.2.0
|