readme.txt

Libary SDK 9

The players are located in the root flowplayer directory in the distribution package. 
* The player flash components are: FlowPlayer.swf, FlowPlayerWhite.swf, FlowPlayerBlack.swf and FlowPlayerLP.swf
* Sample HTML files + JavaScript for embedding the players are in the examples directory. Open the examples/index.html
  with your browser!
* Extra example files for special cases in the extras folder
  (example suggestion.js, example external configuration file).

Installation
============

To install the player copy html/flashembed.min.js and one of the player SWF files into
your Web server. Only the SWF and flashembed.min.js is required! For further info please
see the installation instruction in our Web site http://flowplayer.org

See html/FlowPlayer.html for a simple example!

FlowPlayer Version history (latest release on top)
=================================================

2.2.1
	Fixes:
	- initialVolumePercentage did not affect the volume level before the slider was touched
	- non-HW full-screen did not scale the video up when the menu was hidden
	- pauses the player before opening the page linked with the clip specific linkUrl variable
	- Fixed SWF viewing
	- The controlBar's playbutton did not work after pressing stop or after rewinding to beginning
	- controlsOverVideo: 'no' was fixed

2.2
    - Added possibility to pause/resume using the space bar
	- Added initialVolumePercentage configuration variable
	- Added getVersion() to the JavaScript API
	- Explicitly returning false from following JavaScript API callback methods will disable
	  the default behavior related to the event:
	  onClipChanged, onClipDone, onLoadBegin, onStartBuffering, onStreamNotFound
	- The clips' "start" property is now supported with lighttpd
	- Added new showEmailView() and showEmbedView() to the JavaScript API
	- Added new onSeek(targetSeconds) to the JavaScript API
	- Changed to use the new Google Analytics pageTracker._trackPageview function to send the stats.
	  To continue using urchinTracker (the deprecated old function) you can configure this using the new
	  googleAnalyticsFunction configuration option. 
	Fixes:
	- The play button is now enabled at the end of the clip when loop: false, autoRewin: false
	- JavaScript API method getIsPlaying() now returns false if the player is paused
	- Looping through adjacent streams now works properly when using a RTMP server. You will need to provide
	  duration information for the clips though. The loop parameter works also as expected.
	- Suggestion thumbnails fell out of alignment if they were of differing widths.
	- There was no sound when video clips don't contain metadata or when using RTMP live streams.
	To fix this, the sound is now muted only when autoPlay: false, autoBuffering: true
	- Volume slider now mutes the volume completely when dragged to the left end.

2.1.3
	New version 0.27 of flashembed.js
	Commercial versions: 
		Added the possibility have a custom Overlay Play Button image. New config option playButtonImageUrl to achieve this.
	Fixes:
	- noVideoClip was not working with playOverlay
	- progress bar was not visible in IE after page refresh
	- Now really stops at first frame when setting autoPlay:false, autoBuffering: false

2.1.2
	- New example.html included, old example files were dropped from the distribution package
	- New version of flashembed.min.js, it has some bugs fixed 
	Fixes:
	- Sometimes the buffering animation was left running in the beginning of videos.
	- Scaling problems fixed. You can use showOnLoadBegin: false in the clips to prevent them from showing before
	they have been scaled properly.

2.1.1
	Fixes:
	- Buffering animation was left visible when pausing and resuming using the control-bar's
	pause/resume button

2.1
	- Hardware Scaled video in full-screen mode
	- New buffering rotation animation
	- New option controlBarGloss
	Fixes:
	- The control bar hiding is now based on mouse move delay, works much better that way
	- Calls onFlowPlayerReady() also when you use the configInject option.
	- Does not show NaN's in the time display when playing MP3 clips with autoPlay: false
	- The stop button behaves correctly for MP3 clips
	- Replay button in the suggestions view fixed
	- Does not produce sound in the beginning of clip when autoPlay: false and autoBuffering: true
	- Now shows the first frame of video when autoPlay: false and autoBuffering: true
	- Fixed: was not possible to set the clip's duration just using the 'end' parameter
	- Does not show the buffering rotation animation at the end of playList

2.0.1
	- Arranges the buttons to the left if the scrubber is not shown (when using showScrubber: false)
	- Does not show the video link in the Embed popup unless videoLink is specified in config
	Fixes:
	- Email sending works now by default, it sends the data to flowplayer.org's email sender
	- Menu bar is now always correctly opened above the control bar
	

2.0
	- Now uses the "native full screen" by default, no need to specify useNativeFullScreen: true to enable it
	- Shows the big play button overlay image by default, new config option 'usePlayOverlay' that can be
	  used to disable it.
	- New button to mute and unmute the sound volume
	- Possibility to show/hide every button and widget in the control bar
	- New overlay play button graphic
	- New rotating buffer animation
	- Added a new callback onFlowPlayerReady() to the JavaScript API.
    - New default skin 'air'
       * New controlsOverVideo config setting
       * new config setting controlBarBackgroundColor (controlAreaBorderColor setting was removed)
	- Removed the loop button (unnecessary)
	- The initial volume level is now 50%
	- The popup menu automatically hides after 10 seconds if not closed by the user.
	- Added new "onPlaybackTime" callback to the JavaScript API. Reports the current time
	  in the video timeline.
	- setting autoPlay: true now starts playing when the 'play' button overlay is used as the first clip
	  in the playList. Setting autoPlay: false will make the player pause on and show the splash.
	- Embed view shows a direct link to the current video file
      * added videoLink config option that can be used to override the default
        that is taken from the playList or the videoFile option
    - Email-a-link functionality:
      * added emailPostUrl config option
      * added emailVideoLink config option
      * added emailDefaultMessage config option (all occurrences of [video_link] tag in the message
        are replaced with the value of emailVideoLink)
	- AdServer functionality:
	  * added following clip specific configuration options: id, keywords
	  * added enableAds, publisherId, adServerUrl, adServerAuth, countryCode config options
	Fixes:
	- autoRewind now rewinds to start and stops if loop is false
	- The initialScale config option works correctly when the controls are hidden using hideControls: true
	- playList support with RTMP streaming servers was broken

