| Version 7 (modified by paul, 2 years ago) (diff) |
|---|
TracNav
Project
Dev Corner (restricted)
- Register for Access
- Download Latest Releases
- Browse Source Code
- Accessing Subversion
- Release Archive
- Report an Issue
Support
Other Resources
What's New? (Release Candidate 2 - December 29 2010)
The following versions have been issued as "release candidates".
- OVA for AS3 v0.6.0 (build 40)
- OVA for JW Player 4 v0.5.0 (build 31)
- OVA for JW Player 5 v0.5.0 (build 54)
- OVA for Flowplayer v0.6.0 (build 42)
The following changes are in this release:
- VAST 2 wrapper support
- VPAID 1.1 Linear Ad support (JW only. Flowplayer support will be in the next RC along with non-linear VPAID support)
- An ability to configure a "Skip Ad" button
- Dramatically simplified configuration for pre-roll only setups
- Support for the specification of 'fail-over' ad servers
- The OVA for AS3 SWC has been renamed to 'ova-as3-<version>.swc'
- Deferred loading of ads via the 'delayAdRequestUntilPlay' option
- A "cache-buster" parameter is now added to the end of wrapped VAST ad requests as per the VAST 2 spec
- Finer grain control when disabling the control bar during linear ad playback
- Support added for "page-url" dynamic ad tag variable
- Several ad server examples added:
- Telemetry - VAST 1 and 2 VPAID Linear examples
- AdForm - VAST 2 Linear
- TidalTV - VAST 2 VPAID
- Lightningcast - VAST 1 Linear
- Smartclip - VAST 1 Linear
- Spotxchange - VAST 2 Linear
- Show clips can now have the duration forcible set via a shows "setDurationFromMetaData" config option
- Media files can be excluded from a VAST response based on mime type
- Ticket 226 - Critical Timestamp.secondsToTimestamp() fix - was producing invalid timestamp for times greater than 60 mins
1. Download the Release Candidates
You can download the full release candidate package via the following links:
- ova.as3-rc.tar.gz (0.6.0)
- ova.flowplayer-rc.tar.gz (0.6.0)
- ova.jwplayer.4x-rc.tar.gz (0.5.0)
- ova.jwplayer.5x-rc.tar.gz (0.5.0)
If you just want the OVA.swf or AS3 framework library file, download via these links:
- OVA for AS3 (SWC)
- OVA for JW Player 4 (SWF)
- OVA for JW Player 5 (SWF)
- OVA for Flowplayer (SWF)
Finally, the latest release candidate code can be found in the SVN "packages" directory, or the "tags" directory.
2. VAST2 wrapper support
Support has been added for the VAST 2 wrapper. For more information on the format of VAST 2 wrappers, refer to the IAB site.
For an example of the VAST 2 wrapper in action, click here.
3. VPAID support
Support has been added for VPAID 1.1 linear ads. At this time the support has been added to the AS3 framework, OVA for JW4 and OVA for JW5 plugins.
To see an example VPAID linear ad in action (JW5), click here.
4. Configuring the Skip Ad Button
The ability to "skip" on a linear ad has been added along with a set of examples illustrating how to configure OVA to activate the button ( Flowplayer, JW4, JW5 examples)
A "skip" button can be enabled as follows:
{
"ads": {
"controls": {
"skipAd": {
"enabled": true
}
},
....
}
}
4.1 The Standard Skip Ad Button
By default a button with a pre-defined image is used.
To see the standard "skip ad" button in action, click here ( Flowplayer, JW4, JW5).
That image can be overridden.
4.2 Using a Custom Image for the Skip Ad Button
To override the standard skip ad button image, use the "image" property and specify the new image "width" and "height":
{
"ads": {
"controls": {
"skipAd": {
"enabled": true,
"image": "../../images/my-new-skip-button.jpg",
"width": 65,
"height": 15
}
},
....
}
}
An example of an overridden button image can be found here ( Flowplayer, JW4, JW5).
4.3 Using Region Attributes with the Skip Ad Button
It is also possible to use the region attributions to declare a skip button - background color, margins, borders and html content can be specified to construct the look of the button.
{
"ads": {
"controls": {
"skipAd": {
"enabled": true,
"html": "<p>SKIP!</p>",
"region": {
"id": "my-new-skip-ad-button",
"verticalAlign": 3,
"horizontalAlign": 3,
"backgroundColor": "#FF3300",
"opacity": 0.8,
"borderRadius": 15,
"padding": "0 1 1 13",
"width": 60,
"height": 20
}
}
},
....
}
}
An example of a HTML button can be found here ( Flowplayer, JW4, JW5)
4.4 Showing the Skip Button on Ads with a minimim duration
It is possible to configure the "skip ad" button so that it only shows on ads that are longer than a specific duration.
For example, the following configuration configures the "skip ad" button to show only on ads that are 10 seconds or longer in duration.
{
"ads": {
"controls": {
"skipAd": {
"enabled": true,
"minimumAdDuration": 10
}
},
....
}
}
If you want to see this option in action, view these examples ( Flowplayer, JW4, JW5)
5. Simplified Configuration
In the case of a straight forward pre-roll setup, the OVA configuration approach has been simplified in this release.
When configuring OVA, all that is required now for the minimal pre-roll setup is the ad tag itself.
To declare a pre-roll setup for OVA for JW Player 4/5, use the following flashvars:
flashvars="plugins=ova&ova.tag=put-your-ad-tag-here"
To declare a pre-roll setup for OVA for Flowplayer, use the following Flowplayer configuration:
ova: {
url: "ova.swf",
tag: "put-your-ad-tag-here"
}
6. Deferred Loading
Using the "delayAdRequestUntilPlay" configuration option it is possible to defer the ad request to an ad server until the play button has been hit.
An example of the deferred loading option in action can be found here ( Flowplayer, JW4, JW5)
7. Ad Server Failover
It is possible to specify secondary ad servers to "fail-over" too when the preceding ad server call fails to return a result.
Fail-over server ad tags are specified using the "failoverServers" configuration property. An array of tags may be declared - each will be tried in turn until a result is returned.
This property can be used at an AdSlot or Server declaration level.
"schedule": [
{
"zone": "5",
"position": "post-roll",
"server": {
"type": "OpenX",
"apiAddress": "http://openx.openvideoads.org/openx/www/delivery/fc.php",
"oneAdPerRequest": true,
"customProperties" : {
"target": "category=food"
},
"failoverServers": [
{
"type": "AdTech",
"tag": "http://adserver.adtech.de/?adrawdata/3.0/990.1/2366662/
0/1725/noperf=1;cc=2;header=yes;cookie=yes;adct=204;
alias=;key=key1+key2;;=;grp=[group];misc=__random-number__"
}
]
}
}
]
An example of the failover option in action can be found here ( Flowplayer, JW4, JW5)
7. Always setting the show stream duration from Metadata
The "setDurationFromMetaData" configuration option has been implemented for "show" streams in this release.
"shows": {
"setDurationFromMetaData": true
}
When the option is set to "true", OVA will forcibly set the duration will always be set according to the metadata duration for the stream. The option is "false" by default.
8. Excluding Ad Media Files based on Mime Type
Two configuration options have been added to the "ads" configuration block to allow media files to be excluded during OVA search to identify relevant linear streams to playback.
The two options are illustrated below.
"ads": {
"acceptedLinearAdMimeTypes": [ "video/x-flv" ],
"filterOnLinearAdMimeTypes": true,
...
}
In this example, only FLV based ad streams will be selected.
"acceptedLinearAdMimeTypes" is an Array based configuration property. A set of mime types can be configured as per a normal Array based definition. For instance, to limit the filtering to FLV and MP4, the following declaration should be made:
"acceptedLinearAdMimeTypes": [ "video/x-flv", "video/x-mp4"]
By default:
- In the AS3 framework "filterOnLinearAdMimeTypes" is false
- In the OVA JW4, JW5 and Flowplayer plugins, "filterOnLinearAdMimeTypes" is true and "acceptedLinearAdMimeTypes" is set to ["video/x-flv","video/x-mp4","application/x-shockwave-flash"]
To turn off the default filtering in the OVA plugins just set "filterOnLinearAdMimeTypes" to false - all "media files" elements of the VAST response will then be searched for a match to playback.
