aws-sdk-ivsrealtime 1.39.0 → 1.40.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8b01eb3aa537376d6b195505ce67dbd93073aeeb5a82ab53ab494d7a36491e1b
-  data.tar.gz: aa893f4fa52bf849f4307cb13ffd9cad168f91fff34e05c4aaeceee844427917
+  metadata.gz: dd651e75dc7aa5f0964b21bf3066e168ffa0519f78ef2cd93e17236e6a6460fc
+  data.tar.gz: f6fa14664f429482b836a04fdbc4ed0d73ce51c0ccc9b61a7ce0d70b2bb9b4ae
 SHA512:
-  metadata.gz: d0dd6dc808c65c6c31fe2843bca1c4d064af73c11ce7d9b8cf58b6688179618361afc7b263d17b1325afd2a27204a6f0fe70a51b572e38a03fb36a1d1964e3d6
-  data.tar.gz: ae01e0cf04c877bf8e81d3c44ff6663d6e1b4bc1419254f727d5682b24fc2818c094cdcb783c706d7bd793c538b3a7fa298c2d593d6d484dff2b3de343b0f503
+  metadata.gz: 26411d3866abb2e5f9c9b7921635b67a924bc9ea8e40118502db9eb232f060b562ee3bdbc2513729e7a055b609cd71c910d6489890073cf8e2979ea9bedd84e0
+  data.tar.gz: 59de7045b3eb05e188a8cab6fd9287b8444d5fef66b0dd8d6aeb656853a682e45ce830218316ce43a414df1a63d2d6e5346557f27bb6e50f784b650fd6d51ff5

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.40.0 (2025-03-13)
+------------------
+
+* Feature - IVS Real-Time now offers customers the ability to adjust the participant & composition recording segment duration
+
 1.39.0 (2025-03-06)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.39.0
+1.40.0

data/lib/aws-sdk-ivsrealtime/client.rb

@@ -743,6 +743,9 @@ module Aws::IVSRealTime
     #         recording_mode: "INTERVAL", # accepts INTERVAL, DISABLED
     #       },
     #       recording_reconnect_window_seconds: 1,
+    #       hls_configuration: {
+    #         target_segment_duration_seconds: 1,
+    #       },
     #     },
     #   })
     #
@@ -761,6 +764,7 @@ module Aws::IVSRealTime
     #   resp.stage.auto_participant_recording_configuration.thumbnail_configuration.storage[0] #=> String, one of "SEQUENTIAL", "LATEST"
     #   resp.stage.auto_participant_recording_configuration.thumbnail_configuration.recording_mode #=> String, one of "INTERVAL", "DISABLED"
     #   resp.stage.auto_participant_recording_configuration.recording_reconnect_window_seconds #=> Integer
+    #   resp.stage.auto_participant_recording_configuration.hls_configuration.target_segment_duration_seconds #=> Integer
     #   resp.stage.endpoints.events #=> String
     #   resp.stage.endpoints.whip #=> String
     #   resp.stage.endpoints.rtmp #=> String
@@ -1055,6 +1059,7 @@ module Aws::IVSRealTime
     #   resp.composition.destinations[0].configuration.s3.storage_configuration_arn #=> String
     #   resp.composition.destinations[0].configuration.s3.encoder_configuration_arns #=> Array
     #   resp.composition.destinations[0].configuration.s3.encoder_configuration_arns[0] #=> String
+    #   resp.composition.destinations[0].configuration.s3.recording_configuration.hls_configuration.target_segment_duration_seconds #=> Integer
     #   resp.composition.destinations[0].configuration.s3.recording_configuration.format #=> String, one of "HLS"
     #   resp.composition.destinations[0].configuration.s3.thumbnail_configurations #=> Array
     #   resp.composition.destinations[0].configuration.s3.thumbnail_configurations[0].target_interval_seconds #=> Integer
@@ -1265,6 +1270,7 @@ module Aws::IVSRealTime
     #   resp.stage.auto_participant_recording_configuration.thumbnail_configuration.storage[0] #=> String, one of "SEQUENTIAL", "LATEST"
     #   resp.stage.auto_participant_recording_configuration.thumbnail_configuration.recording_mode #=> String, one of "INTERVAL", "DISABLED"
     #   resp.stage.auto_participant_recording_configuration.recording_reconnect_window_seconds #=> Integer
