A user account is required in order to edit this wiki, but we've had to disable public user registrations due to spam.

To request an account, ask an autoconfirmed user on Chat (such as one of these permanent autoconfirmed members).

Video Metrics: Difference between revisions

From WHATWG Wiki
Jump to navigation Jump to search
(started the page ... not very far yet)
 
(added webkit stats)
Line 1: Line 1:
'''Related HTML WG bug:''' http://www.w3.org/Bugs/Public/show_bug.cgi?id=12399
'''Related HTML WG bug:''' http://www.w3.org/Bugs/Public/show_bug.cgi?id=12399


Line 13: Line 12:
'''Collection of Proposals/Implementations'''
'''Collection of Proposals/Implementations'''


Mozilla have implemented the following statistics into Firefox:
Mozilla have implemented the following [http://blog.pearce.org.nz/2011/03/html5-video-painting-performance.html statistics into Firefox]:


* mozParsedFrames - number of frames that have been demuxed and extracted out of the media.
* mozParsedFrames - number of frames that have been demuxed and extracted out of the media.
Line 20: Line 19:
* mozPaintedFrames - number of frames which were presented to the rendering pipeline and ended up being painted on the screen. Note that if the video is not on screen (e.g. in another tab or scrolled off screen), this counter will not increase.
* mozPaintedFrames - number of frames which were presented to the rendering pipeline and ended up being painted on the screen. Note that if the video is not on screen (e.g. in another tab or scrolled off screen), this counter will not increase.
* mozPaintDelay - the time delay between presenting the last frame and it being painted on screen (approximately).
* mozPaintDelay - the time delay between presenting the last frame and it being painted on screen (approximately).
Webkit have [https://bugs.webkit.org/show_bug.cgi?id=53322 implemented] these:
* webkitAudioBytesDecoded
* webkitVideoBytesDecoded
* webkitDecodedFrames
* webkitDroppedFrames




Line 32: Line 39:
* width: The current width of the video element (already exists).
* width: The current width of the video element (already exists).
* videoWidth: The current width of the videofile (already exists).  
* videoWidth: The current width of the videofile (already exists).  


Further, a requirement to expose playback rate statistics has come out of [http://lists.w3.org/Archives/Public/public-html/2011Feb/0113.html issue-147]:
Further, a requirement to expose playback rate statistics has come out of [http://lists.w3.org/Archives/Public/public-html/2011Feb/0113.html issue-147]:


* currentPlaybackRate: the rate at which the video/audio is currently playing back
* currentPlaybackRate: the rate at which the video/audio is currently playing back

Revision as of 04:31, 31 March 2011

Related HTML WG bug: http://www.w3.org/Bugs/Public/show_bug.cgi?id=12399


Requirements For several reasons, we need to expose the performance of media elements to JavaScript.

One concrete use case is that content publishers want to understand the quality of their content as being played back by their users and how much a user is actually playing back. For example, if a video always goes into buffering mode after 1 min for all users - maybe there is a problem in the encoding, or the video is too big for the typical bandwidth/CPU combination. Also, publishers want to track the metrics of how much of their video and audio files is actually being watched.

A further use case is HTTP adaptive streaming, where an author wants to manually implement an algorithm for switching between different resources of different bandwidth or screen size. For example, if the user goes full screen and the user's machine and bandwidth allow for it, the author might want to switch to a higher resolution video.


Collection of Proposals/Implementations

Mozilla have implemented the following statistics into Firefox:

  • mozParsedFrames - number of frames that have been demuxed and extracted out of the media.
  • mozDecodedFrames - number of frames that have been decoded - converted into YCbCr.
  • mozPresentedFrames - number of frames that have been presented to the rendering pipeline for rendering - were "set as the current image".
  • mozPaintedFrames - number of frames which were presented to the rendering pipeline and ended up being painted on the screen. Note that if the video is not on screen (e.g. in another tab or scrolled off screen), this counter will not increase.
  • mozPaintDelay - the time delay between presenting the last frame and it being painted on screen (approximately).


Webkit have implemented these:

  • webkitAudioBytesDecoded
  • webkitVideoBytesDecoded
  • webkitDecodedFrames
  • webkitDroppedFrames


Previously the following statistics have been proposed for HTTP adaptive streaming:

  • downloadRate: The current server-client bandwidth (read-only).
  • videoBitrate: The current video bitrate (read-only).
  • droppedFrames: The total number of frames dropped for this playback session (read-only).
  • decodedFrames: The total number of frames decoded for this playback session (read-only).
  • height: The current height of the video element (already exists).
  • videoHeight: The current height of the videofile (already exists).
  • width: The current width of the video element (already exists).
  • videoWidth: The current width of the videofile (already exists).


Further, a requirement to expose playback rate statistics has come out of issue-147:

  • currentPlaybackRate: the rate at which the video/audio is currently playing back