Tools & Guidelines
ccPlayer New Features (AS3 version)

Previous | Next | ccPlayer Help Contents | ccPlayer Home

v2.1.1

Additional keystroke recognition

The following keystrokes are now mapped to match those used in other commonly used video players, while maintaining accessibility features previously built into ccPlayer:

• space bar - play/pause
• arrow right - jump playhead forward
• arrow left - jump playhead backward
• arrow up - volume up
• arrow down - volume down

ccExitFS parameter

The ccExitFS parameter instructs ccPlayer to return to normal view when the end of the media is reached while in fullscreen view.

End-of-media-reached function call for Javascript

Added the method setEndMethod which can be called by Javascript to provide ccPlayer with a function to call when the end of the media is reached. This method also contains a second parameter which can be used to indicate whether ccPlayer should leave the fullscreen view if active when the end of the media is reached.

SWF playback end-of-media bug fixed

Fixed a bug with the SWF playback feature where the end-of-media event was not triggered when the end of the swf animation was reached.

Base-color bug fix

Fixed a bug where the color of the default volume controls was not changed when the ccBaseColor parameter was used.

Removed overlay for blocked controls

Removed the overlay that was appearing over the controls when the ccBlockControls parameter was set to 'true'. This was done in order to allow activation of any buttons that do not advance or rewind the media, such as play and pause, volume up and down, and captions on and off.

Temporary fix for a fullscreen-display bug

When ccMediaRewind is set to 'true' and the end of the media is reached, ccPlayer will go back to the beginning of the video and display the poster image for restart. However, when viewing the media in fullscreen, the poster previously did not appear unless the controls were in view and it would appear in its normal size. The temporary fix that has been implemented is that the poster image and poster play button will be hidden if the end of media is reached while in fullscreen view.

v2.1.0

Javascript can be used to control ccPlayer's functionality

Much of the key functionality of ccPlayer has been opened up to access through Javascript. This feature makes it possible to do such things as have controls for the player in HTML, or have ccPlayer react to dynamic changes in the HTML content. Using Javascript to Interact With ccPlayer provides more detailed instructions on how to set up ccPlayer and access its public methods.

Animated swfs can now be played in ccPlayer with captions

This version of ccPlayer is able to load and play back animated, linear swfs, along with their captions, which are stored in an external caption file. A new parameter ccAnimFrameRate has been provided in order to tell ccPlayer how many frames per second to play the loaded swf.

Because the CCforFlash captioning component (used in ccPlayer) reads time-based captions, it is important that the timecodes for the captions are determined based on the desired playback speed (frame rate) of the swf. More information can be found in the Authoring Captions for Flash section.

Adjustments to background colors

Three parameters have been added to change the background colors of various areas of ccPlayer:

• ccMediaBackgroundColor – changes the color of the background in the media area
• ccControlBackgroundColor – changes the color of the background in the controls
• ccCaptBackgroundColor – changes the color of the background in the caption area

Adjusting the left and right side padding in the caption area

The parameter ccCaptAreaPadding has been added to provide the means of adjusting the padding on the left and right side of the caption area.

Adjusting the format of the display of timecodes in the controls

The format of the three timecode displays in the controls (current time, time left, and duration) can now be adjusted using the following parameters:

• ccTimeDisplayFormat – sets the format of the time displays. Possible values are hh:mm:ss, h:mm:ss, mm:ss, m:ss, and :ss
• ccTimeNoLeadingZeros – if true, suppresses the display of any leading zeros in the time areas

New version of the CCforFlash caption component maintains synchronization with SoundChannel objects

A new version of the CCforFlash captioning component (v1.0.2) is being used in ccPlayer. Prior to this version, ccPlayer used CCforFlash's manual mode for displaying captions of MP3 audio files. Now, CCforFlash can use the same caption synchronization method to display captions for both MP3 and video content.

Loading an external controls swf from another server

A new parameter, ccAllowDomain, has been provided in order to identify any domain where a swf containing external controls might be stored, if it is different than the one hosting the ccPlayer swf. This will allow the buttons inside the controls to access ccPlayer's function and parameters.

Loading an MP3 file from another server

The parameter ccPolicyFile has been added to indicate whether to look for a policy file (true) when loading MP3 files that are located on a server that is different than the one hosting the ccPlayer swf.

Fixed the overall security error handling in ccPlayer

Custom Controls – If custom controls are being retrieved from a different server and Flash cannot find a valid crossdomain.xml policy file, ccPlayer will no longer crash. It will use the default controls.

