Class: Aws::MediaTailor::Types::PutPlaybackConfigurationRequest

Inherits:
Struct
  • Object
show all
Defined in:
gems/aws-sdk-mediatailor/lib/aws-sdk-mediatailor/types.rb

Overview

Note:

When making an API call, you may pass PutPlaybackConfigurationRequest data as a hash:

{
  ad_decision_server_url: "__string",
  avail_suppression: {
    mode: "OFF", # accepts OFF, BEHIND_LIVE_EDGE
    value: "__string",
  },
  bumper: {
    end_url: "__string",
    start_url: "__string",
  },
  cdn_configuration: {
    ad_segment_url_prefix: "__string",
    content_segment_url_prefix: "__string",
  },
  configuration_aliases: {
    "__string" => {
      "__string" => "__string",
    },
  },
  dash_configuration: {
    mpd_location: "__string",
    origin_manifest_type: "SINGLE_PERIOD", # accepts SINGLE_PERIOD, MULTI_PERIOD
  },
  live_pre_roll_configuration: {
    ad_decision_server_url: "__string",
    max_duration_seconds: 1,
  },
  manifest_processing_rules: {
    ad_marker_passthrough: {
      enabled: false,
    },
  },
  name: "__string",
  personalization_threshold_seconds: 1,
  slate_ad_url: "__string",
  tags: {
    "__string" => "__string",
  },
  transcode_profile_name: "__string",
  video_content_source_url: "__string",
}

The configuration for creating a playback configuration.

Constant Summary collapse

SENSITIVE =
[]

Instance Attribute Summary collapse

Instance Attribute Details

#ad_decision_server_urlString

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.

Returns:

  • (String)


3291
3292
3293
3294
3295
3296
3297
3298
3299
3300
3301
3302
3303
3304
3305
3306
3307
3308
# File 'gems/aws-sdk-mediatailor/lib/aws-sdk-mediatailor/types.rb', line 3291

class PutPlaybackConfigurationRequest < Struct.new(
  :ad_decision_server_url,
  :avail_suppression,
  :bumper,
  :cdn_configuration,
  :configuration_aliases,
  :dash_configuration,
  :live_pre_roll_configuration,
  :manifest_processing_rules,
  :name,
  :personalization_threshold_seconds,
  :slate_ad_url,
  :tags,
  :transcode_profile_name,
  :video_content_source_url)
  SENSITIVE = []
  include Aws::Structure
end

#avail_suppressionTypes::AvailSuppression

The configuration for avail suppression, also known as ad suppression. For more information about ad suppression, see Ad Suppression.



3291
3292
3293
3294
3295
3296
3297
3298
3299
3300
3301
3302
3303
3304
3305
3306
3307
3308
# File 'gems/aws-sdk-mediatailor/lib/aws-sdk-mediatailor/types.rb', line 3291

class PutPlaybackConfigurationRequest < Struct.new(
  :ad_decision_server_url,
  :avail_suppression,
  :bumper,
  :cdn_configuration,
  :configuration_aliases,
  :dash_configuration,
  :live_pre_roll_configuration,
  :manifest_processing_rules,
  :name,
  :personalization_threshold_seconds,
  :slate_ad_url,
  :tags,
  :transcode_profile_name,
  :video_content_source_url)
  SENSITIVE = []
  include Aws::Structure
end

#bumperTypes::Bumper

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.

Returns:



3291
3292
3293
3294
3295
3296
3297
3298
3299
3300
3301
3302
3303
3304
3305
3306
3307
3308
# File 'gems/aws-sdk-mediatailor/lib/aws-sdk-mediatailor/types.rb', line 3291

class PutPlaybackConfigurationRequest < Struct.new(
  :ad_decision_server_url,
  :avail_suppression,
  :bumper,
  :cdn_configuration,
  :configuration_aliases,
  :dash_configuration,
  :live_pre_roll_configuration,
  :manifest_processing_rules,
  :name,
  :personalization_threshold_seconds,
  :slate_ad_url,
  :tags,
  :transcode_profile_name,
  :video_content_source_url)
  SENSITIVE = []
  include Aws::Structure
end

#cdn_configurationTypes::CdnConfiguration

The configuration for using a content delivery network (CDN), like Amazon CloudFront, for content and ad segment management.



3291
3292
3293
3294
3295
3296
3297
3298
3299
3300
3301
3302
3303
3304
3305
3306
3307
3308
# File 'gems/aws-sdk-mediatailor/lib/aws-sdk-mediatailor/types.rb', line 3291

