...
Description: Patron borrows an audio book
Actor: Patron
Preconditions: Patron logs in with an active library account and navigates to an audio book they have not yet borrowed
Postconditions: Patron successfully borrows audio book
Main Flow
Step | Actor | Action | Result | iOS Design | Android Design | Alternate Flow |
|---|---|---|---|---|---|---|
| 1 | patron | Browses or searches for an audio book | Audio books display in search results with:
| |||
| 2 | patron | clicks 'Get' |
(From a User perspective flow should be identical to borrowing ebooks.) | If wifi drops, show inactive/loading version of the listen button. Supporting the web app is out of scope for the October release, but for a later release: need to implement an alternate flow for the web app. so that it displays a message to go to SimplyE to listen. This would be the same downloading most ebooks. Need a design. | ||
| 3 | patron | views 'my books' page after borrowing an audio book | Borrowed audiobooks display:
Question for UX: does this page display like the "All" tab with both ebooks and audiobooks shown and icons indicating content type? or is there a tabbed interface in my books? |
Description: Patron views details page for an audiobook
Actor: Patron
Preconditions: Patron logs in with an active library account and navigates to an audio book details page
Postconditions: Details page displays
Main Flow
Step | Actor | Action | Result | iOS Design | Android Design | Alternate Flow |
|---|---|---|---|---|---|---|
| 1 | patron | clicks on a title that has NOT been borrowed or reserved | System displays details page for an audiobook:
| |||
| 1 | patron | clicks on the title to view 'Details' page for an audiobook that IS borrowed OR reserved | System displays details page for a borrowed audiobook:
|  | *What happens if the connection is lost? or if the download is lost? Jack will give us a download state on the player view. |
2c. Patron reserves an audio book in SimplyE
Description: Patron reserves an audio book
Actor: Patron
Preconditions: Patron logs in with an active library account and navigates to an audio book that is not available for borrowing, but is available to be reserved.
Postconditions: Patron successfully reserves audio book and views reservation in "Reservations"
Main Flow
Step | Actor | Action | Result | iOS Design | Android Design | Alternate Flow |
|---|---|---|---|---|---|---|
| 1 | patron | views an audio book that is available to be reserved | Audio books displays with
| |||
| 2 | patron | clicks 'Reserve' | System reserves book System displays 'Remove' button | |||
| 3 | patron | views 'Reservations' page after reserving an audio book | Reserved audio books display:
|
3. Patron listens to an audio book in SimplyE
Description: Patron listens to the audio book they have borrowed
Actor: Patron
Preconditions: Patron has borrowed an audio book
Postconditions: audio book plays on patron's device
Main Flow
Step | Actor | Action | Result | iOS Design | Android Design | Alternate Flow |
|---|---|---|---|---|---|---|
| 1 | patron | taps 'Listen' | System displays audio player with:
Note: user must tap the play button to begin playing book. UX feedback is that the book should not begin playing automatically. Might want to use the same styling for the progress bar for both e-books and audio books. |  | ||
| 2 | patron | taps 'Play' button | System plays audio book System displays:
| |||
| 3 | patron | drags scrubber bar | The audio plays accordingly and the playhead displays the location appropriately | |||
| 4 | patron | taps 'pause' |
| |||
| 5 | patron | navigates away from the player | when patron gets a phone call, or starts using another app, behavior should be as it is for any app, but need to describe it here. When audio is playing and user navigates away from the player to another page within the app, a mini player can be shown so that user can continue listening while browsing another content. (UI TBD) |
| ||
| skips forward or backward | Question: A skip feature is described in the acceptance criteria, but is not shown in the designs. Is this a feature that we will offer? |
4. Patron adjusts settings on audio books in SimplyE
Description: Patron adjusts the settings on an audio book
Actor: Patron
Preconditions: Patron has borrowed an audio book
Postconditions: Settings for speed, sleep, device are adjusted
Main Flow
*These are placeholder designs. The player functionality in the app will determine UI.
Step | Actor | Action | Result | iOS Design | Android Design | Alternate Flow |
|---|---|---|---|---|---|---|
| 2 | patron | taps 'Listen' for an audio book they have borrowed | System displays audio player with:
|  |  | |
| 3 | patron | taps speed setting icon | System displays:
Note: UI will be as per iOS and Android players |  | ||
| 4 | patron | selects different speed setting |
| |||
| 5 | patron | taps Table of Contents icon | System displays:
Note: Chapters still downloading can't be selected
|  | ||
| 6 | patron | selects a different chapter/track from the TOC menu |
Question: should the chapter begin playing as soon as it is selected or does the listener have to click the "play" button? | |||
| 7 | patron | taps 'Sleep' icon | System displays:
Note: UI will be as per iOS and Android players Out of scope for initial release: Would be nice to be able to turn off the timer if user changes their mind (or can't go to sleep and wants to listen longer) Out of scope for initial release: Would be nice to display the sleep timer on the UI when it is active. |  | ||
| 8 | patron | selects different sleep setting |
| |||
| 9 | patron | listens until sleep timer goes off |
|  |
|
Open Questions
1. If the user opens an audio book player, opens the table of contents, starts one or more parts downloading, closes the table of contents, closes the player... Are the parts still downloading? If the parts are downloading, this implies that there are one or more instances of the `AudioBookType` that is living somewhere globally in the app, independently of any particular activity, and that parts of the app can get references to them to control them.
2. If book parts are allowed to continue downloading in the background, how is error reporting actually implemented? Do we just pop up a dialog box anywhere the user happens to be, whenever a book part publishes an error event? That's awkward to implement on Android.
3. How do we implement tabs in the catalog? Last time i looked, the catalog was activity based instead of fragment based... How does this work with tabs?
4. The requirements talk about being able to "close" the player view and still have the book playing, possibly with a small player view that appears in the catalog. How can this be achieved? If the player instance (not the view) is instantiated in an activity (and the activity "owns" the player), then we lose the reference to that player instance when the activity is closed. References to players are not serializable and can't be passed between activities.
5. When the user borrows an audio book, it's necessary to fetch the book manifest so that an `AudioBookType` instance can be instantiated from it. When exactly is this manifest fetched? Manifests appear to be able to expire (Findaway books in particular have session IDs), so fetching them eagerly and saving them to disk might not be a good idea. Are manifests saved on disk?