Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Media Overlays] Add media:paused-class #428

Open
GoogleCodeExporter opened this issue Mar 24, 2015 · 11 comments
Open

[Media Overlays] Add media:paused-class #428

GoogleCodeExporter opened this issue Mar 24, 2015 · 11 comments
Labels
Spec-EPUB3 The issue affects the core EPUB 3.3 Recommendation Status-Deferred The issue has been deferred to another revision Status-NeedsImplementorFeedback The working group requires more information from implementers before being able to decide on Topic-MediaOverlays The issue affects media overlays

Comments

@GoogleCodeExporter
Copy link

I would propose to add a "media:paused-class" to the Media Overlays 
specification, specifically Sections 3.4 and 3.5.2.

This author-defined "media:paused-class" would behave similarly to 
"media:active-class", except it would be applied to the current EPUB Content 
Document element when the MO playback is put into "paused" state by the user, 
and removed when the playback is resumed (or stopped).

The rationale is simple: this addition will give the EPUB Document Author a way 
to style the current element in two different ways, depending on whether the MO 
playback is "active/playing" or "paused". For example, the "active-class" might 
apply a solid underline to the corresponding text, while the "paused-class" a 
dotted underline.

For reference, the proposed behavior is implemented in Menestrello ( 
https://readbeyond.it/menestrello/ ).

Original issue reported on code.google.com by [email protected] on 22 Dec 2013 at 5:50

@GoogleCodeExporter
Copy link
Author

Alberto, thanks for suggestion and implementation pointers. This will 
definitely be considered in the next EPUB revision. 

Original comment by [email protected] on 15 Jan 2014 at 2:21

  • Changed state: Accepted
  • Added labels: Spec-MediaOverlays

@GoogleCodeExporter
Copy link
Author

Given the existing naming convention for "media:playback-active-class" (which 
applies to the 'html' element) and "media:active-class" (for any highlighted 
element), would it make sense to pair "media:paused-class" with 
"media:playback-paused-class" so that the document element's styling can also 
be differentiated? (stop != paused state) I think this can be quite useful.

http://www.idpf.org/epub/301/spec/epub-mediaoverlays.html#sec-docs-assoc-style

Original comment by daniel.weck on 11 Mar 2015 at 12:02

@GoogleCodeExporter
Copy link
Author

If you are suggesting to add _both_

"media:paused-class"

and

"media:playback-paused-class",

I agree the latter might be useful for the author of the publication, it brings 
a pleasant symmetry in the universe, and it is relatively easy to implement, as 
it is similar to the already existing "media:playback-active-class".

Still, I would also like authors be able to use "media:paused-class" and 
"media:playback-paused-class" independently one from the other (e.g., omitting 
one of the two), similarly to "media:active-class" and 
"media:playback-active-class".

=== === ===

PS: the URL for Menestrello is now: http://www.readbeyond.it/menestrello/

Original comment by [email protected] on 11 Mar 2015 at 8:21

@pettarin
Copy link

Bumping this up, since I would like to have this included in EPUB 3.1.

@mattgarrish mattgarrish modified the milestone: EPUB 3.1 Nov 3, 2015
@pettarin
Copy link

pettarin commented Feb 8, 2016

@danielweck @TzviyaSiegman Not seeing this addressed in the current EPUB 3.1 draft.

@danielweck
Copy link
Member

@marisademeglio what do you think?
Most reading systems have a "play/pause" toggle button, but no "stop" button. The "stopped" state would only be set indirectly, for example when opening the EPUB for the first time, or when user-pausing and then user-switching to another spine item (basically, whenever the "resume" position is anything other than the last played location).
In the specification, we need normative prose to describe the distinction between the "stopped" and "paused" playback states, in relation to the existing media:playback-active-class (on the 'html' element) and media:active-class (on the highlighted element). The proposal is to add corresponding media:playback-paused-class and media:paused-class, respectively. This would allow authors to define visual styles specifically for the "paused" state (e.g. CSS highlighting of the location from which playback will resume).
http://www.idpf.org/epub/301/spec/epub-mediaoverlays.html#sec-docs-assoc-style
@pettarin thoughts welcome too :)

@pettarin
Copy link

pettarin commented Feb 8, 2016

I still am in favor of adding both media:playback-paused-class and media:paused-class, both as optional, like the current active counterparts.

@mattgarrish
Copy link
Member