+    #   resp.stage.auto_participant_recording_configuration.hls_configuration.target_segment_duration_seconds #=> Integer
     #   resp.stage.endpoints.events #=> String
     #   resp.stage.endpoints.whip #=> String
     #   resp.stage.endpoints.rtmp #=> String
@@ -1980,6 +1986,9 @@ module Aws::IVSRealTime
     #           storage_configuration_arn: "StorageConfigurationArn", # required
     #           encoder_configuration_arns: ["EncoderConfigurationArn"], # required
     #           recording_configuration: {
+    #             hls_configuration: {
+    #               target_segment_duration_seconds: 1,
+    #             },
     #             format: "HLS", # accepts HLS
     #           },
     #           thumbnail_configurations: [
@@ -2027,6 +2036,7 @@ module Aws::IVSRealTime
     #   resp.composition.destinations[0].configuration.s3.storage_configuration_arn #=> String
     #   resp.composition.destinations[0].configuration.s3.encoder_configuration_arns #=> Array
     #   resp.composition.destinations[0].configuration.s3.encoder_configuration_arns[0] #=> String
+    #   resp.composition.destinations[0].configuration.s3.recording_configuration.hls_configuration.target_segment_duration_seconds #=> Integer
     #   resp.composition.destinations[0].configuration.s3.recording_configuration.format #=> String, one of "HLS"
     #   resp.composition.destinations[0].configuration.s3.thumbnail_configurations #=> Array
     #   resp.composition.destinations[0].configuration.s3.thumbnail_configurations[0].target_interval_seconds #=> Integer
@@ -2218,6 +2228,9 @@ module Aws::IVSRealTime
     #         recording_mode: "INTERVAL", # accepts INTERVAL, DISABLED
     #       },
     #       recording_reconnect_window_seconds: 1,
+    #       hls_configuration: {
+    #         target_segment_duration_seconds: 1,
+    #       },
     #     },
     #   })
     #
@@ -2236,6 +2249,7 @@ module Aws::IVSRealTime
     #   resp.stage.auto_participant_recording_configuration.thumbnail_configuration.storage[0] #=> String, one of "SEQUENTIAL", "LATEST"
     #   resp.stage.auto_participant_recording_configuration.thumbnail_configuration.recording_mode #=> String, one of "INTERVAL", "DISABLED"
     #   resp.stage.auto_participant_recording_configuration.recording_reconnect_window_seconds #=> Integer
+    #   resp.stage.auto_participant_recording_configuration.hls_configuration.target_segment_duration_seconds #=> Integer
     #   resp.stage.endpoints.events #=> String
     #   resp.stage.endpoints.whip #=> String
     #   resp.stage.endpoints.rtmp #=> String
@@ -2268,7 +2282,7 @@ module Aws::IVSRealTime
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-ivsrealtime'
-      context[:gem_version] = '1.39.0'
+      context[:gem_version] = '1.40.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-ivsrealtime/client_api.rb

@@ -25,6 +25,8 @@ module Aws::IVSRealTime
     Composition = Shapes::StructureShape.new(name: 'Composition')
     CompositionArn = Shapes::StringShape.new(name: 'CompositionArn')
     CompositionClientToken = Shapes::StringShape.new(name: 'CompositionClientToken')
+    CompositionRecordingHlsConfiguration = Shapes::StructureShape.new(name: 'CompositionRecordingHlsConfiguration')
+    CompositionRecordingTargetSegmentDurationSeconds = Shapes::IntegerShape.new(name: 'CompositionRecordingTargetSegmentDurationSeconds')
     CompositionState = Shapes::StringShape.new(name: 'CompositionState')
     CompositionSummary = Shapes::StructureShape.new(name: 'CompositionSummary')
     CompositionSummaryList = Shapes::ListShape.new(name: 'CompositionSummaryList')
@@ -144,12 +146,14 @@ module Aws::IVSRealTime
     ParticipantList = Shapes::ListShape.new(name: 'ParticipantList')
     ParticipantProtocol = Shapes::StringShape.new(name: 'ParticipantProtocol')
     ParticipantRecordingFilterByRecordingState = Shapes::StringShape.new(name: 'ParticipantRecordingFilterByRecordingState')
