changed git call from https to git readonly
[atutor.git] / mods / atutor_opencaps / flowplayer / README.txt
1 Version history:
2
3 3.2.2
4 -----
5 Fixes:
6 - Now recognizes following kind of urls as audio clips: 'mp3:audiostreamname' (ulrs with mp3 prefix and no extension)
7 - Now ignores the duration from metadata if we already got one. Fix required for pseudostreaming
8 - Fix to reuse buffered data when replaying a clip
9
10 3.2.1
11 ---------
12 - Support for RTMP redirects (tested with Wowza loadbalancing)
13 - Fixed video size when no size info available in clip metadata
14
15 Fixes:
16 - Fix to correctly detect if the player SWF name contains a version number and if it does also use the version number
17 when it automatically loads the controls plugin.
18
19 3.2.0
20 -----
21 - canvas, controlbar and the content plugin backgound color and border color can be now given with rgb() and rgba() CSS style syntax
22 - Added onMouseOver() and onMouseOut() listener registration methods to the Flowplayer API
23 - enhancements to RSS playlist. Converted parsing to E4X, yahoo media and flowplayer namespace support. 
24 - added feature to obtain bitrate and dimension information to a new clip custom property "bitrates" for future support for bitrate choosing. 
25 - added getter for playerSwfName config
26 - if clip.url has the string "mp3:" in it, the clip.type will report 'audio'
27 - added setKeyboardShortcutsEnabled(), addKeyListener(), removeKeyListener() to FlowplayerBase
28 Fixes:
29 - onSeek() was not fired when seeking while paused and when using RTMP. An extra onStart was fired too.
30 - fireErrorExternal() was not working properly with an error PlayerEvent
31 - countPlugins() was throwing an error when a plugin was not found
32 - external swf files were not scaled properly
33 - the logo was unnecessary shown when going fullscreen if logo.displayTime was being used
34 - added a loadPluginWithConfig method to FlowplayerBase, accessible from javascript. Fixed double onload callback call.
35 - now handles cuepoint parameters injected using the Adobe Media Encoder
36 - showPlugin was not working when config.play was null
37 - handles 3-part duration values included in FLV metadata, like "500.123.123"
38 - player wasn't always reaching end of video
39 - fixed broken buffering: false
40 - fixed event dispatching when embedding flowplayer without flowplayer.js (=without playlist config field)
41 - fixed safari crashes when unloading player
42 - fixed scrubber behaviour with a playlist containing 2 images (or swf) in a row
43 - fixed errors in logs when using an RSS playlist
44 - fixed OverlayPlayButton that was showing even if it shouldn't on some cases
45 - fixed wrong behavior when onBeforeFinish was returning false within playlists
46 - /!\ Don't use the fadeIn / fadeOut controlbar's API while using autoHide.
47 - fixed play state button with images
48 - fixed splash image flickering
49
50 3.1.5
51 -----
52 Fixes:
53 - The player went to a locked state when resuming playback after a period that was long enought to send the
54 netConnection to an invalid state. Now when resuming playback on an invalid connection the clip starts again from
55 the beginning. This is only when using RTMP connections and does not affect progressive download playback.
56 - Custom netConnect and netStream events did not pass the info object to JS listeners
57
58 3.1.4
59 -----
60 Fixes:
61 - player did not initialize if the controlbar plugin was disabled and if the play button overlay was disabled with play: null
62 - works properly without cachebusting on IE
63 - RSS playlist parsing now respects the isDefault attribute used in mRSS media group items
64 - Fixed passing of connection arguments
65
66 3.1.3
67 -----
68 - enhancements to RSS playlist parsing: Now skips all media:content that have unsupported types. Now the type attribute
69 of the media:content element is mandatory and has to be present in the RSS file
70 - Possibility to pass a RSS file name with playFeed("playlist.rss") and setPlaylist("playlist.rss") calls.
71 - changes to the ConnectionProvider and URLResolver APIs
72 - Now automatically uses a plugin that is called 'rtmp' for all clips that have the rtmp-protocol in their URLs.
73 - Added possibility to specify all clip properties in an RSS playlist
74
75 Fixes:
76 - the result of URL resolvers in now cached, and the resolvers will not be used again when a clip is replayed
77 - some style properties like 'backgroundGradient' had no effect in config
78 - video goes tiny on Firefox: http://flowplayer.org/forum/8/23226
79 - RSS playlists: The 'type' attribute value 'audio/mp3' in the media:content element caused an error.
80 - Dispatches onMetadata() if an URL resolver changes the clip URL (changes to a different file)
81 - error codes and error message were not properly passed to onEvent JS listeners
82
83 3.1.2
84 -----
85 - The domain of the logo url must the same domain from where the player SWF is loaded from.
86 - Fullscreen can be toggled by doublclick on the video area.
87 Fixes:
88 - Player was not initialized correctly when instream playlists were used and the provider used in the instream clips was defined in the common clip.
89 - A separator in the Context Menu made the callbacks in the following menu items out of order. Related forum post: http://flowplayer.org/forum/8/22541
90 - the width and height settings of a logo were ignored if the logo was a sWF file
91 - volume control and mute/unmute were not working after an instream clip had been played
92 - now possible to use RTMP for mp3 files
93 - Issue 12: cuepointMultiplier was undefined in the clip object set to JS event listeners
94 - Issue 14: onBeforeStop was unnecessarily fired when calling setPlaylist() and the player was not playing,
95             additionally onStop was never fired even if onBeforeStop was
96 - fixed screen vertical placement problems that reappeared with 3.1.1
97 - The rotating animation now has the same size and position as it has after initialized
98
99 3.1.1
100 -----
101 - External configuration files
102 - Instream playback
103 - Added toggleFullscreen() the API
104 - Possibility to specify controls configuration in clips
105 - Seek target position is now sent in the onBeforeSeek event
106 Fixes:
107 - The screen size was initially too small on Firefox (Mac)
108 - Did not persist a zero volume value: http://www.flowplayer.org/forum/8/18413
109
110 3.1.0
111 -----
112 New features:
113 - clip's can have urlResolvers and connectionProviders
114 - Added new configuration options 'connectionCallbacks' and 'streamCallbacks'. Both accept an Array of event names as a value.
115   When these events get fired on the connection or stream object, corresponding Clip events will be fired by the player.
116   This can be used for example when firing custom events from RTMP server apps
117 - Added new clip event types: 'onConnectionEvent' and 'onStreamEvent' these get fired when the predefined events happen on the connection and stream objects.
118 - Added Security.allowDomain() to allow loaded plugins to script the player
119 - Added addClip(clip, index) to the API, index is optional
120 - Possibility to view videos without metadata, using clip.metaData: false
121 - Now the player's preloader uses the rotating animation instead of a percent text to indicate the progress
122   of loading the player SWF. You can disable the aninamtion by setting buffering: false
123 - calling close() now does not send the onStop event
124 - Clip's custom properties are now present in the root of the clip argument in all clip events that are sent to JS.
125
126 Bug fixes:
127 - The preloader sometimes failed to initialize the player
128 - Allow seeking while in buffering state: http://flowplayer.org/forum/8/16505
129 - Replay of a RTMP stream was failing after the connection had expired
130 - Security error when clicking on the screen if there is an image in the playlist loaded from a foreign domain
131 - loadPlugin() was not working
132 - now fullscreen works with Flash versions older than 9.0.115, in versions that do not support hardware scaling
133 - replaying a RTMP stream with an image in front of the stream in the playlist was not working (video stayed hidden). Happened
134   because the server does not send metadata if replaying the same stream.
135 - the scrubber is disabled if the clip is not seekable in the first frame: http://flowplayer.org/forum/8/16526
136   By default if the clip has one of following extensions (the typical flash video extensions) it is seekable
137   in the first frame: 'f4b', 'f4p', 'f4v', 'flv'. Added new clip property seekableOnBegin that can be used to override the default.  
138
139 3.0.6
140 -----
141 - added possibility to associate a linkUrl and linkWindow to the canvas
142 Fixes:
143 - fix for entering fullscreen for Flash versions that don't support the hardware scaled fullscreen-mode
144 - when showing images the duration tracking starts only after the image has been completely loaded: http://flowplayer.org/forum/2/15301
145 - fix for verifying license keys for domains that have more than 4 labels in them
146 - if plugin loading failis because of a IO error, the plugin will be discarded and the player initialization continues:
147
148 3.0.4
149 -----
150 - The "play" pseudo-plugin now supports fadeIn(), fadeOut(), showPlugin(), hidePlugin() and
151   additionally you can configure it like this:
152   // make only the play button invisible (buffering animation is still used)
153   play: { display: 'none' }
154   // disable the play button and the buffering animation
155   play: null
156   // disable the buffering animation
157   buffering: null 
158 - Added possibility to seek when in the buffering state: http://flowplayer.org/forum/3/13896
159 - Added copyright notices and other GPL required entries to the user interface
160
161 Fixes:
162 - clip urls were not resolved correctly if the HTML page URL had a query string starting with a question mark (http://flowplayer.org/forum/8/14016#post-14016)
163 - Fixed context menu for with IE (commercial version)
164 - a cuepoint at time zero was fired several times
165 - screen is now arranged correctly even when only bottom or top is defined for it in the configuration
166 - Fixed context menu for with IE (commercial version)
167 - a cuepoint at time zero was fired several times
168 - screen is now arranged correctly even when only bottom or top is defined for it in the configuration
169 - Now possible to call play() in an onError handler: http://flowplayer.org/forum/8/12939
170 - Does not throw an error if the player cannot persist the volume on the client computer: http://flowplayer.org/forum/8/13286#post-13495
171 - Triggering fullscreen does not pause the player in IE
172 - The play button overlay no longer has a gap between it's pieces when a label is used: http://flowplayer.org/forum/8/14250
173 - clip.update() JS call now resets the duration
174 - a label configured for the play button overlay did not work in the commercial version
175
176 3.0.3
177 -----
178 - fixed cuepoint firing: Does not skip cuepoints any more
179 - Plugins can now be loaded from a different domain to the flowplayer.swf
180 - Specifying a clip to play by just using the 'clip' node in the configuration was not working, a playlist definition was required. This is now fixed.
181 - Fixed: A playlist with different providers caused the onMetadata event to fire events with metadata from the previous clip in the playlist. Occurred when moving in the playlist with next() and prev()
182 - the opacity setting now works with the logo
183 - fadeOut() call to the "screen" plugin was sending the listenerId and pluginName arguments in wrong order
184 - stop(), pause(), resume(), close() no longer return the flowplayer object to JS
185 - changing the size of the screen in a onFullscreen listener now always works, there was a bug that caused this to fail occasionally
186 - fixed using arbitrary SWFs as plugins
187 - the API method setPlaylist() no longer starts playing if autoPlay: true, neither it starts buffering if autoBuffering: true
188 - the API method play() now accepts an array of clip objects as an argument, the playlist is replaced with the specified clips and playback starts from the 1st clip
189
190 3.0.2
191 -----
192 - setting play: null now works again
193 - pressing the play again button overlay does not open a linkUrl associated with a clip
194 - now displays a live feed even when the RTMP server does not send any metadata and the onStart method is not therefore dispatched
195 - added onMetaData clip event
196 - fixed 'orig' scaling: the player went to 'fit' scaling after coming back from fullscreen. This is now fixed and the original dimensions are preserved in non-fullscreen mode.
197 - cuepoint times are now given in milliseconds, the firing precision is 100 ms. All cuepoint times are rounded to the nearest 100 ms value (for example 1120 rounds to 1100) 
198 - backgroundGradient was drawn over the background image in the canvas and in the content and controlbar plugins. Now it's drawn below the image.
199 - added cuepointMultiplier property to clips. This can be used to multiply the time values read from cuepoint metadata embedded into video files.
200 - the player's framerate was increased to 24 FPS, makes all animations smoother
201
202 3.0.1
203 -----
204 - Fixed negative cuepoints from common clip. Now these are properly propagated to the clips in playlist.
205 - buffering animation is now the same size as the play button overlay
206 - commercial version now supports license keys that allows the use of subdomains
207 - error messages are now automatically hidden after a 4 second delay. They are also hidden when a new clips
208   starts playing (when onBeforeBegin is fired)
209 - added possibility to disable the buffering animation like so: buffering: false
210 - pressing the play button overlay does not open a linkUrl associated with a clip
211 - license key verification failed if a port number was used in the URL (like in this url: http://mydomain.com:8080/video.html)
212 - added audio support, clip has a new "image" property
213 - workaround for missing "NetStream.Play.Start" notfication that was happending with Red5. Because of this issue the video was not shown.
214 - commercial version has the possibility to change the zIndex of the logo
215
216 3.0.0
217 -----
218 - Removed security errors that happened when loading images from foreign domains (domains other than the domain of the core SWF).
219   Using a backgroundImage on canvas, in the content plugin, and for the controls is also possible to be loaded
220   from a foreign domain - BUT backgroundRepeat cannot be used for foreign images.
221 - Now allows the embedding HTML to script the player even if the player is loaded from another domain.
222 - Added a 'live' property to Clips, used for live streams.
223 - A player embedded to a foreign domain now loads images, css files and other resources from the domain where the palyer SWF was loaded from. This is to generate shorter embed-codes.
224 - Added linkUrl and linkWindow properties to the logo, in commercial version you can set these to point to a linked page. The linked page gets opened
225   when the logo is clicked.  Possible values for linkWindow:
226     * "_self" specifies the current frame in the current window.
227     * "_blank" specifies a new window.
228     * "_parent" specifies the parent of the current frame.
229     * "_top" specifies the top-level frame in the current window.
230 - Added linkUrl and linkWindow properties to clips. The linked page is opened when the video are is clicked and the corresponding clip has a linkUrl specified.
231 - Made the play button overlay and the "Play again" button slightly bigger.
232
233 RC4
234 ---
235 - Now shows a "Play again" button at the end of the video/playlist
236 - Commercial version shows a Flowplayer logo if invalidKey was supplied, but the otherwise the player works
237 - setting play: null in configuration will disable the play button overlay
238 - setting opacity for "play" also sets it for the buffering animation
239 - Fixed firing of cuepoints too early. Cuepoint firing is now based on stream time and does not rely on timers
240 - added onXMPData event listener
241 - Should not stop playback too early before the clip is really completed
242 - The START event is now delayed so that the metadata is available when the event is fired, METADATA event was removed,
243   new event BEGIN that is dispatched when the playback has been successfully started. Metadata is not normally
244   available when BEGIN is fired. 
245
246 RC3
247 ---
248 - stopBuffering() now dispatches the onStop event first if the player is playing/paused/buffering at the time of calling it
249 - fixed detection of images based on file extensions
250 - fixed some issues with having images in the playlist
251 - made it possible to autoBuffer next video while showing an image (image without a duration)
252
253 RC2
254 ---
255 - fixed: setting the screen height in configuration did not have any effect
256
257 RC1
258 -----
259 - better error message if plugin loading fails, shows the URL used
260 - validates our redesigned multidomain license key correctly
261 - fix to prevent the play button going visible when the onBufferEmpty event occurs
262 - the commercial swf now correctly loads the controls using version information
263 - fixed: the play button overlay became invisible with long fadeOutSpeeds
264
265 beta6
266 -----
267 - removed the onFirstFramePause event
268 - playing a clip for the second time caused a doubled sound
269 - pausing on first frame did not work on some FLV files
270
271 beta5
272 -----
273 - logo only uses percentage scaling if it's a SWF file (there is ".swf" in it's url)
274 - context menu now correctly builds up from string entries in configuration
275 -always closes the previous connection before starting a new clip
276
277 beta4
278 -----
279 - now it's possible to load a plugin into the panel without specifying any position/dimensions
280  information, the plugin is placed to left: "50%", top: "50%" and using the plugin DisplayObject's width & height
281 - The Flowplayer API was not fully initialized when onLoad was invoked on Flash plugins
282
283 beta3
284 -----
285 - tweaking logo placement
286 - "play" did not show up after repeated pause/resume
287 - player now loads the latest controls SWF version, right now the latest SWF is called 'flowplayer.controls-3.0.0-beta2.swf'
288
289 beta2
290 -----
291 - fixed support for RTMP stream groups
292 - changed to loop through available fonts in order to find a suitable font also in IE
293 - Preloader was broken on IE: When the player SWf was in browser's cache it did not initialize properly
294 - Context menu now correctly handles menu items that are configured by their string labels only (not using json objects)
295 - fixed custom logo positioning (was moved to the left edge of screen in fullscreen)
296 - "play" now always follows the position and size of the screen
297 - video was stretched below the controls in fullscreen when autoHide: 'never'
298 - logo now takes 6.5% of the screen height, width is scaled so that the aspect ratio is preserved
299
300 beta1
301 -----
302 - First public beta release