On a procedural note, the first editor's draft is intended to solicit feedback on the more drastic changes proposed so far; it is not feature complete. Issue tracker items, feature requests, and other items lower on the totem are still on the radar, but the working group has been clearing off the major drivers of the workplan first.

@marisademeglio
Copy link
Contributor

The "paused" state that you describe ("it was playing and then i paused it, and i haven't navigated away") vs "it was never playing" is a different user experience that should have its own styling options. Adding these two new classes, and making their usage optional (both, neither, or something in between) makes sense to me.

@mattgarrish
Copy link
Member

The working group reviewed this issue on the June 22 call and decided to defer. Questions were raised about the ability to standardize within the remaining timeline.

@mattgarrish mattgarrish added the Status-Deferred The issue has been deferred to another revision label Jul 9, 2016
@mattgarrish mattgarrish removed this from the EPUB 3.1 milestone Jul 9, 2016
@dauwhe dauwhe added the Agenda+ Issues that should be discussed during the next working group call. label Feb 24, 2021
@iherman
Copy link
Member

iherman commented Mar 5, 2021

The issue was discussed in a meeting on 2021-03-04

List of resolutions:

View the transcript

4. [Media Overlays] Add media:paused-class

See github issue #428.

Brady Duga: this was a way to style content when MO playback is paused

Marisa DeMeglio: so, you'd be playing MO and an element would be highlighted, and then you would pause, and the style of that element would change to whatever is defined by media:paused

Wendy Reid: e.g. the highlight could change to an underline

Brady Duga: so right now, when you pause, what happens when you pause?

Marisa DeMeglio: we don't say what should happen

Brady Duga: so this would make behaviour clearer

Wendy Reid: this is something that RSes might already have found a behaviour for...

Marisa DeMeglio: I think different RSes do their own thing
… from an implementation point of view, if you don't address this, then the styling will just stay even when the MO playback is paused
… could this open up a can of worms?

Wendy Reid: most RSes that implement MO also implement a standard style
… that overwrites what the content says

Brady Duga: we don't do that, we just go with whatever style the content says to apply for MO playback

Marisa DeMeglio: i'm trying to think of what impact this has on synched media where we do highlighting in a pretty different way

Wendy Reid: could we just defer this to synched media?

Marisa DeMeglio: synced media already has a pretty long list of deferred things

Brady Duga: one thing to consider is that if we do add this, existing content would be absolutely okay
… and then if new content begins to use this feature, it's fairly easy to implement

Marisa DeMeglio: a player can also do this without it formally being in spec, but its just that author wouldn't be able to pick the style

Dave Cramer: who filed the original issue?

Matthew Chan: all now referring to posts in the issue

Dave Cramer: i think we should ask around to see if people are actually interested in using this feature

Proposed resolution: Explore implementation of a media:paused class in EPUB 3.3 (Wendy Reid)

Brady Duga: +1

Matthew Chan: +1

Matt Garrish: +1

Toshiaki Koike: +1

Wendy Reid: +1

Masakazu Kitahara: +1

Resolution #4: Explore implementation of a media:paused class in EPUB 3.3

@mattgarrish mattgarrish removed the Status-Deferred The issue has been deferred to another revision label Mar 9, 2021
@dauwhe dauwhe removed the Agenda+ Issues that should be discussed during the next working group call. label Apr 15, 2021
@dauwhe dauwhe added Status-NeedsDiscussion The issue requires further discussion in the working group Status-NeedsImplementorFeedback The working group requires more information from implementers before being able to decide on labels Apr 30, 2021
@wareid wareid added the Status-ProposeClosing The issue is no longer relevant, or has already been fixed, and should be closed. label Sep 15, 2021
@wareid wareid added Status-Deferred The issue has been deferred to another revision and removed Status-NeedsDiscussion The issue requires further discussion in the working group Status-ProposeClosing The issue is no longer relevant, or has already been fixed, and should be closed. labels Oct 20, 2021
@mattgarrish mattgarrish added the Spec-EPUB3 The issue affects the core EPUB 3.3 Recommendation label Sep 14, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Spec-EPUB3 The issue affects the core EPUB 3.3 Recommendation Status-Deferred The issue has been deferred to another revision Status-NeedsImplementorFeedback The working group requires more information from implementers before being able to decide on Topic-MediaOverlays The issue affects media overlays
Projects
None yet
Development

No branches or pull requests

8 participants