Brightcove is making a major investment in extending our platform. As part of this effort, we have made significant changes to the Player API. The primary goals of the changes in Brightcove 3.2 are to:
The changes in the Player APIs have resulted in the deprecation of a number of objects, methods, and events in the Player API. But don't panic! Brightcove is committed to keeping existing players up and running for the long haul; if your AS3 player works now, it will continue to work despite these API changes. However, the Player API SWC will not contain deprecated methods and you are strongly encouraged to avoid using the deprecated objects, methods, and events in your future development.
For complete reference information about the Brightcove Player API, see the Player API Reference. If you need reference information for the previous version of the Brightcove Player API, including the deprecated methods and events, see the Brightcove 3.1 Player API Reference.
In the new Player API methods, the principal data objects in the Player API have been replaced by superclass objects:
The changes in the Player APIs have resulted in the deprecation of a group of methods in the Player API Content Module. Methods that formerly handled videos and playlists now handle the new MediaDTO and MediaCollectionDTO objects, and the methods have corresponding name changes. For example, getVideoAsynch has been deprecated in favor of getMediaAsynch. Here is a list of the deprecated methods and the new methods you should use instead:
| Deprecated | Use this instead |
|---|---|
| getAllPlaylistIDs | getAllMediaCollectionIDs |
| getAllPlaylists | getAllMediaCollections |
| getVideo | getMedia |
| getVideoAsynch | getMediaAsynch |
| getPlaylist | getMediaCollection |
| getPlaylistAsynch | getMediaCollectionAsynch |
Brightcove has deprecated the events formerly dispatched by the VideoPlayer and VideoDisplay components (though these deprecated events will still available to ensure backwards compatibility). Instead, Brightcove provides new MediaEvents. The MediaEvents have been put in place to provide consistency in the event behavior of progressive download and streaming content. For more information, see Player API MediaEvents.