CfnPlaybackConfiguration
- class aws_cdk.aws_mediatailor.CfnPlaybackConfiguration(scope, id, *, ad_decision_server_url, name, video_content_source_url, avail_suppression=None, bumper=None, cdn_configuration=None, configuration_aliases=None, dash_configuration=None, hls_configuration=None, live_pre_roll_configuration=None, manifest_processing_rules=None, personalization_threshold_seconds=None, slate_ad_url=None, tags=None, transcode_profile_name=None)
Bases:
CfnResourceAdds a new playback configuration to AWS Elemental MediaTailor .
- See:
- CloudformationResource:
AWS::MediaTailor::PlaybackConfiguration
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk import aws_mediatailor as mediatailor # configuration_aliases: Any cfn_playback_configuration = mediatailor.CfnPlaybackConfiguration(self, "MyCfnPlaybackConfiguration", ad_decision_server_url="adDecisionServerUrl", name="name", video_content_source_url="videoContentSourceUrl", # the properties below are optional avail_suppression=mediatailor.CfnPlaybackConfiguration.AvailSuppressionProperty( mode="mode", value="value" ), bumper=mediatailor.CfnPlaybackConfiguration.BumperProperty( end_url="endUrl", start_url="startUrl" ), cdn_configuration=mediatailor.CfnPlaybackConfiguration.CdnConfigurationProperty( ad_segment_url_prefix="adSegmentUrlPrefix", content_segment_url_prefix="contentSegmentUrlPrefix" ), configuration_aliases={ "configuration_aliases_key": configuration_aliases }, dash_configuration=mediatailor.CfnPlaybackConfiguration.DashConfigurationProperty( manifest_endpoint_prefix="manifestEndpointPrefix", mpd_location="mpdLocation", origin_manifest_type="originManifestType" ), hls_configuration=mediatailor.CfnPlaybackConfiguration.HlsConfigurationProperty( manifest_endpoint_prefix="manifestEndpointPrefix" ), live_pre_roll_configuration=mediatailor.CfnPlaybackConfiguration.LivePreRollConfigurationProperty( ad_decision_server_url="adDecisionServerUrl", max_duration_seconds=123 ), manifest_processing_rules=mediatailor.CfnPlaybackConfiguration.ManifestProcessingRulesProperty( ad_marker_passthrough=mediatailor.CfnPlaybackConfiguration.AdMarkerPassthroughProperty( enabled=False ) ), personalization_threshold_seconds=123, slate_ad_url="slateAdUrl", tags=[CfnTag( key="key", value="value" )], transcode_profile_name="transcodeProfileName" )
- Parameters:
scope (
Construct) – Scope in which this resource is defined.id (
str) – Construct identifier for this resource (unique in its scope).ad_decision_server_url (
str) – The URL for the ad decision server (ADS). This includes the specification of static parameters and placeholders for dynamic parameters. AWS Elemental MediaTailor substitutes player-specific and session-specific parameters as needed when calling the ADS. Alternately, for testing you can provide a static VAST URL. The maximum length is 25,000 characters.name (
str) – The identifier for the playback configuration.video_content_source_url (
str) – The URL prefix for the parent manifest for the stream, minus the asset ID. The maximum length is 512 characters.avail_suppression (
Union[IResolvable,AvailSuppressionProperty,Dict[str,Any],None]) – The configuration for avail suppression, also known as ad suppression. For more information about ad suppression, see Ad Suppression .bumper (
Union[IResolvable,BumperProperty,Dict[str,Any],None]) – The configuration for bumpers. Bumpers are short audio or video clips that play at the start or before the end of an ad break. To learn more about bumpers, see Bumpers .cdn_configuration (
Union[IResolvable,CdnConfigurationProperty,Dict[str,Any],None]) – The configuration for using a content delivery network (CDN), like Amazon CloudFront, for content and ad segment management.configuration_aliases (
Union[IResolvable,Mapping[str,Any],None]) – The player parameters and aliases used as dynamic variables during session initialization. For more information, see Domain Variables .dash_configuration (
Union[IResolvable,DashConfigurationProperty,Dict[str,Any],None]) – The configuration for a DASH source.hls_configuration (
Union[IResolvable,HlsConfigurationProperty,Dict[str,Any],None]) – The configuration for HLS content.live_pre_roll_configuration (
Union[IResolvable,LivePreRollConfigurationProperty,Dict[str,Any],None]) – The configuration for pre-roll ad insertion.manifest_processing_rules (
Union[IResolvable,ManifestProcessingRulesProperty,Dict[str,Any],None]) – The configuration for manifest processing rules. Manifest processing rules enable customization of the personalized manifests created by MediaTailor.personalization_threshold_seconds (
Union[int,float,None]) – Defines the maximum duration of underfilled ad time (in seconds) allowed in an ad break. If the duration of underfilled ad time exceeds the personalization threshold, then the personalization of the ad break is abandoned and the underlying content is shown. This feature applies to ad replacement in live and VOD streams, rather than ad insertion, because it relies on an underlying content stream. For more information about ad break behavior, including ad replacement and insertion, see Ad Behavior in AWS Elemental MediaTailor .slate_ad_url (
Optional[str]) – The URL for a video asset to transcode and use to fill in time that’s not used by ads. AWS Elemental MediaTailor shows the slate to fill in gaps in media content. Configuring the slate is optional for non-VPAID playback configurations. For VPAID, the slate is required because MediaTailor provides it in the slots designated for dynamic ad content. The slate must be a high-quality asset that contains both audio and video.tags (
Optional[Sequence[Union[CfnTag,Dict[str,Any]]]]) – The tags to assign to the playback configuration. Tags are key-value pairs that you can associate with Amazon resources to help with organization, access control, and cost tracking. For more information, see Tagging AWS Elemental MediaTailor Resources .transcode_profile_name (
Optional[str]) – The name that is used to associate this playback configuration with a custom transcode profile. This overrides the dynamic transcoding defaults of MediaTailor. Use this only if you have already set up custom profiles with the help of AWS Support.
Methods
- add_deletion_override(path)
Syntactic sugar for
addOverride(path, undefined).- Parameters:
path (
str) – The path of the value to delete.- Return type:
None
- add_dependency(target)
Indicates that this resource depends on another resource and cannot be provisioned unless the other resource has been successfully provisioned.
This can be used for resources across stacks (or nested stack) boundaries and the dependency will automatically be transferred to the relevant scope.
- Parameters:
target (
CfnResource) –- Return type:
None
- add_depends_on(target)
(deprecated) Indicates that this resource depends on another resource and cannot be provisioned unless the other resource has been successfully provisioned.
- Parameters:
target (
CfnResource) –- Deprecated:
use addDependency
- Stability:
deprecated
- Return type:
None
- add_metadata(key, value)
Add a value to the CloudFormation Resource Metadata.
- Parameters:
key (
str) –value (
Any) –
- See:
- Return type:
None
https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/metadata-section-structure.html
Note that this is a different set of metadata from CDK node metadata; this metadata ends up in the stack template under the resource, whereas CDK node metadata ends up in the Cloud Assembly.
- add_override(path, value)
Adds an override to the synthesized CloudFormation resource.
To add a property override, either use
addPropertyOverrideor prefixpathwith “Properties.” (i.e.Properties.TopicName).If the override is nested, separate each nested level using a dot (.) in the path parameter. If there is an array as part of the nesting, specify the index in the path.
To include a literal
.in the property name, prefix with a\. In most programming languages you will need to write this as"\\."because the\itself will need to be escaped.For example:
cfn_resource.add_override("Properties.GlobalSecondaryIndexes.0.Projection.NonKeyAttributes", ["myattribute"]) cfn_resource.add_override("Properties.GlobalSecondaryIndexes.1.ProjectionType", "INCLUDE")
would add the overrides Example:
"Properties": { "GlobalSecondaryIndexes": [ { "Projection": { "NonKeyAttributes": [ "myattribute" ] ... } ... }, { "ProjectionType": "INCLUDE" ... }, ] ... }
The
valueargument toaddOverridewill not be processed or translated in any way. Pass raw JSON values in here with the correct capitalization for CloudFormation. If you pass CDK classes or structs, they will be rendered with lowercased key names, and CloudFormation will reject the template.- Parameters:
path (
str) –The path of the property, you can use dot notation to override values in complex types. Any intermediate keys will be created as needed.
value (
Any) –The value. Could be primitive or complex.
- Return type:
None
- add_property_deletion_override(property_path)
Adds an override that deletes the value of a property from the resource definition.
- Parameters:
property_path (
str) – The path to the property.- Return type:
None
- add_property_override(property_path, value)
Adds an override to a resource property.
Syntactic sugar for
addOverride("Properties.<...>", value).- Parameters:
property_path (
str) – The path of the property.value (
Any) – The value.
- Return type:
None
- apply_removal_policy(policy=None, *, apply_to_update_replace_policy=None, default=None)
Sets the deletion policy of the resource based on the removal policy specified.
The Removal Policy controls what happens to this resource when it stops being managed by CloudFormation, either because you’ve removed it from the CDK application or because you’ve made a change that requires the resource to be replaced.
The resource can be deleted (
RemovalPolicy.DESTROY), or left in your AWS account for data recovery and cleanup later (RemovalPolicy.RETAIN). In some cases, a snapshot can be taken of the resource prior to deletion (RemovalPolicy.SNAPSHOT). A list of resources that support this policy can be found in the following link:- Parameters:
policy (
Optional[RemovalPolicy]) –apply_to_update_replace_policy (
Optional[bool]) – Apply the same deletion policy to the resource’s “UpdateReplacePolicy”. Default: truedefault (
Optional[RemovalPolicy]) – The default policy to apply in case the removal policy is not defined. Default: - Default value is resource specific. To determine the default value for a resource, please consult that specific resource’s documentation.
- See:
- Return type:
None
- get_att(attribute_name, type_hint=None)
Returns a token for an runtime attribute of this resource.
Ideally, use generated attribute accessors (e.g.
resource.arn), but this can be used for future compatibility in case there is no generated attribute.- Parameters:
attribute_name (
str) – The name of the attribute.type_hint (
Optional[ResolutionTypeHint]) –
- Return type:
- get_metadata(key)
Retrieve a value value from the CloudFormation Resource Metadata.
- Parameters:
key (
str) –- See:
- Return type:
Any
https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/metadata-section-structure.html
Note that this is a different set of metadata from CDK node metadata; this metadata ends up in the stack template under the resource, whereas CDK node metadata ends up in the Cloud Assembly.
- inspect(inspector)
Examines the CloudFormation resource and discloses attributes.
- Parameters:
inspector (
TreeInspector) – tree inspector to collect and process attributes.- Return type:
None
- obtain_dependencies()
Retrieves an array of resources this resource depends on.
This assembles dependencies on resources across stacks (including nested stacks) automatically.
- Return type:
List[Union[Stack,CfnResource]]
- obtain_resource_dependencies()
Get a shallow copy of dependencies between this resource and other resources in the same stack.
- Return type:
List[CfnResource]
- override_logical_id(new_logical_id)
Overrides the auto-generated logical ID with a specific ID.
- Parameters:
new_logical_id (
str) – The new logical ID to use for this stack element.- Return type:
None
- remove_dependency(target)
Indicates that this resource no longer depends on another resource.
This can be used for resources across stacks (including nested stacks) and the dependency will automatically be removed from the relevant scope.
- Parameters:
target (
CfnResource) –- Return type:
None
- replace_dependency(target, new_target)
Replaces one dependency with another.
- Parameters:
target (
CfnResource) – The dependency to replace.new_target (
CfnResource) – The new dependency to add.
- Return type:
None
- to_string()
Returns a string representation of this construct.
- Return type:
str- Returns:
a string representation of this resource
Attributes
- CFN_RESOURCE_TYPE_NAME = 'AWS::MediaTailor::PlaybackConfiguration'
- ad_decision_server_url
The URL for the ad decision server (ADS).
- attr_dash_configuration_manifest_endpoint_prefix
The URL generated by MediaTailor to initiate a playback session.
The session uses server-side reporting. This setting is ignored in PUT operations.
- CloudformationAttribute:
DashConfiguration.ManifestEndpointPrefix
- attr_hls_configuration_manifest_endpoint_prefix
The URL that is used to initiate a playback session for devices that support Apple HLS.
The session uses server-side reporting.
- CloudformationAttribute:
HlsConfiguration.ManifestEndpointPrefix
- attr_playback_configuration_arn
The Amazon Resource Name (ARN) for the playback configuration.
- CloudformationAttribute:
PlaybackConfigurationArn
- attr_playback_endpoint_prefix
The URL that the player accesses to get a manifest from MediaTailor .
This session will use server-side reporting.
- CloudformationAttribute:
PlaybackEndpointPrefix
- attr_session_initialization_endpoint_prefix
The URL that the player uses to initialize a session that uses client-side reporting.
- CloudformationAttribute:
SessionInitializationEndpointPrefix
- avail_suppression
The configuration for avail suppression, also known as ad suppression.
- bumper
The configuration for bumpers.
- cdn_configuration
The configuration for using a content delivery network (CDN), like Amazon CloudFront, for content and ad segment management.
- cfn_options
Options for this resource, such as condition, update policy etc.
- cfn_resource_type
AWS resource type.
- configuration_aliases
The player parameters and aliases used as dynamic variables during session initialization.
- creation_stack
return:
the stack trace of the point where this Resource was created from, sourced from the +metadata+ entry typed +aws:cdk:logicalId+, and with the bottom-most node +internal+ entries filtered.
- dash_configuration
The configuration for a DASH source.
- hls_configuration
The configuration for HLS content.
- live_pre_roll_configuration
The configuration for pre-roll ad insertion.
- logical_id
The logical ID for this CloudFormation stack element.
The logical ID of the element is calculated from the path of the resource node in the construct tree.
To override this value, use
overrideLogicalId(newLogicalId).- Returns:
the logical ID as a stringified token. This value will only get resolved during synthesis.
- manifest_processing_rules
The configuration for manifest processing rules.
- name
The identifier for the playback configuration.
- node
The tree node.
- personalization_threshold_seconds
Defines the maximum duration of underfilled ad time (in seconds) allowed in an ad break.
- ref
Return a string that will be resolved to a CloudFormation
{ Ref }for this element.If, by any chance, the intrinsic reference of a resource is not a string, you could coerce it to an IResolvable through
Lazy.any({ produce: resource.ref }).
- slate_ad_url
The URL for a video asset to transcode and use to fill in time that’s not used by ads.
- stack
The stack in which this element is defined.
CfnElements must be defined within a stack scope (directly or indirectly).
- tags
Tag Manager which manages the tags for this resource.
- tags_raw
The tags to assign to the playback configuration.
- transcode_profile_name
The name that is used to associate this playback configuration with a custom transcode profile.
- video_content_source_url
The URL prefix for the parent manifest for the stream, minus the asset ID.
Static Methods
- classmethod is_cfn_element(x)
Returns
trueif a construct is a stack element (i.e. part of the synthesized cloudformation template).Uses duck-typing instead of
instanceofto allow stack elements from different versions of this library to be included in the same stack.- Parameters:
x (
Any) –- Return type:
bool- Returns:
The construct as a stack element or undefined if it is not a stack element.
- classmethod is_cfn_resource(x)
Check whether the given object is a CfnResource.
- Parameters:
x (
Any) –- Return type:
bool
- classmethod is_construct(x)
Checks if
xis a construct.Use this method instead of
instanceofto properly detectConstructinstances, even when the construct library is symlinked.Explanation: in JavaScript, multiple copies of the
constructslibrary on disk are seen as independent, completely different libraries. As a consequence, the classConstructin each copy of theconstructslibrary is seen as a different class, and an instance of one class will not test asinstanceofthe other class.npm installwill not create installations like this, but users may manually symlink construct libraries together or use a monorepo tool: in those cases, multiple copies of theconstructslibrary can be accidentally installed, andinstanceofwill behave unpredictably. It is safest to avoid usinginstanceof, and using this type-testing method instead.- Parameters:
x (
Any) – Any object.- Return type:
bool- Returns:
true if
xis an object created from a class which extendsConstruct.
AdMarkerPassthroughProperty
- class CfnPlaybackConfiguration.AdMarkerPassthroughProperty(*, enabled=None)
Bases:
objectFor HLS, when set to
true, MediaTailor passes throughEXT-X-CUE-IN,EXT-X-CUE-OUT, andEXT-X-SPLICEPOINT-SCTE35ad markers from the origin manifest to the MediaTailor personalized manifest.No logic is applied to these ad markers. For example, if
EXT-X-CUE-OUThas a value of60, but no ads are filled for that ad break, MediaTailor will not set the value to0.- Parameters:
enabled (
Union[bool,IResolvable,None]) – Enables ad marker passthrough for your configuration.- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk import aws_mediatailor as mediatailor ad_marker_passthrough_property = mediatailor.CfnPlaybackConfiguration.AdMarkerPassthroughProperty( enabled=False )
Attributes
- enabled
Enables ad marker passthrough for your configuration.
AvailSuppressionProperty
- class CfnPlaybackConfiguration.AvailSuppressionProperty(*, mode=None, value=None)
Bases:
objectThe configuration for avail suppression, also known as ad suppression.
For more information about ad suppression, see Ad Suppression .
- Parameters:
mode (
Optional[str]) – Sets the ad suppression mode. By default, ad suppression is off and all ad breaks are filled with ads or slate. When Mode is set toBEHIND_LIVE_EDGE, ad suppression is active and MediaTailor won’t fill ad breaks on or behind the ad suppression Value time in the manifest lookback window. When Mode is set toAFTER_LIVE_EDGE, ad suppression is active and MediaTailor won’t fill ad breaks that are within the live edge plus the avail suppression value.value (
Optional[str]) – A live edge offset time in HH:MM:SS. MediaTailor won’t fill ad breaks on or behind this time in the manifest lookback window. If Value is set to 00:00:00, it is in sync with the live edge, and MediaTailor won’t fill any ad breaks on or behind the live edge. If you set a Value time, MediaTailor won’t fill any ad breaks on or behind this time in the manifest lookback window. For example, if you set 00:45:00, then MediaTailor will fill ad breaks that occur within 45 minutes behind the live edge, but won’t fill ad breaks on or behind 45 minutes behind the live edge.
- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk import aws_mediatailor as mediatailor avail_suppression_property = mediatailor.CfnPlaybackConfiguration.AvailSuppressionProperty( mode="mode", value="value" )
Attributes
- mode
Sets the ad suppression mode.
By default, ad suppression is off and all ad breaks are filled with ads or slate. When Mode is set to
BEHIND_LIVE_EDGE, ad suppression is active and MediaTailor won’t fill ad breaks on or behind the ad suppression Value time in the manifest lookback window. When Mode is set toAFTER_LIVE_EDGE, ad suppression is active and MediaTailor won’t fill ad breaks that are within the live edge plus the avail suppression value.
- value
SS.
MediaTailor won’t fill ad breaks on or behind this time in the manifest lookback window. If Value is set to 00:00:00, it is in sync with the live edge, and MediaTailor won’t fill any ad breaks on or behind the live edge. If you set a Value time, MediaTailor won’t fill any ad breaks on or behind this time in the manifest lookback window. For example, if you set 00:45:00, then MediaTailor will fill ad breaks that occur within 45 minutes behind the live edge, but won’t fill ad breaks on or behind 45 minutes behind the live edge.
- See:
- Type:
A live edge offset time in HH
- Type:
MM
BumperProperty
- class CfnPlaybackConfiguration.BumperProperty(*, end_url=None, start_url=None)
Bases:
objectThe configuration for bumpers.
Bumpers are short audio or video clips that play at the start or before the end of an ad break. To learn more about bumpers, see Bumpers .
- Parameters:
end_url (
Optional[str]) – The URL for the end bumper asset.start_url (
Optional[str]) – The URL for the start bumper asset.
- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk import aws_mediatailor as mediatailor bumper_property = mediatailor.CfnPlaybackConfiguration.BumperProperty( end_url="endUrl", start_url="startUrl" )
Attributes
- end_url
The URL for the end bumper asset.
- start_url
The URL for the start bumper asset.
CdnConfigurationProperty
- class CfnPlaybackConfiguration.CdnConfigurationProperty(*, ad_segment_url_prefix=None, content_segment_url_prefix=None)
Bases:
objectThe configuration for using a content delivery network (CDN), like Amazon CloudFront, for content and ad segment management.
- Parameters:
ad_segment_url_prefix (
Optional[str]) – A non-default content delivery network (CDN) to serve ad segments. By default, AWS Elemental MediaTailor uses Amazon CloudFront with default cache settings as its CDN for ad segments. To set up an alternate CDN, create a rule in your CDN for the origin ads.mediatailor. ** .amazonaws.com. Then specify the rule’s name in thisAdSegmentUrlPrefix. When AWS Elemental MediaTailor serves a manifest, it reports your CDN as the source for ad segments.content_segment_url_prefix (
Optional[str]) – A content delivery network (CDN) to cache content segments, so that content requests don’t always have to go to the origin server. First, create a rule in your CDN for the content segment origin server. Then specify the rule’s name in thisContentSegmentUrlPrefix. When AWS Elemental MediaTailor serves a manifest, it reports your CDN as the source for content segments.
- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk import aws_mediatailor as mediatailor cdn_configuration_property = mediatailor.CfnPlaybackConfiguration.CdnConfigurationProperty( ad_segment_url_prefix="adSegmentUrlPrefix", content_segment_url_prefix="contentSegmentUrlPrefix" )
Attributes
- ad_segment_url_prefix
A non-default content delivery network (CDN) to serve ad segments.
By default, AWS Elemental MediaTailor uses Amazon CloudFront with default cache settings as its CDN for ad segments. To set up an alternate CDN, create a rule in your CDN for the origin ads.mediatailor. ** .amazonaws.com. Then specify the rule’s name in this
AdSegmentUrlPrefix. When AWS Elemental MediaTailor serves a manifest, it reports your CDN as the source for ad segments.
- content_segment_url_prefix
A content delivery network (CDN) to cache content segments, so that content requests don’t always have to go to the origin server.
First, create a rule in your CDN for the content segment origin server. Then specify the rule’s name in this
ContentSegmentUrlPrefix. When AWS Elemental MediaTailor serves a manifest, it reports your CDN as the source for content segments.
DashConfigurationProperty
- class CfnPlaybackConfiguration.DashConfigurationProperty(*, manifest_endpoint_prefix=None, mpd_location=None, origin_manifest_type=None)
Bases:
objectThe configuration for DASH content.
- Parameters:
manifest_endpoint_prefix (
Optional[str]) – The URL generated by MediaTailor to initiate a playback session. The session uses server-side reporting. This setting is ignored in PUT operations.mpd_location (
Optional[str]) – The setting that controls whether MediaTailor includes the Location tag in DASH manifests. MediaTailor populates the Location tag with the URL for manifest update requests, to be used by players that don’t support sticky redirects. Disable this if you have CDN routing rules set up for accessing MediaTailor manifests, and you are either using client-side reporting or your players support sticky HTTP redirects. Valid values areDISABLEDandEMT_DEFAULT. TheEMT_DEFAULTsetting enables the inclusion of the tag and is the default value.origin_manifest_type (
Optional[str]) – The setting that controls whether MediaTailor handles manifests from the origin server as multi-period manifests or single-period manifests. If your origin server produces single-period manifests, set this toSINGLE_PERIOD. The default setting isMULTI_PERIOD. For multi-period manifests, omit this setting or set it toMULTI_PERIOD.
- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk import aws_mediatailor as mediatailor dash_configuration_property = mediatailor.CfnPlaybackConfiguration.DashConfigurationProperty( manifest_endpoint_prefix="manifestEndpointPrefix", mpd_location="mpdLocation", origin_manifest_type="originManifestType" )
Attributes
- manifest_endpoint_prefix
The URL generated by MediaTailor to initiate a playback session.
The session uses server-side reporting. This setting is ignored in PUT operations.
- mpd_location
The setting that controls whether MediaTailor includes the Location tag in DASH manifests.
MediaTailor populates the Location tag with the URL for manifest update requests, to be used by players that don’t support sticky redirects. Disable this if you have CDN routing rules set up for accessing MediaTailor manifests, and you are either using client-side reporting or your players support sticky HTTP redirects. Valid values are
DISABLEDandEMT_DEFAULT. TheEMT_DEFAULTsetting enables the inclusion of the tag and is the default value.
- origin_manifest_type
The setting that controls whether MediaTailor handles manifests from the origin server as multi-period manifests or single-period manifests.
If your origin server produces single-period manifests, set this to
SINGLE_PERIOD. The default setting isMULTI_PERIOD. For multi-period manifests, omit this setting or set it toMULTI_PERIOD.
HlsConfigurationProperty
- class CfnPlaybackConfiguration.HlsConfigurationProperty(*, manifest_endpoint_prefix=None)
Bases:
objectThe configuration for HLS content.
- Parameters:
manifest_endpoint_prefix (
Optional[str]) – The URL that is used to initiate a playback session for devices that support Apple HLS. The session uses server-side reporting.- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk import aws_mediatailor as mediatailor hls_configuration_property = mediatailor.CfnPlaybackConfiguration.HlsConfigurationProperty( manifest_endpoint_prefix="manifestEndpointPrefix" )
Attributes
- manifest_endpoint_prefix
The URL that is used to initiate a playback session for devices that support Apple HLS.
The session uses server-side reporting.
LivePreRollConfigurationProperty
- class CfnPlaybackConfiguration.LivePreRollConfigurationProperty(*, ad_decision_server_url=None, max_duration_seconds=None)
Bases:
objectThe configuration for pre-roll ad insertion.
- Parameters:
ad_decision_server_url (
Optional[str]) – The URL for the ad decision server (ADS) for pre-roll ads. This includes the specification of static parameters and placeholders for dynamic parameters. AWS Elemental MediaTailor substitutes player-specific and session-specific parameters as needed when calling the ADS. Alternately, for testing, you can provide a static VAST URL. The maximum length is 25,000 characters.max_duration_seconds (
Union[int,float,None]) – The maximum allowed duration for the pre-roll ad avail. AWS Elemental MediaTailor won’t play pre-roll ads to exceed this duration, regardless of the total duration of ads that the ADS returns.
- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk import aws_mediatailor as mediatailor live_pre_roll_configuration_property = mediatailor.CfnPlaybackConfiguration.LivePreRollConfigurationProperty( ad_decision_server_url="adDecisionServerUrl", max_duration_seconds=123 )
Attributes
- ad_decision_server_url
The URL for the ad decision server (ADS) for pre-roll ads.
This includes the specification of static parameters and placeholders for dynamic parameters. AWS Elemental MediaTailor substitutes player-specific and session-specific parameters as needed when calling the ADS. Alternately, for testing, you can provide a static VAST URL. The maximum length is 25,000 characters.
- max_duration_seconds
The maximum allowed duration for the pre-roll ad avail.
AWS Elemental MediaTailor won’t play pre-roll ads to exceed this duration, regardless of the total duration of ads that the ADS returns.
ManifestProcessingRulesProperty
- class CfnPlaybackConfiguration.ManifestProcessingRulesProperty(*, ad_marker_passthrough=None)
Bases:
objectThe configuration for manifest processing rules.
Manifest processing rules enable customization of the personalized manifests created by MediaTailor.
- Parameters:
ad_marker_passthrough (
Union[IResolvable,AdMarkerPassthroughProperty,Dict[str,Any],None]) – For HLS, when set totrue, MediaTailor passes throughEXT-X-CUE-IN,EXT-X-CUE-OUT, andEXT-X-SPLICEPOINT-SCTE35ad markers from the origin manifest to the MediaTailor personalized manifest. No logic is applied to these ad markers. For example, ifEXT-X-CUE-OUThas a value of60, but no ads are filled for that ad break, MediaTailor will not set the value to0.- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk import aws_mediatailor as mediatailor manifest_processing_rules_property = mediatailor.CfnPlaybackConfiguration.ManifestProcessingRulesProperty( ad_marker_passthrough=mediatailor.CfnPlaybackConfiguration.AdMarkerPassthroughProperty( enabled=False ) )
Attributes
- ad_marker_passthrough
For HLS, when set to
true, MediaTailor passes throughEXT-X-CUE-IN,EXT-X-CUE-OUT, andEXT-X-SPLICEPOINT-SCTE35ad markers from the origin manifest to the MediaTailor personalized manifest.No logic is applied to these ad markers. For example, if
EXT-X-CUE-OUThas a value of60, but no ads are filled for that ad break, MediaTailor will not set the value to0.