move code up one directory
[atutor.git] / mods / _standard / flowplayer / README.txt
1 Version history:
2
3 3.1.2
4 -----
5 - The domain of the logo url must the same domain from where the player SWF is loaded from.
6 - Fullscreen can be toggled by doublclick on the video area.
7 Fixes:
8 - Player was not initialized correctly when instream playlists were used and the provider used in the instream clips was defined in the common clip.
9 - 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
10 - the width and height settings of a logo were ignored if the logo was a sWF file
11 - volume control and mute/unmute were not working after an instream clip had been played
12 - now possible to use RTMP for mp3 files
13 - Issue 12: cuepointMultiplier was undefined in the clip object set to JS event listeners
14 - Issue 14: onBeforeStop was unnecessarily fired when calling setPlaylist() and the player was not playing,
15             additionally onStop was never fired even if onBeforeStop was
16 - fixed screen vertical placement problems that reappeared with 3.1.1
17 - The rotating animation now has the same size and position as it has after initialized
18
19 3.1.1
20 -----
21 - External configuration files
22 - Instream playback
23 - Added toggleFullscreen() the API
24 - Possibility to specify controls configuration in clips
25 - Seek target position is now sent in the onBeforeSeek event
26 Fixes:
27 - The screen size was initially too small on Firefox (Mac)
28 - Did not persist a zero volume value: http://www.flowplayer.org/forum/8/18413
29
30 3.1.0
31 -----
32 New features:
33 - clip's can have urlResolvers and connectionProviders
34 - Added new configuration options 'connectionCallbacks' and 'streamCallbacks'. Both accept an Array of event names as a value.
35   When these events get fired on the connection or stream object, corresponding Clip events will be fired by the player.
36   This can be used for example when firing custom events from RTMP server apps
37 - Added new clip event types: 'onConnectionEvent' and 'onStreamEvent' these get fired when the predefined events happen on the connection and stream objects.
38 - Added Security.allowDomain() to allow loaded plugins to script the player
39 - Added addClip(clip, index) to the API, index is optional
40 - Possibility to view videos without metadata, using clip.metaData: false
41 - Now the player's preloader uses the rotating animation instead of a percent text to indicate the progress
42   of loading the player SWF. You can disable the aninamtion by setting buffering: false
43 - calling close() now does not send the onStop event
44 - Clip's custom properties are now present in the root of the clip argument in all clip events that are sent to JS.
45
46 Bug fixes:
47 - The preloader sometimes failed to initialize the player
48 - Allow seeking while in buffering state: http://flowplayer.org/forum/8/16505
49 - Replay of a RTMP stream was failing after the connection had expired
50 - Security error when clicking on the screen if there is an image in the playlist loaded from a foreign domain
51 - loadPlugin() was not working
52 - now fullscreen works with Flash versions older than 9.0.115, in versions that do not support hardware scaling
53 - replaying a RTMP stream with an image in front of the stream in the playlist was not working (video stayed hidden). Happened
54   because the server does not send metadata if replaying the same stream.
55 - the scrubber is disabled if the clip is not seekable in the first frame: http://flowplayer.org/forum/8/16526
56   By default if the clip has one of following extensions (the typical flash video extensions) it is seekable
57   in the first frame: 'f4b', 'f4p', 'f4v', 'flv'. Added new clip property seekableOnBegin that can be used to override the default.  
58
59 3.0.6
60 -----
61 - added possibility to associate a linkUrl and linkWindow to the canvas
62 Fixes:
63 - fix for entering fullscreen for Flash versions that don't support the hardware scaled fullscreen-mode
64 - when showing images the duration tracking starts only after the image has been completely loaded: http://flowplayer.org/forum/2/15301
65 - fix for verifying license keys for domains that have more than 4 labels in them
66 - if plugin loading failis because of a IO error, the plugin will be discarded and the player initialization continues:
67
68 3.0.4
69 -----
70 - The "play" pseudo-plugin now supports fadeIn(), fadeOut(), showPlugin(), hidePlugin() and
71   additionally you can configure it like this:
72   // make only the play button invisible (buffering animation is still used)
73   play: { display: 'none' }
74   // disable the play button and the buffering animation
75   play: null
76   // disable the buffering animation
77   buffering: null 
78 - Added possibility to seek when in the buffering state: http://flowplayer.org/forum/3/13896
79 - Added copyright notices and other GPL required entries to the user interface
80
81 Fixes:
82 - 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)
83 - Fixed context menu for with IE (commercial version)
84 - a cuepoint at time zero was fired several times
85 - screen is now arranged correctly even when only bottom or top is defined for it in the configuration
86 - Fixed context menu for with IE (commercial version)
87 - a cuepoint at time zero was fired several times
88 - screen is now arranged correctly even when only bottom or top is defined for it in the configuration
89 - Now possible to call play() in an onError handler: http://flowplayer.org/forum/8/12939
90 - Does not throw an error if the player cannot persist the volume on the client computer: http://flowplayer.org/forum/8/13286#post-13495
91 - Triggering fullscreen does not pause the player in IE
92 - The play button overlay no longer has a gap between it's pieces when a label is used: http://flowplayer.org/forum/8/14250
93 - clip.update() JS call now resets the duration
94 - a label configured for the play button overlay did not work in the commercial version
95
96 3.0.3
97 -----
98 - fixed cuepoint firing: Does not skip cuepoints any more
99 - Plugins can now be loaded from a different domain to the flowplayer.swf
100 - 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.
101 - 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()
102 - the opacity setting now works with the logo
103 - fadeOut() call to the "screen" plugin was sending the listenerId and pluginName arguments in wrong order
104 - stop(), pause(), resume(), close() no longer return the flowplayer object to JS
105 - changing the size of the screen in a onFullscreen listener now always works, there was a bug that caused this to fail occasionally
106 - fixed using arbitrary SWFs as plugins
107 - the API method setPlaylist() no longer starts playing if autoPlay: true, neither it starts buffering if autoBuffering: true
108 - 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
109
110 3.0.2
111 -----
112 - setting play: null now works again
113 - pressing the play again button overlay does not open a linkUrl associated with a clip
114 - now displays a live feed even when the RTMP server does not send any metadata and the onStart method is not therefore dispatched
115 - added onMetaData clip event
116 - 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.
117 - 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) 
118 - backgroundGradient was drawn over the background image in the canvas and in the content and controlbar plugins. Now it's drawn below the image.
119 - added cuepointMultiplier property to clips. This can be used to multiply the time values read from cuepoint metadata embedded into video files.
120 - the player's framerate was increased to 24 FPS, makes all animations smoother
121
122 3.0.1
123 -----
124 - Fixed negative cuepoints from common clip. Now these are properly propagated to the clips in playlist.
125 - buffering animation is now the same size as the play button overlay
126 - commercial version now supports license keys that allows the use of subdomains
127 - error messages are now automatically hidden after a 4 second delay. They are also hidden when a new clips
128   starts playing (when onBeforeBegin is fired)
129 - added possibility to disable the buffering animation like so: buffering: false
130 - pressing the play button overlay does not open a linkUrl associated with a clip
131 - license key verification failed if a port number was used in the URL (like in this url: http://mydomain.com:8080/video.html)
132 - added audio support, clip has a new "image" property
133 - workaround for missing "NetStream.Play.Start" notfication that was happending with Red5. Because of this issue the video was not shown.
134 - commercial version has the possibility to change the zIndex of the logo
135
136 3.0.0
137 -----
138 - Removed security errors that happened when loading images from foreign domains (domains other than the domain of the core SWF).
139   Using a backgroundImage on canvas, in the content plugin, and for the controls is also possible to be loaded
140   from a foreign domain - BUT backgroundRepeat cannot be used for foreign images.
141 - Now allows the embedding HTML to script the player even if the player is loaded from another domain.
142 - Added a 'live' property to Clips, used for live streams.
143 - 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.
144 - 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
145   when the logo is clicked.  Possible values for linkWindow:
146     * "_self" specifies the current frame in the current window.
147     * "_blank" specifies a new window.
148     * "_parent" specifies the parent of the current frame.
149     * "_top" specifies the top-level frame in the current window.
150 - 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.
151 - Made the play button overlay and the "Play again" button slightly bigger.
152
153 RC4
154 ---
155 - Now shows a "Play again" button at the end of the video/playlist
156 - Commercial version shows a Flowplayer logo if invalidKey was supplied, but the otherwise the player works
157 - setting play: null in configuration will disable the play button overlay
158 - setting opacity for "play" also sets it for the buffering animation
159 - Fixed firing of cuepoints too early. Cuepoint firing is now based on stream time and does not rely on timers
160 - added onXMPData event listener
161 - Should not stop playback too early before the clip is really completed
162 - The START event is now delayed so that the metadata is available when the event is fired, METADATA event was removed,
163   new event BEGIN that is dispatched when the playback has been successfully started. Metadata is not normally
164   available when BEGIN is fired. 
165
166 RC3
167 ---
168 - stopBuffering() now dispatches the onStop event first if the player is playing/paused/buffering at the time of calling it
169 - fixed detection of images based on file extensions
170 - fixed some issues with having images in the playlist
171 - made it possible to autoBuffer next video while showing an image (image without a duration)
172
173 RC2
174 ---
175 - fixed: setting the screen height in configuration did not have any effect
176
177 RC1
178 -----
179 - better error message if plugin loading fails, shows the URL used
180 - validates our redesigned multidomain license key correctly
181 - fix to prevent the play button going visible when the onBufferEmpty event occurs
182 - the commercial swf now correctly loads the controls using version information
183 - fixed: the play button overlay became invisible with long fadeOutSpeeds
184
185 beta6
186 -----
187 - removed the onFirstFramePause event
188 - playing a clip for the second time caused a doubled sound
189 - pausing on first frame did not work on some FLV files
190
191 beta5
192 -----
193 - logo only uses percentage scaling if it's a SWF file (there is ".swf" in it's url)
194 - context menu now correctly builds up from string entries in configuration
195 -always closes the previous connection before starting a new clip
196
197 beta4
198 -----
199 - now it's possible to load a plugin into the panel without specifying any position/dimensions
200  information, the plugin is placed to left: "50%", top: "50%" and using the plugin DisplayObject's width & height
201 - The Flowplayer API was not fully initialized when onLoad was invoked on Flash plugins
202
203 beta3
204 -----
205 - tweaking logo placement
206 - "play" did not show up after repeated pause/resume
207 - player now loads the latest controls SWF version, right now the latest SWF is called 'flowplayer.controls-3.0.0-beta2.swf'
208
209 beta2
210 -----
211 - fixed support for RTMP stream groups
212 - changed to loop through available fonts in order to find a suitable font also in IE
213 - Preloader was broken on IE: When the player SWf was in browser's cache it did not initialize properly
214 - Context menu now correctly handles menu items that are configured by their string labels only (not using json objects)
215 - fixed custom logo positioning (was moved to the left edge of screen in fullscreen)
216 - "play" now always follows the position and size of the screen
217 - video was stretched below the controls in fullscreen when autoHide: 'never'
218 - logo now takes 6.5% of the screen height, width is scaled so that the aspect ratio is preserved
219
220 beta1
221 -----
222 - First public beta release