Ad Policy
Ad policies are rule sets that can be enforced while handling seek events with media containing adverts. The following are the rules and behaviours defined.
Ad Policy Rules
PlaybackFastForwardRule
Ad playback policy applicable with fast forward operation.
| Rule | Description |
|---|---|
| TRICK_FW_PLAY_ALL | It enforces the rule that the player will replay all the ad breaks that were leaped over by the user during trick mode fast forward operation. This is the default rule. |
| TRICK_FW_PLAY_FIRST | It enforces the rule that the player will replay only the first ad break that was leaped over by the user during trick mode fast forward operation. |
| TRICK_FW_PLAY_LAST | It enforces the rule that the player will replay only the last ad break that was leaped over by the user during trick mode fast forward operation. |
| TRICK_FW_SKIP_ALL | It enforces the rule that the player will skip all the ad breaks that were leaped over by the user during trick mode fast forward operation. |
PlaybackRewindRule
Ad playback policy applicable with rewind operation.
| Rule | Description |
|---|---|
| TRICK_RW_PLAY_ALL | It enforces the rule that the player will replay all the ad breaks that were leaped over by the user during trick mode rewind operation. This is the default rule. |
| TRICK_RW_PLAY_FIRST | It enforces the rule that the player will replay only the first ad break that was leaped over by the user during trick mode rewind operation. |
| TRICK_RW_PLAY_LAST | It enforces the rule that the player will replay only the last ad break that was leaped over by the user during trick mode rewind operation. |
| TRICK_RW_SKIP_ALL | It enforces the rule that the player will skip all the ad breaks that were leaped over by the user during trick mode rewind operation. |
PlaybackAutoSeekRule
Ad playback policy applicable with playback starting from a initial playback position.
| Rule | Description |
|---|---|
| AUTO_SEEK_SKIP_ALL | It enforces the rule that the player will start the content without forcing the user to watch any ads that are available from the start of the content to the bookmarked time. |
| AUTO_SEEK_PLAY_PREROLL | It enforces the rule that the player will force the user to watch the PREROLL ads, while any MIDROLL ads, that are available from the start of the content to the bookmarked time, will be skipped. |
| AUTO_SEEK_PLAY_MIDROLL | It enforces the rule that the player will force a user to watch at least one MIDROLL ad, while the PREROLL ads will be skipped. Whether the user has to watch all triggered MIDROLL ads, or only one, is determined by the PlaybackFastForwardRule policy value. |
| AUTO_SEEK_PLAY_ALL | It enforces the rule that the player will force a user to watch the PREROLL ads, then one or more MIDROLL ads. Whether the user has to watch all triggered MIDROLL ads, or only one, is determined by the PlaybackFastForwardRule policy value. This is the default rule. |
PlaybackRepeatedRule
Ad playback policy applicable with repeated ad playback in a single playback session.
| Rule | Description |
|---|---|
| REPEAT_ALWAYS_PLAY | It enforces the rule that the player will repeatedly play the ad break, with a given ID, in a single playback session whenever the ad break is triggered. |
| REPEAT_PLAY_ONCE | It enforces the rule that the player will play the ad break, with a given ID, only once in a single playback session whenever the ad break is triggered. This is the default rule. |
AdPolicy with SSAI
The ad policy rules can be set after we create the FLAdYospacePlayer calling the function setAdPlaybackPolicy and using the constants on the FLAdYospacePlayer FlPlayerAdPolicyFastForwardModes, FlPlayerAdPolicyRewindModes, FlPlayerAdPolicyAutoSeekModes, FlPlayerAdPolicyRepeatModes
Initialize FLPlayer
flPlayer = createObject("roSGNode", "FLAdYospacePlayer")
flPlayer.callFunc(flPlayer.FLPlayerFunctions.SET_AD_POLICY, flPlayer.FlPlayerAdPolicyFastForwardModes.TRICK_FW_PLAY_ALL, flPlayer.FlPlayerAdPolicyRewindModes.TRICK_RW_PLAY_ALL, flPlayer.FlPlayerAdPolicyAutoSeekModes.AUTO_SEEK_PLAY_PREROLL, flPlayer.FlPlayerAdPolicyRepeatModes.REPEAT_ALWAYS_PLAY)