MP3 Audio Playback – If Flash cannot find a valid crossdomain.xml policy file when loading an MP3 file, ccPlayer will no longer crash. It will play back the MP3 file, but will not display metadata, such as the title of the audio.

Bug fixes

The following bugs were fixed:

• The mp3 playback no longer waits for the file to be fully loaded before starting playback.
• The play button now appears when the end of the media is reached and ccMediaRewind is set to false.
• Shortcut key recognition will not be re-enabled after controls are loaded when disableShortcutKeys() is run prior to loading the controls.
• Disabled a background graphic in the screen-reader instructions that was being found in inspect32, but not read by JAWS.
• Added trace messages to indicate when a media file or a media streaming server cannot be found.

v2.0.2

Scrub bar button bug fix

PLEASE NOTE: THIS FIX BREAKS CUSTOMIZED CONTROLS USED WITH THE PREVIOUS VERSION OF CCPLAYERAS3 (VERSION 2.0.1).

This fix impacts all controls used with ccPlayerAS3. In order to ensure the forward and reverse buttons which may be embedded inside the scrub bar button (see Special scrub bar accessibility feature; search the page for "special scrub bar accessibility feature") are read by screen reading software, it is necessary to add an additional button inside. This is necessary for all controls, even if the forward and reverse buttons are not included.

All of the controls, which are included in the package for this version of ccPlayerAS3, have been modified with the new object that is needed for the scrub bar button to work. In order to fix custom controls used with the previous version of ccPlayerAS3 (version 2.0.1), see Creating ccPlayer Customized Controls, Scrub bar; search the page for "Scrub bar - optional".

Video playback display size changed

This version of the player changes the way the video size is determined, giving priority to the ccMediaWidth and ccMediaHeight parameters. In the previous versions (1.0.1 and 2.0.1) of ccPlayerAS3, if the video height was smaller than the height given by ccMediaHeight, the height of the player was reduced when the video was loaded. In this version, if the video is smaller then the dimensions given, the video will be centered in the media display area.

ccScaleVideo parameter

The ccScaleVideo has been added to identify whether the video should be scaled to fit the dimensions of the values given in the ccMediaWidth and ccMediaHeight parameters. When the value of this parameter is true and the video size is different than what was specified in the above parameters, the video will either shrink or expand to fit the area, maintaining the aspect ratio of the video.

Video remains in fullscreen view when playback is completed

In prior versions of ccPlayerAS3, if the user had selected fullscreen view and the end of the video was reached, the view would default to normal view. With this version, the player remains in fullscreen view. This allows for seamless fullscreen playback, when ccPlayerAS3 is embedded within another swf and multiple videos are played consecutively.

New methods added for embedding ccPlayerAS3 in another swf

The following methods have been added to the player for use when it is embedded in another swf:

• setNewMediaSize(width, height) – used to change the size of the media display area.
• setStreamingServer(server) – used to identify the streaming server, when video is being streamed from a Flash media server.
• activateRollupCaptionDisplay(lines) – used to switch the caption display from pop-on to roll-up.
• activatePoponCaptionDisplay() – used to switch the caption display from roll-up to pop-on.

Bug fixes

The following bugs were fixed:

• Scrub bar button no longer moves past the end of the scrub bar area.
• The over state of a custom poster image button no longer flashes when ccPlayerAS3 is loaded.
• The player no longer throws an error if the customized controls do not contain the timeArea movieclip and the view is switched to fullscreen.
• The player no longer stops playback when jumpToTimeSeconds() is used to try to jump to a time in the video that is not currently loaded.
• Modified the initial playback of video streamed from a media server to ensure the onMetaData event is triggered.

v2.0.1

MP3 audio playback

This version of the player will playback MP3 audio files, along with Flash video (flv) and H264 (mp4). Using the ccAudioImage parameter, an image can be specific which is displayed in the media area.

Changes in some parameter names

Any parameters with the word “Video” have been updated with “Media” which reflects that both video and audio media content can be played through the player. Legacy parameters with the "Video" name will continue to be recognized in this version.

Streaming parameters change

In order to separate the streaming name from the full url to streaming content, ccMediaStream is used to indicate the stream, while ccMediaName is used to identify the path to media file.

Base color setting

The color of the windows, tooltips, and progress bar can be changed using the ccBaseColor parameter.

Customized controls

An external swf can be imported with customized controls for the player. The new parameter is ccPlayerControls. Due the way the customized controls are implemented, all of the accessibility features of the player are maintained. It is also possible to use ccPlayer without controls, however, users will no longer be able to access the keyboard shortcuts.

Special accessibility features for the scrub bar