class PutPlaybackConfigurationRequest < Struct.new(
  :ad_decision_server_url,
  :avail_suppression,
  :bumper,
  :cdn_configuration,
  :configuration_aliases,
  :dash_configuration,
  :live_pre_roll_configuration,
  :manifest_processing_rules,
  :name,
  :personalization_threshold_seconds,
  :slate_ad_url,
  :tags,
  :transcode_profile_name,
  :video_content_source_url)
  SENSITIVE = []
  include Aws::Structure
end

#configuration_aliasesHash<String,Hash<String,String>>

The player parameters and aliases used as dynamic variables during session initialization. For more information, see Domain Variables.

Returns:

  • (Hash<String,Hash<String,String>>)


3291
3292
3293
3294
3295
3296
3297
3298
3299
3300
3301
3302
3303
3304
3305
3306
3307
3308
# File 'gems/aws-sdk-mediatailor/lib/aws-sdk-mediatailor/types.rb', line 3291

class PutPlaybackConfigurationRequest < Struct.new(
  :ad_decision_server_url,
  :avail_suppression,
  :bumper,
  :cdn_configuration,
  :configuration_aliases,
  :dash_configuration,
  :live_pre_roll_configuration,
  :manifest_processing_rules,
  :name,
  :personalization_threshold_seconds,
  :slate_ad_url,
  :tags,
  :transcode_profile_name,
  :video_content_source_url)
  SENSITIVE = []
  include Aws::Structure
end

#dash_configurationTypes::DashConfigurationForPut

The configuration for DASH content.



3291
3292
3293
3294
3295
3296
3297
3298
3299
3300
3301
3302
3303
3304
3305
3306
3307
3308
# File 'gems/aws-sdk-mediatailor/lib/aws-sdk-mediatailor/types.rb', line 3291

class PutPlaybackConfigurationRequest < Struct.new(
  :ad_decision_server_url,
  :avail_suppression,
  :bumper,
  :cdn_configuration,
  :configuration_aliases,
  :dash_configuration,
  :live_pre_roll_configuration,
  :manifest_processing_rules,
  :name,
  :personalization_threshold_seconds,
  :slate_ad_url,
  :tags,
  :transcode_profile_name,
  :video_content_source_url)
  SENSITIVE = []
  include Aws::Structure
end

#live_pre_roll_configurationTypes::LivePreRollConfiguration

The configuration for pre-roll ad insertion.



3291
3292
3293
3294
3295
3296
3297
3298
3299
3300
3301
3302
3303
3304
3305
3306
3307
3308
# File 'gems/aws-sdk-mediatailor/lib/aws-sdk-mediatailor/types.rb', line 3291

class PutPlaybackConfigurationRequest < Struct.new(
  :ad_decision_server_url,
  :avail_suppression,
  :bumper,
  :cdn_configuration,
  :configuration_aliases,
  :dash_configuration,
  :live_pre_roll_configuration,
  :manifest_processing_rules,
  :name,
  :personalization_threshold_seconds,
  :slate_ad_url,
  :tags,
  :transcode_profile_name,
  :video_content_source_url)
  SENSITIVE = []
  include Aws::Structure
end

#manifest_processing_rulesTypes::ManifestProcessingRules

The configuration for manifest processing rules. Manifest processing rules enable customization of the personalized manifests created by MediaTailor.



3291
3292
3293
3294
3295
3296
3297
3298
3299
3300
3301
3302
3303
3304
3305
3306
3307
3308
# File 'gems/aws-sdk-mediatailor/lib/aws-sdk-mediatailor/types.rb', line 3291

class PutPlaybackConfigurationRequest < Struct.new(
  :ad_decision_server_url,
  :avail_suppression,
  :bumper,
  :cdn_configuration,
  :configuration_aliases,
  :dash_configuration,
  :live_pre_roll_configuration,
  :manifest_processing_rules,
  :name,
  :personalization_threshold_seconds,
  :slate_ad_url,
  :tags,
  :transcode_profile_name,
  :video_content_source_url)
  SENSITIVE = []
  include Aws::Structure
end

#nameString

The identifier for the playback configuration.

Returns:

  • (String)


3291
3292
3293
3294
3295
3296
3297
3298
3299
3300
3301
3302
3303
3304
3305
3306
3307
3308
# File 'gems/aws-sdk-mediatailor/lib/aws-sdk-mediatailor/types.rb', line 3291

class PutPlaybackConfigurationRequest < Struct.new(
  :ad_decision_server_url,
  :avail_suppression,
  :bumper,
  :cdn_configuration,
  :configuration_aliases,
  :dash_configuration,
  :live_pre_roll_configuration,
  :manifest_processing_rules,
  :name,
  :personalization_threshold_seconds,
  :slate_ad_url,
  :tags,
  :transcode_profile_name,
  :video_content_source_url)
  SENSITIVE = []
  include Aws::Structure