+    ParticipantRecordingHlsConfiguration = Shapes::StructureShape.new(name: 'ParticipantRecordingHlsConfiguration')
     ParticipantRecordingMediaType = Shapes::StringShape.new(name: 'ParticipantRecordingMediaType')
     ParticipantRecordingMediaTypeList = Shapes::ListShape.new(name: 'ParticipantRecordingMediaTypeList')
     ParticipantRecordingReconnectWindowSeconds = Shapes::IntegerShape.new(name: 'ParticipantRecordingReconnectWindowSeconds')
     ParticipantRecordingS3BucketName = Shapes::StringShape.new(name: 'ParticipantRecordingS3BucketName')
     ParticipantRecordingS3Prefix = Shapes::StringShape.new(name: 'ParticipantRecordingS3Prefix')
     ParticipantRecordingState = Shapes::StringShape.new(name: 'ParticipantRecordingState')
+    ParticipantRecordingTargetSegmentDurationSeconds = Shapes::IntegerShape.new(name: 'ParticipantRecordingTargetSegmentDurationSeconds')
     ParticipantState = Shapes::StringShape.new(name: 'ParticipantState')
     ParticipantSummary = Shapes::StructureShape.new(name: 'ParticipantSummary')
     ParticipantThumbnailConfiguration = Shapes::StructureShape.new(name: 'ParticipantThumbnailConfiguration')
@@ -251,6 +255,7 @@ module Aws::IVSRealTime
     AutoParticipantRecordingConfiguration.add_member(:media_types, Shapes::ShapeRef.new(shape: ParticipantRecordingMediaTypeList, location_name: "mediaTypes"))
     AutoParticipantRecordingConfiguration.add_member(:thumbnail_configuration, Shapes::ShapeRef.new(shape: ParticipantThumbnailConfiguration, location_name: "thumbnailConfiguration"))
     AutoParticipantRecordingConfiguration.add_member(:recording_reconnect_window_seconds, Shapes::ShapeRef.new(shape: ParticipantRecordingReconnectWindowSeconds, location_name: "recordingReconnectWindowSeconds"))
+    AutoParticipantRecordingConfiguration.add_member(:hls_configuration, Shapes::ShapeRef.new(shape: ParticipantRecordingHlsConfiguration, location_name: "hlsConfiguration"))
     AutoParticipantRecordingConfiguration.struct_class = Types::AutoParticipantRecordingConfiguration
 
     ChannelDestinationConfiguration.add_member(:channel_arn, Shapes::ShapeRef.new(shape: ChannelArn, required: true, location_name: "channelArn"))
@@ -267,6 +272,9 @@ module Aws::IVSRealTime
     Composition.add_member(:end_time, Shapes::ShapeRef.new(shape: Time, location_name: "endTime"))
     Composition.struct_class = Types::Composition
 
+    CompositionRecordingHlsConfiguration.add_member(:target_segment_duration_seconds, Shapes::ShapeRef.new(shape: CompositionRecordingTargetSegmentDurationSeconds, location_name: "targetSegmentDurationSeconds"))
+    CompositionRecordingHlsConfiguration.struct_class = Types::CompositionRecordingHlsConfiguration
+
     CompositionSummary.add_member(:arn, Shapes::ShapeRef.new(shape: CompositionArn, required: true, location_name: "arn"))
     CompositionSummary.add_member(:stage_arn, Shapes::ShapeRef.new(shape: StageArn, required: true, location_name: "stageArn"))
     CompositionSummary.add_member(:destinations, Shapes::ShapeRef.new(shape: DestinationSummaryList, required: true, location_name: "destinations"))
@@ -647,6 +655,9 @@ module Aws::IVSRealTime
 
     ParticipantList.member = Shapes::ShapeRef.new(shape: ParticipantSummary)
 