1.21.1
	Fixes:
	- FlowPlayer prevented page elements from loading properly when the page was refreshed in IE. Now fixed!
	- setConfig() JavaScript API function is initialized as early as possible to
	  fix some timing issues on IE.
	- does not load the fullscreen.js from flowplayer.org when using the native full screen mode	
	- volume level was reset back to 100% when scrubbing


1.21
	- MP3 playback (following are not supported yet: Protection codes (a.k.a. anti-leeching))
	- Google Analytics support
	- Extensions to the JavaScript API
		- Added the possibility to play a clip via JavaScript
		- Added possibility to set programmatic cue points using JavaScript
		- Added possibility to play a clip having a RTMP url
	- Player initializes without specifying any config. After that you can use the JavaScript API
	  to configure it and play clips.
	- Embed code does not include child configs any more. Only the configuration set by
	  flashVars or injected is included in the embed code configuration.
	- Possibility to supply the embed code in config
	- Possibility to load a page for suggestions instead of just playing them in the same
	  player instance. Done with the linkURL and linkWindow clip specific fields.
	Fixes:
	- Seeking is more accurate so that it seeks exactly where the scrub bar is released
	- You can now seek to the beginning or the end of a video using the scrubber
	- Setting a new config using JavaScript via setConfig() now re-creates the UI so that it properly
	  reflects the new config
	- baseURL was not used if it was specified in a parent config and the playlist was specified in it's child config.
	- does not load the fullscreen.js from flowplayer.org when using the native full screen mode
	- doubleclickin on the "play" overlay at the beginning of a playlist caused the player to pause. Now doubleclicks
	  work the same as single clicks.
	- Fixes to suggestions:
	    - Does not unnecessarily load the suggestion URL several times.
	    - Suggestions loading did not work when using an external config file. Caused the player to initialize over and over.

1.20
	- Suggestions a.k.a. related videos
	- Loading of configuration using RTMP from a streaming server
	- The native full screen ads were removed and replaced by a flowplayer.org logo
	- Added a new clip type 'video' that ensures correct playback for h.264 videos supported
	  by the latest Flash player 3 update codenamed "Moviestar"
	Fixes:
	- RTMP recorded streams were not played to the end
	- Fixed the sample HTML files

1.19
	- Skinning kit
	- Added all dependencies to the source distribution package
	Fixes:
	- videoHeight does not have any effect in full screen mode any more, now resizes to fit the full area
	- configured progress bar, buffering bar etc. colors were ignored

1.18
	- Smoothing of FLV videos (antialiasing of scaled video)
	- Native Flash full screen mode added.
	- The Long Play version (FlowPlayerLP.swf) now resizes to full screen
	- Addes mouse over states to buttons.
	- Added 'overlay' to image clips. Can be used to overlay a play button image on top of another image clip.
	- Addes a built-in Big Play Button overlay.
	- Added new clip specific configuration variable 'liveStream' to specify that the clip is a live stream
	  played from a media server.
	- Changed the background of the video area to be black. Now the player does not show the video (shows the black
	  background instead) before the buffer is filled an the playback starts.
	- Added new clip specific setting 'showOnLoadBegin'. Turn this to false and the video will not be shown
	  before the buffer has been filled and the playback starts.
	- All methods of the JavaScript API are now available in LocalConnection API as well. You can now
	  control FlowPlayer from another Flash movie.
	- By default the loop button is no longer shown. You have to specify showLoopButton: true to make it visible.
	- New maximum play count for clips in the playlist. Controlled with a clip specific 'maxPlayCount' setting.
	Fixes:
	- Progress bar now better seeks to the end of videos.
	- The embed area is centered horizontally also in full screen mode.
	- The time display was corrupted with videos longer than 60 minutes. Now uses a smaller font so that
	the time values fit properly.
	- JS full screen works with external config file
	- Setting showFullScreenButton to False Shortens Progress Bar - now fixed
	- The Long Play version does not redraw the thumbs strip unnecessarily

Older releases in in version number order:

0.9     Initial public release. All basic features are in place.

0.9.1   Added 'autoPlay' variable that can be used to specify whether the
        playback should begin immediately when the player has been loaded into
        the Web browser.

0.9.2   Bug fixes.

0.9.3   Added new 'bufferLength' variable that can be used in the HTML page to
        specify the length of the buffer in seconds when streaming FLV. Fixed a
        bug that prevented playback after an FLV was completely played.

0.9.4   Added a 'baseURL' variable that can be used to specify the location of
        the video file to be loaded by Player.swf. See Player.html for an
        example.

        If the 'videoFile' variable's value contains a '.flv' or '.swf'
        extension, the standalone player (Player.swf) will NOT append this based
        on the detected flash version. If a prefix is not present, the player
        always appends either one of these prefixes.

1.0
	- Displays a "BUFFERING..." text when filling the video buffer.
	- Fixed playback of the start and the end of the video where the player
	  was errorneously cutting off some of the video.
	- Added a new start() function to the FlowPlayer class.
	- Fixed Sample.fla

1.1
    - Added ability to loop; Contains a new toggle button to control looping.