end

#personalization_threshold_secondsInteger

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.

Returns:

  • (Integer)


3291
3292
3293
3294
3295
3296
3297
3298
3299
3300
3301
3302
3303
3304
3305
3306
3307
3308
# File 'gems/aws-sdk-mediatailor/lib/aws-sdk-mediatailor/types.rb', line 3291

class PutPlaybackConfigurationRequest < Struct.new(
  :ad_decision_server_url,
  :avail_suppression,
  :bumper,
  :cdn_configuration,
  :configuration_aliases,
  :dash_configuration,
  :live_pre_roll_configuration,
  :manifest_processing_rules,
  :name,
  :personalization_threshold_seconds,
  :slate_ad_url,
  :tags,
  :transcode_profile_name,
  :video_content_source_url)
  SENSITIVE = []
  include Aws::Structure
end

#slate_ad_urlString

The URL for a high-quality 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 configurations. For VPAID, the slate is required because MediaTailor provides it in the slots that are designated for dynamic ad content. The slate must be a high-quality asset that contains both audio and video.

Returns:

  • (String)


3291
3292
3293
3294
3295
3296
3297
3298
3299
3300
3301
3302
3303
3304
3305
3306
3307
3308
# File 'gems/aws-sdk-mediatailor/lib/aws-sdk-mediatailor/types.rb', line 3291

class PutPlaybackConfigurationRequest < Struct.new(
  :ad_decision_server_url,
  :avail_suppression,
  :bumper,
  :cdn_configuration,
  :configuration_aliases,
  :dash_configuration,
  :live_pre_roll_configuration,
  :manifest_processing_rules,
  :name,
  :personalization_threshold_seconds,
  :slate_ad_url,
  :tags,
  :transcode_profile_name,
  :video_content_source_url)
  SENSITIVE = []
  include Aws::Structure
end

#tagsHash<String,String>

The tags to assign to the playback configuration.

Returns:

  • (Hash<String,String>)


3291
3292
3293
3294
3295
3296
3297
3298
3299
3300
3301
3302
3303
3304
3305
3306
3307
3308
# File 'gems/aws-sdk-mediatailor/lib/aws-sdk-mediatailor/types.rb', line 3291

class PutPlaybackConfigurationRequest < Struct.new(
  :ad_decision_server_url,
  :avail_suppression,
  :bumper,
  :cdn_configuration,
  :configuration_aliases,
  :dash_configuration,
  :live_pre_roll_configuration,
  :manifest_processing_rules,
  :name,
  :personalization_threshold_seconds,
  :slate_ad_url,
  :tags,
  :transcode_profile_name,
  :video_content_source_url)
  SENSITIVE = []
  include Aws::Structure
end

#transcode_profile_nameString

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.

Returns:

  • (String)


3291
3292
3293
3294
3295
3296
3297
3298
3299
3300
3301
3302
3303
3304
3305
3306
3307
3308
# File 'gems/aws-sdk-mediatailor/lib/aws-sdk-mediatailor/types.rb', line 3291

class PutPlaybackConfigurationRequest < Struct.new(
  :ad_decision_server_url,
  :avail_suppression,
  :bumper,
  :cdn_configuration,
  :configuration_aliases,
  :dash_configuration,
  :live_pre_roll_configuration,
  :manifest_processing_rules,
  :name,
  :personalization_threshold_seconds,
  :slate_ad_url,
  :tags,
  :transcode_profile_name,
  :video_content_source_url)
  SENSITIVE = []
  include Aws::Structure
end

#video_content_source_urlString

The URL prefix for the parent manifest for the stream, minus the asset ID. The maximum length is 512 characters.

Returns:

  • (String)


3291
3292
3293
3294
3295
3296
3297
3298
3299
3300
3301
3302
3303
3304
3305
3306
3307
3308
# File 'gems/aws-sdk-mediatailor/lib/aws-sdk-mediatailor/types.rb', line 3291

class PutPlaybackConfigurationRequest < Struct.new(
  :ad_decision_server_url,
  :avail_suppression,
  :bumper,
  :cdn_configuration,
  :configuration_aliases,
  :dash_configuration,
  :live_pre_roll_configuration,
  :manifest_processing_rules,
  :name,
  :personalization_threshold_seconds,
  :slate_ad_url,
  :tags,
  :transcode_profile_name,
  :video_content_source_url)
  SENSITIVE = []
  include Aws::Structure
end