-

Note: You are currently viewing documentation for Moodle 3.10. Up-to-date documentation for the latest stable version of Moodle may be available here: Videofile.

Videofile: Difference between revisions

From MoodleDocs
m (added IE10 as a working browser for captions)
 
(19 intermediate revisions by 3 users not shown)
Line 1: Line 1:
Videofile is a Moodle 2.5+ resource plugin intended to provide teachers with easy handling of cross-browser compatible videos using [http://www.videojs.com/ Video.js].
{{Infobox plugin
|type = Activity module, videofile
|entry = https://moodle.org/plugins/view.php?plugin=mod_videofile
|tracker = https://github.com/lemonad/moodle-mod_videofile/issues
|discussion = https://moodle.org/plugins/view.php?plugin=mod_videofile
|maintainer = [[User:Jonas Nockert|Jonas Nockert]]
|float = right
}}
Videofile is a Moodle 2.5+ resource plugin intended to provide teachers with easy handling of cross-browser compatible videos using [http://www.videojs.com/ Video.js]. It supports multilanguage captions.


==Use==
==Use==
* In most cases it should be enough to add [http://en.wikipedia.org/wiki/Mp4 .mp4] video files, which will then play in an [http://en.wikipedia.org/wiki/HTML5 html5] player on most browsers and in a [http://en.wikipedia.org/wiki/Flash_player flash player] in older browsers.  
* In most cases it should be enough to add [http://en.wikipedia.org/wiki/Mp4 .mp4] video files, which will then play in an [http://en.wikipedia.org/wiki/HTML5 html5] player on most browsers and in a [http://en.wikipedia.org/wiki/Flash_player flash player] in older browsers.  
* You can add alternative formats in order to be sure it can play regardless of which browser is being used (usually [http://en.wikipedia.org/wiki/Mp4 .mp4], [http://en.wikipedia.org/wiki/.ogv .ogv] and [http://en.wikipedia.org/wiki/.webm .webm] covers it.)
* You can add alternative formats in order to be sure it can play regardless of which browser is being used (usually [http://en.wikipedia.org/wiki/Mp4 .mp4], [http://en.wikipedia.org/wiki/.ogv .ogv] and [http://en.wikipedia.org/wiki/.webm .webm] covers it).
* As of 2013, the most widely supported video format on the web is [http://en.wikipedia.org/wiki/Mp4 .mp4] with the [http://es.wikipedia.org/wiki/H264 h.264] CODEC. It'll play in Flash based media players as well as in [http://en.wikipedia.org/wiki/HTML5 html5] players in iOS and Android.
* There are several good free open source video converters, such as [http://handbrake.fr/ handbrake].
 
==Video Width and Height==
* You are advised to use the native size of your recorded video, or a multiple of its original measurements, keeping the width/height ratio.
* Common video sizes are 640 by 480, 800 by 600, 1024 by 768, ...
* If you set Width and Height in such a way that they do not match the source video width/height ratio, the frame for the video will be padded with grey space (either at the top and bottom or left and right), which does not look nice.
* You can change the video width and height after uploading the video file.
* When the user watches the video, there is an option at the bottom right corner to show it in full screen mode.
 
=== Responsive themes ===
Please check the responsive mode checkbox and the video player will be resized according to the window/screen size. In this mode, the width and height fields are used to specify the video player proportions.


==Captions==
==Captions==
Line 12: Line 32:
===Captions file naming===
===Captions file naming===
* The file names, without extensions, will be used for the video caption option titles.
* The file names, without extensions, will be used for the video caption option titles.
* If the files are named according to [http://en.wikipedia.org/wiki/List_of_ISO_639-2_codes ISO 6392] (e.g. eng.vtt fra.vtt tlh.vtt and swe.vtt) the options will be shown as the corresponding full language names according to the user's language preferences (e.g. English French Klingon and Swedish, assuming the user's preferred language is set to English).
* If the files are named according to [http://en.wikipedia.org/wiki/List_of_ISO_639-2_codes ISO 6392] (e.g. eng.vtt fra.vtt tlh.vtt and swe.vtt) the options will be shown as the corresponding full language names according to the user's language preferences (e.g. English, French, Klingon and Swedish, assuming the user's preferred language is set to English).
* If you include a caption file with a name different from [http://en.wikipedia.org/wiki/List_of_ISO_639-2_codes ISO 6392] (e.g. calo.vtt) , the caption language name will be shown enclosed in double square brackets.  
* If you include a caption file with a name different from [http://en.wikipedia.org/wiki/List_of_ISO_639-2_codes ISO 6392] (e.g. martian.vtt) , the caption language name will be shown enclosed in double square brackets.  


===Captions available===
===Captions available===
Line 21: Line 41:


===Captions not available===
===Captions not available===
* Captions are not available in iPads with iOS6 using Safari.  
* Captions are not available in iPads with iOS6 using Safari.
 
===Example of multilanguage captions files===
This is a very simple English language caption file:
 
[[File:Eng_vtt.png]]
 
This is a very simple Spanish language caption file:
 
[[File:Spa_vtt.png]]
 
This is a very simple Italian language caption file:
 
[[File:Ita_vtt.png]]
 
===Captions file format===
Notice the sintax of all three previous files:
* The firs line must be WEBVTT
* It must be all capital letters
* The next line states the timing for the first caption
* 00:00::01.00 --> 00:00:10.000
* THAT means that the subtitle will start showing at 01 seconds into the video,
* This caption will stay on screen until 10 seconds into the video.
* The next line is the text of the caption to be shown
* A blank line follows
* A  new line with another timing follows
* The next line is the text of the caption to be shown
* A blank line follows
* ...
* The file is plain text
 
You can use a captions editing program
or you can use notepad, wordpad or any word processor
BUT YOU MUST REMEMBER TO SAVE IT AS PLAIN TEXT.


==Poster image==
==Poster image==
Line 28: Line 81:
==Download==
==Download==
You can download this add-on from https://moodle.org/plugins/pluginversions.php?plugin=mod_videofile
You can download this add-on from https://moodle.org/plugins/pluginversions.php?plugin=mod_videofile
==See also==
* [[Video]]
* [[Media_FAQ]]
* [https://moodle.org/mod/forum/discuss.php?d=147891%257C Moodle forum about 'What is a good screen capture program ?']
* [https://moodle.org/mod/forum/discuss.php?d=143478%257C Moodle forum about 'Best video format']


[[Category:Contributed code]]
[[Category:Contributed code]]
[[Category:Language]]
[[Category:Multimedia]]
[[Category:Video]]


[[es:mod/videofile/mod]]
[[es:mod/videofile/mod]]

Latest revision as of 22:46, 31 August 2017

Videofile is a Moodle 2.5+ resource plugin intended to provide teachers with easy handling of cross-browser compatible videos using Video.js. It supports multilanguage captions.

Use

  • In most cases it should be enough to add .mp4 video files, which will then play in an html5 player on most browsers and in a flash player in older browsers.
  • You can add alternative formats in order to be sure it can play regardless of which browser is being used (usually .mp4, .ogv and .webm covers it).
  • As of 2013, the most widely supported video format on the web is .mp4 with the h.264 CODEC. It'll play in Flash based media players as well as in html5 players in iOS and Android.
  • There are several good free open source video converters, such as handbrake.

Video Width and Height

  • You are advised to use the native size of your recorded video, or a multiple of its original measurements, keeping the width/height ratio.
  • Common video sizes are 640 by 480, 800 by 600, 1024 by 768, ...
  • If you set Width and Height in such a way that they do not match the source video width/height ratio, the frame for the video will be padded with grey space (either at the top and bottom or left and right), which does not look nice.
  • You can change the video width and height after uploading the video file.
  • When the user watches the video, there is an option at the bottom right corner to show it in full screen mode.

Responsive themes

Please check the responsive mode checkbox and the video player will be resized according to the window/screen size. In this mode, the width and height fields are used to specify the video player proportions.

Captions

  • Videofile and Video.js also support WebVTT captions.
  • You can add several files in order to provide multilingual captions.
  • You can check the validity of your WebVTT captions with the http://quuz.org/webvtt/ validator created by Anne van Kesteren.

Captions file naming

  • The file names, without extensions, will be used for the video caption option titles.
  • If the files are named according to ISO 6392 (e.g. eng.vtt fra.vtt tlh.vtt and swe.vtt) the options will be shown as the corresponding full language names according to the user's language preferences (e.g. English, French, Klingon and Swedish, assuming the user's preferred language is set to English).
  • If you include a caption file with a name different from ISO 6392 (e.g. martian.vtt) , the caption language name will be shown enclosed in double square brackets.

Captions available

  • Captions work well with the following Windows browsers: Firefox, Chrome, Safari, IE10.
  • Captions work well with the following Mac browsers: Firefox, Chrome, Safari
  • Captions work well in Ubuntu Linux using Firefox.

Captions not available

  • Captions are not available in iPads with iOS6 using Safari.

Example of multilanguage captions files

This is a very simple English language caption file:

Eng vtt.png

This is a very simple Spanish language caption file:

Spa vtt.png

This is a very simple Italian language caption file:

Ita vtt.png

Captions file format

Notice the sintax of all three previous files:

  • The firs line must be WEBVTT
  • It must be all capital letters
  • The next line states the timing for the first caption
  • 00:00::01.00 --> 00:00:10.000
  • THAT means that the subtitle will start showing at 01 seconds into the video,
  • This caption will stay on screen until 10 seconds into the video.
  • The next line is the text of the caption to be shown
  • A blank line follows
  • A new line with another timing follows
  • The next line is the text of the caption to be shown
  • A blank line follows
  • ...
  • The file is plain text

You can use a captions editing program or you can use notepad, wordpad or any word processor BUT YOU MUST REMEMBER TO SAVE IT AS PLAIN TEXT.

Poster image

Videofile and Video.js also support a poster image that displays before the video is started.

Download

You can download this add-on from https://moodle.org/plugins/pluginversions.php?plugin=mod_videofile

See also