+    ParticipantRecordingHlsConfiguration.add_member(:target_segment_duration_seconds, Shapes::ShapeRef.new(shape: ParticipantRecordingTargetSegmentDurationSeconds, location_name: "targetSegmentDurationSeconds"))
+    ParticipantRecordingHlsConfiguration.struct_class = Types::ParticipantRecordingHlsConfiguration
+
     ParticipantRecordingMediaTypeList.member = Shapes::ShapeRef.new(shape: ParticipantRecordingMediaType)
 
     ParticipantSummary.add_member(:participant_id, Shapes::ShapeRef.new(shape: ParticipantId, location_name: "participantId"))
@@ -723,6 +734,7 @@ module Aws::IVSRealTime
     PublicKeySummary.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "tags"))
     PublicKeySummary.struct_class = Types::PublicKeySummary
 
+    RecordingConfiguration.add_member(:hls_configuration, Shapes::ShapeRef.new(shape: CompositionRecordingHlsConfiguration, location_name: "hlsConfiguration"))
     RecordingConfiguration.add_member(:format, Shapes::ShapeRef.new(shape: RecordingConfigurationFormat, location_name: "format"))
     RecordingConfiguration.struct_class = Types::RecordingConfiguration
 

data/lib/aws-sdk-ivsrealtime/types.rb

@@ -85,13 +85,18 @@ module Aws::IVSRealTime
     #   The default value is 0, which disables merging.
     #   @return [Integer]
     #
+    # @!attribute [rw] hls_configuration
+    #   HLS configuration object for individual participant recording.
+    #   @return [Types::ParticipantRecordingHlsConfiguration]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/AutoParticipantRecordingConfiguration AWS API Documentation
     #
     class AutoParticipantRecordingConfiguration < Struct.new(
       :storage_configuration_arn,
       :media_types,
       :thumbnail_configuration,
-      :recording_reconnect_window_seconds)
+      :recording_reconnect_window_seconds,
+      :hls_configuration)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -179,6 +184,24 @@ module Aws::IVSRealTime
       include Aws::Structure
     end
 
+    # An object representing a configuration of HLS recordings for
+    # server-side composition.
+    #
+    # @!attribute [rw] target_segment_duration_seconds
+    #   Defines the target duration for recorded segments generated when
+    #   using composite recording. Segments may have durations shorter than
+    #   the specified value when needed to ensure each segment begins with a
+    #   keyframe. Default: 2.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/CompositionRecordingHlsConfiguration AWS API Documentation
+    #
+    class CompositionRecordingHlsConfiguration < Struct.new(
+      :target_segment_duration_seconds)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Summary information about a Composition.
     #
     # @!attribute [rw] arn
@@ -1974,12 +1997,7 @@ module Aws::IVSRealTime
     # @!attribute [rw] recording_s3_prefix
     #   S3 prefix of the S3 bucket where the participant is being recorded,
     #   if individual participant recording is enabled, or `""` (empty
-    #   string), if recording is not enabled. If individual participant
-    #   recording merge is enabled, and if a stage publisher disconnects
-    #   from a stage and then reconnects, IVS tries to record to the same S3
-    #   prefix as the previous session. See [ Merge Fragmented Individual
-    #   Participant
-    #   Recordings](/ivs/latest/RealTimeUserGuide/rt-individual-participant-recording.html#ind-part-rec-merge-frag).
+    #   string), if recording is not enabled.
     #   @return [String]
     #
     # @!attribute [rw] recording_state
@@ -2014,6 +2032,24 @@ module Aws::IVSRealTime
       include Aws::Structure
     end
 
+    # An object representing a configuration of participant HLS recordings
+    # for individual participant recording.
+    #
+    # @!attribute [rw] target_segment_duration_seconds
+    #   Defines the target duration for recorded segments generated when
+    #   recording a stage participant. Segments may have durations longer
+    #   than the specified value when needed to ensure each segment begins
+    #   with a keyframe. Default: 6.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/ParticipantRecordingHlsConfiguration AWS API Documentation
+    #
+    class ParticipantRecordingHlsConfiguration < Struct.new(
+      :target_segment_duration_seconds)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Summary object describing a participant that has joined a stage.
     #
     # @!attribute [rw] participant_id
@@ -2393,6 +2429,11 @@ module Aws::IVSRealTime
 
     # An object representing a configuration to record a stage stream.
     #
