Author : Xavier "dascritch" Mouton-Dubosc
Version : 1.1.01
Thank you to my lovely friends
- Thomas Parisot for suggestions
- Loïc Gerbaud for corrections
- Guillaume Lemoine and Phonitive for helping
- Benoît Salles for testing
Informations in french : http://dascritch.net/post/2014/09/03/Timecodehash-%3A-Lier-vers-un-moment-d-un-sonore
This is an hashtag extention for
<audio></video>, permits to do a hotlink or a deeplink.
Link to an hash with a timecode to point the media player to the desired time. The main difference with standard media fragment is to permit external link to your page at a precise moment of your media.
Example page : http://dascritch.github.io/timecodehash/index.html
Blog post to come after August.
First, call the library as usual in your html where you want to address your players :
I personaly prefer in the
<head> section, but it can work at the end of
<body> minimified and collated. It should also work in dynamic injection.
Just link as you usually do to a named anchor, then add
&t= and the timecode you want the player to jump to.
By example, triggering
<a href="page.html#player@100"> will start any playable element of page.html named "player" at the 100th second. The referred page.html should have a call to the library, the referrent doesn't need it.
If you want to change the separator character, you should change the
window.TimecodeHash.separator property after calling the lib.
For the timecode, you can use
- seconds without unit :
- professionnal timecodes as
02:04:02(2 hours, 4 minutes and 2 seconds) :
- human-readable units as in
page.html#player&t=2h4m2sfor the previous example. Sub-units availables :
Note : if a timecode without named anchor is given, as in
href="#@13h37m", the very first
<video> element of the document will be started and placed at this time.
Via the API and only for the API at this time, you can change the separator from
&t= to any accepted unicode character, p.e.
Firefox do large media seeking without any problems. But Chrome is not handling very easily. So TDD tests where switched laterly in async mode and
hashOrder have a callback function to test it properly.
A contrario, Firefox seems doing a refresh loading when I use media frangment.
Copyright (C) 2014 Xavier "dascritch" Mouton-Dubosc
This software is licenced under the GNU General Purpose Licence. Use it and deploy it as you want : i've done too much closed source before.
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.
- September 2014 : 2 , correcting to standard separator
- September 2014 : 1 , public announcing
- July 2014 : 1.a , public release
- June 2014 : 0.2 , proof of concept
- October 2012 : first version, trashed
Repository : https://github.com/dascritch/timecodehash
Keeping in touch :