Table of Contents
Designs: https://www.figma.com/file/VJuFJNGaVSwdXF2VWiVuZ4oe/NYPL-SimplyE-mobile?node-id=28%3A3
1a. ANDROID Patron browses audio books in SimplyESimplyE
Description: ANDROID Patron navigates to the catalog and views ebook, audiobooks, or all formats.
...
Main Flow
Step | Actor | Action | Result | Mobile DesignAlternate Flow | Accessibility Notes | ||
---|---|---|---|---|---|---|---|
1 | patron | logs in and navigates to the library catalog |
|
|
| If audiobooks are turned off in the circulation manager for the library, then no entry point will exist for audiobooks. In this case, the facet/header should be hidden. | (Willa will advise if it should say "Format, books" and also display the word format somewhere so that users know what the menu is called.) |
2 | patron | clicks header/facet button to view menu | displays menu with selectable options for:
| ||||
3 | patron | selects "Audiobooks" |
| If no audiobooks are available at a library, then UI presents a message, "Sorry, no audiobooks were found."
| When a user selects a new tab, the focus should stay on that tab (is screen reader user isn't bumped back to top of page) KW: this may not be applicable if we aren't using tabs? When a user selects a new format, once the new books load that is announced to a user of a screen reader. Chat about best approach. | ||
selects "Audiobooks" |
| If no audiobooks are available at a library, then UI presents a message, "Sorry, no audiobooks were found."
| When a user selects a new tab, the focus should stay on that tab (is screen reader user isn't bumped back to top of page) KW: this may not be applicable if we aren't using tabs? WA Note: the focus should stay on the selected segment. – same principle of not moving focus unnecessarily. When a user selects a new format, once the new books load that is announced to a user of a screen reader. Chat about best approach. |
Description: Patron borrows an audiobook
Main Flow
Step | Actor | Action | Result | iOS Design | Android DesignAlternate Flow | Accessibility | |||||
---|---|---|---|---|---|---|---|---|---|---|---|
1 | patron | Browses or searches for an audio book | Patron searches for an audiobook (see alternate flow for borrowing from details page): Audio books display in search results with:
Screenreader should:
| Patron navigates to the details page:
| |||||||
2 | patron | clicks 'Get' |
| 2 | patron | clicks 'Get' |
(From a User perspective flow should be identical to (From a User perspective flow should be identical to borrowing ebooks.)
| For a screen reader user, the focus should stay on the same part of the page once they hit "get" or "reserve" button. After they hit either of those buttons, the focus stays on the loading area and the state is communicated, ex. "Requesting". Once the book is reserved or checked out and the buttons change, the focus should stay on the new "Read" button. It should also be announced the number of days that the user has until the book is returned.
| Patron clicks 'Get' from the details page:
For screenreaders: The focus should stay on the area of the selected book. It should announce a loading message, like "Requesting". Then when the request has been put through, the updated text should be announced, which will be "Title, author, buttons." The buttons will either be "Remove" if the book has been reserved or "Listen" button and "Return" button if the book has been checked out If patron borrows from the details page:
If wifi drops, show inactive/loading version of the listen button. | There are issues in focus movement when user actives download. Download progress needs to be announced to users of screenreaders. Screenreader users need to be notified when Download is complete. Text display needs to include format. | |
3 | patron | views 'my books' page after borrowing an audio book | Borrowed audiobooks display:
| Text display needs to include format. |
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 DesignAlternate 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:
|
6. 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 DesignAlternate Flow | Accessibility | |||||
---|---|---|---|---|---|---|---|---|---|---|---|
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 booksthe book should not begin playing automatically. | this will be replaced by design | Audio cannot play automatically. Violated WCAG. Users should be able to adjust volume of audiobook independent of system volume. | ||||||
2 | patron | taps 'Play' button | System plays audio book System displays:
|
| Stream/download fails (is this the step in which it will fail?) | fail?) | |||||
3 | patron | drags scrubber bar while audio is PLAYING |
| 3 | patron | drags scrubber bar | The audio plays accordingly and the playhead displays the location appropriately | while audio is PAUSED All behavior described in the main flow should work the same except that the player should not begin playing again until user taps "Play" button. | Functionality needs to work for screenreader with feedback on where user is. If moving the scrubber causes audiobook to read very quickly at corresponding place in audio, that may present conflict with screenreader so need to discuss. | ||
4 | patron | taps 'pause' |
| ||||||||
skips forward or backward while | |||||||||||
Need to discuss this interaction with scrubber bar. | |||||||||||
75 | 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? | ??? |
7. Patron uses Table of Contents
Description: Patron uses that table of contents (TOC) in an audiobook
Main Flow
Step | Actor | Action | Result | iOS Design | Android Design | Alternate Flow | Accessibility |
---|---|---|---|---|---|---|---|
1 | patron | taps 'Listen' for an audio book they have borrowed | System displays audio player with:
|
| Is the cover image being used to convey the author info? This should be conveyed as alt but presents an issue for patrons with low vision and/or color blindness. | ||
2 | patron | taps Table of Contents icon | System displays:
Note: Chapters still downloading can't be selected
| How is this announced to screen readers, all apiece? Ie "Forward 24 minutes 12 seconds" The indication of the current chapter needs to be communicated to screen readers. The downloading icons/whatever that grey circle is both need to have alts for screenreaders. | |||
3 | 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? | Audio should not play automatically. |
8. Patron adjusts sleep and speed settings on audiobooks 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
Step | Actor | Action | Result | iOS Design | Android Design | Alternate Flow | Accessibility | |||
---|---|---|---|---|---|---|---|---|---|---|
1 | patron | taps 'Listen' for an audio book they have borrowed | System displays audio player with:
| Is the cover image being used to convey the author info? This should be conveyed as alt but presents an issue for patrons with low vision and/or color blindness. | ||||||
2 | patron | taps speed setting icon | System displays:
Note: UI will be as per iOS and Android players | The placeholder mockup is depending on context of the list items and color to communicate which menu this is. I would prefer if the sleep icon was not shown, to reduce possible confusion. What is this going to be like for a screen reader? What's the order of the page? | ||||||
3 | patron | selects different speed setting |
| |||||||
4 | 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. | Current setting needs to be indicated to screen reader. See notes in speed menu section about styling. | ||||||
5 | patron | selects different sleep setting |
| |||||||
6 | patron | listens until sleep timer goes off |
|
| There are a couple accessibility threads we need to confirm for this. |
Open Questions
Question | Related to | Asked by | Responses | |
---|---|---|---|---|
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. | Mark | Kim: Looking at how Overdrive/Libby does this. If I stop playing the book before it is downloaded I get a "download paused," message. Seems like we should do something similar. Here is a screenshot of how Libby displays a paused download. Will ask Jack to weigh in on this. Mark: It looks as though that screenshot is from something analogous to our "book detail view" in the SimplyE catalog section. If so, then that definitely does imply that `AudioBookType` instances exist outside of the player activity; if they didn't, then there'd be no way to display the current download status in the catalog. | |
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. | Mark | ||
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? | Use Case 1a & 1b | Mark | |
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. | Mark | ||
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? | Mark |
Out of Scope Items
- 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, including accessibility requirements.
- After launching 3.0, test whether users expect to see last tab selected when they view catalog.
...