+    # @!attribute [rw] hls_configuration
+    #   An HLS configuration object to return information about how the
+    #   recording will be configured.
+    #   @return [Types::CompositionRecordingHlsConfiguration]
+    #
     # @!attribute [rw] format
     #   The recording format for storing a recording in Amazon S3.
     #   @return [String]
@@ -2400,6 +2441,7 @@ module Aws::IVSRealTime
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/RecordingConfiguration AWS API Documentation
     #
     class RecordingConfiguration < Struct.new(
+      :hls_configuration,
       :format)
       SENSITIVE = []
       include Aws::Structure

data/lib/aws-sdk-ivsrealtime.rb

@@ -55,7 +55,7 @@ module Aws::IVSRealTime
   autoload :EndpointProvider, 'aws-sdk-ivsrealtime/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-ivsrealtime/endpoints'
 
-  GEM_VERSION = '1.39.0'
+  GEM_VERSION = '1.40.0'
 
 end
 

data/sig/client.rbs

@@ -149,7 +149,10 @@ module Aws
                               storage: Array[("SEQUENTIAL" | "LATEST")]?,
                               recording_mode: ("INTERVAL" | "DISABLED")?
                             }?,
-                            recording_reconnect_window_seconds: ::Integer?
+                            recording_reconnect_window_seconds: ::Integer?,
+                            hls_configuration: {
+                              target_segment_duration_seconds: ::Integer?
+                            }?
                           }
                         ) -> _CreateStageResponseSuccess
                       | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CreateStageResponseSuccess
@@ -492,6 +495,9 @@ module Aws
                                      storage_configuration_arn: ::String,
                                      encoder_configuration_arns: Array[::String],
                                      recording_configuration: {
+                                       hls_configuration: {
+                                         target_segment_duration_seconds: ::Integer?
+                                       }?,
                                        format: ("HLS")?
                                      }?,
                                      thumbnail_configurations: Array[
@@ -563,7 +569,10 @@ module Aws
                               storage: Array[("SEQUENTIAL" | "LATEST")]?,
                               recording_mode: ("INTERVAL" | "DISABLED")?
                             }?,
-                            recording_reconnect_window_seconds: ::Integer?
+                            recording_reconnect_window_seconds: ::Integer?,
+                            hls_configuration: {
+                              target_segment_duration_seconds: ::Integer?
+                            }?
                           }
                         ) -> _UpdateStageResponseSuccess
                       | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _UpdateStageResponseSuccess

data/sig/types.rbs

@@ -26,6 +26,7 @@ module Aws::IVSRealTime
       attr_accessor media_types: ::Array[("AUDIO_VIDEO" | "AUDIO_ONLY" | "NONE")]
       attr_accessor thumbnail_configuration: Types::ParticipantThumbnailConfiguration
       attr_accessor recording_reconnect_window_seconds: ::Integer
+      attr_accessor hls_configuration: Types::ParticipantRecordingHlsConfiguration
       SENSITIVE: []
     end
 
@@ -47,6 +48,11 @@ module Aws::IVSRealTime
       SENSITIVE: []
     end
 
+    class CompositionRecordingHlsConfiguration
+      attr_accessor target_segment_duration_seconds: ::Integer
+      SENSITIVE: []
+    end
+
     class CompositionSummary
       attr_accessor arn: ::String
       attr_accessor stage_arn: ::String
@@ -550,6 +556,11 @@ module Aws::IVSRealTime
       SENSITIVE: []
     end
 
+    class ParticipantRecordingHlsConfiguration
+      attr_accessor target_segment_duration_seconds: ::Integer
+      SENSITIVE: []
+    end
+
     class ParticipantSummary
       attr_accessor participant_id: ::String
       attr_accessor user_id: ::String
@@ -630,6 +641,7 @@ module Aws::IVSRealTime
     end
 
     class RecordingConfiguration
+      attr_accessor hls_configuration: Types::CompositionRecordingHlsConfiguration
       attr_accessor format: ("HLS")
       SENSITIVE: []
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-ivsrealtime
 version: !ruby/object:Gem::Version
-  version: 1.39.0
+  version: 1.40.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-03-06 00:00:00.000000000 Z
+date: 2025-03-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core