Since
playAd(tag)will be deprecated as of JW 8.31.0, use loadAdTag(tag).
Used to play an ad immediately, which is primarily useful for situations where the built-in ad schedule of JW Player cannot be used. (e.g. for live streaming or dynamic ads for playlist items)
| Attribute | Description |
|---|---|
| tag* string | VAST tag URL that should be loaded into the player |
We recommend to call playAd() in one of these following situations:
- Inside a JW Player event handler for
beforePlay()to trigger a pre-roll - Inside a JW Player event handler for
onTime()to trigger a mid-roll - Inside an event handler for
on('BeforeComplete')to trigger a post-roll - Outside of event handlers, only when the player is in the playing state
playAd()is not supported when using Player Bidding due to the potential impact on performance and user experience while the player is waiting for the bidding process to complete.playAd()is also not supported with ad preloading. Since callingplayAd()immediately plays an ad, there is no time to preload an ad.