ccPlayer has added two accessibility features that help keyboard and screen-reader users scrub or jump to various points in the media. When the focus is on the scrub bar button, by tabbing to it, the keyboard user can press the comma key (,) to scrub backwards in the media and the period key (.) to scrub forwards in the media.

When customized controls are used, the forward and reverse buttons can be incorporated into the scrub bar, so they are not visible unless the user has tabbed to the scrub bar button. This is useful in situations where there may not be enough room in the controls to house the regular forward and reverse buttons.

Accessible forward and reverse buttons included in scrub bar button

When using custom controls, it might be necessary to minimize the number of buttons in the control area. However, the forward and reverse buttons are needed for keyboard and screen-reader users, who are not able to use drag feature of the scrub bar. Instead, these buttons can be placed inside the scrub bar button, so they become available only when the scrub bar button has focus; otherwise, they are hidden. See Creating ccPlayer Customized Controls for more information.

Time remaining option added to customized controls

Customize controls have the option of displaying any combination of the three time properties: time remaining, current time and media duration.

Dimensions are flexible

In the previous version of the player, only the height of the player was flexible. In this version both the height and width are flexible. The height of the player is determined by the height of the media being displayed, plus the caption area (when captions are provided) and the control area. The width of the player is either the width of the media or the width of the controls, whichever is larger. If the control area width is smaller than the media, the controls are centered and the control area background is expanded to reach the edges.

Media is not loaded until play is selected or media is set to autostart

In order to eliminate unnecessary server requests, when ccPlayer is not set to autostart, the media is no longer loaded until play is started by the user.

Fullscreen view modified

The layout of the fullscreen view has been modified so the media has more room to fit in the monitor's display. The captions continue to appear over the bottom of the media. If there is room for the controls underneath the media, they are placed there. If the media fills the bottom of the screen, the controls slide up from the bottom when they are needed. When this happends, the caption area is also raised, so the controls do not appear on top of the captions.

Fullscreen controls disappear when inactive

In the fullscreen view, the controls are faded out of view after a period of inactivity. When the mouse is moved (for some browsers and earlier versions of Flash Player, a mouse click is needed) the controls are faded back into view. If the media fills the bottom of the screen, the controls slide up and down as they are faded in and out of view.

Can be embedded in another SWF

This version of the player can be embedded and played inside other swfs.

Embedded ccPlayer can be modified on the fly

New public methods have been included for starting new media and changing the controls on the fly, so the player can be used as the root media player in a chapterized Flash-based media environment. To assist with playlist playback, ccPlayer provides an event that is broadcast when the current media has completed playing.

Maintains fullscreen view when embedded in a SWF

When ccPlayer switches to fullscreen view while it is embedded inside another swf, it determines where it is in the hierarchy of all the possible parent holders and adjusts its position to maintain the full media view.

Clickable scrub bar

Users can now click on any area of the scrub bar and have the media jump to that position in time. If the media has not loaded to that point, nothing happens.

Rewind options

The ccMediaRewind parameter has been added to control whether the media should be returned to the beginning once playback is complete (true).

Controls blocked

The controls can be blocked using the ccBlockControls, so they are visible with a slightly transparent covering, but inactive. This parameter is helpful when ccPlayer is included in another swf which controls a playlist.

v1.0.1

Conversion to ActionScript 3

This is the first version of the ccPlayer built in AS3.

CCforFlashAS3 component updated

ccPlayer has been updated with the current 1.0.1 version of the CCforFlashAS3 component.

Streaming videos

ccPlayer can playback videos being streamed from an ActionScript 3 Flash Media Server (FMS).

Larger video viewing area

The video region of ccPlayer has been expanded to a maximum height and width of 480px by 360px.

Vertical resizing

When ccPlayer detects a video height smaller than its maximum height, it will resize itself vertically. This is done after receiving the height and the width of the video from the video's metadata. In order to prevent visible resizing of the player when its parent HTML page is launched, two new parameters ccVideoHeight and ccVideoWidth can be used to preset the size of the video region.

ccRewind

The default action of ccPlayer is to stop when the end of the video is reached. The new ccVideoRewind parameter can be used to indicate that ccPlayer should return the playhead to the beginning of the video when the end is reached (ccVideoRewind=true).

ccPosterImage

ccPlayer can load an external image to use as the poster image in the player.

ccCaptSourceType defaults to 'external'

The default value of ccCaptSourceType is now external. This means external caption files can be identified using just the ccCaptionSource parameter.

Previous | Next | ccPlayer Help Contents | ccPlayer Home

Last updated: February 28, 2012