aws-sdk-kinesisvideoarchivedmedia 1.7.0 → 1.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d637f051b92a8a03175f281802ddb9a518661034
-  data.tar.gz: 746e1ca0067e1f7e21ba7ea1c5746c3ab5930876
+  metadata.gz: d96dd21124299a0b8e22cce249696a6249f51fa6
+  data.tar.gz: 7c70e7cb8858d1693092fd9794bff62ef6c9ce82
 SHA512:
-  metadata.gz: 70b4048d7a10bbd8be6692dc0e640b1294fbf082086e0f2590ff01931faf4b797d7bfd362a3d036b810d67a508aeac4a92834a0055dbd72adbf15d69f0d167a3
-  data.tar.gz: 3ebf35e31ec1925b9e16edeb702fd08d22d224bf8589396c706fb93e9b867f5bc587cd646864a18e7e2b0c526ab1618fdede0a8be0497de51e0cf68460748322
+  metadata.gz: 8987eae705f6a47006e6de97f93665a380eddea2734ae60017fd20f4cd0261fdbbef59f276330a478374e4321452c30214ded56cff1b710d6ea6e8f0c50ee0cf
+  data.tar.gz: 056fbdb5ba8e4b87a7346a028d363157575ac60438f49dad11b8227a77e610fc048b61b501b402412b4cf14c37a595243c90c713a2320557e58a5536be7afdfb

data/lib/aws-sdk-kinesisvideoarchivedmedia.rb

@@ -42,6 +42,6 @@ require_relative 'aws-sdk-kinesisvideoarchivedmedia/customizations'
 # @service
 module Aws::KinesisVideoArchivedMedia
 
-  GEM_VERSION = '1.7.0'
+  GEM_VERSION = '1.8.0'
 
 end

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

@@ -214,25 +214,32 @@ module Aws::KinesisVideoArchivedMedia
     # An Amazon Kinesis video stream has the following requirements for
     # providing data through HLS:
     #
-    # * The media type must be `video/h264`.
+    # * The media must contain h.264 encoded video and, optionally, AAC
+    #   encoded audio. Specifically, the codec id of track 1 should be
+    #   `V_MPEG/ISO/AVC`. Optionally, the codec id of track 2 should be
+    #   `A_AAC`.
     #
     # * Data retention must be greater than 0.
     #
-    # * The fragments must contain codec private data in the AVC (Advanced
-    #   Video Coding) for H.264 format ([MPEG-4 specification ISO/IEC
-    #   14496-15][1]). For information about adapting stream data to a given
-    #   format, see [NAL Adaptation Flags][2].
+    # * The video track of each fragment must contain codec private data in
+    #   the Advanced Video Coding (AVC) for H.264 format ([MPEG-4
+    #   specification ISO/IEC 14496-15][1]). For information about adapting
+    #   stream data to a given format, see [NAL Adaptation Flags][2].
+    #
+    # * The audio track (if present) of each fragment must contain codec
+    #   private data in the AAC format ([AAC specification ISO/IEC
+    #   13818-7][3]).
     #
     # Kinesis Video Streams HLS sessions contain fragments in the fragmented
     # MPEG-4 form (also called fMP4 or CMAF), rather than the MPEG-2 form
     # (also called TS chunks, which the HLS specification also supports).
     # For more information about HLS fragment types, see the [HLS
-    # specification][3].
+    # specification][4].
     #
     # The following procedure shows how to use HLS with Kinesis Video
     # Streams:
     #
-    # 1.  Get an endpoint using [GetDataEndpoint][4], specifying
+    # 1.  Get an endpoint using [GetDataEndpoint][5], specifying
     #     `GET_HLS_STREAMING_SESSION_URL` for the `APIName` parameter.
     #
     # 2.  Retrieve the HLS URL using `GetHLSStreamingSessionURL`. Kinesis
@@ -253,7 +260,7 @@ module Aws::KinesisVideoArchivedMedia
     #     The media that is made available through the playlist consists
     #     only of the requested stream, time range, and format. No other
     #     media data (such as frames outside the requested window or
-    #     alternate bit rates) is made available.
+    #     alternate bitrates) is made available.
     #
     # 3.  Provide the URL (containing the encrypted session token) for the
     #     HLS master playlist to a media player that supports the HLS
@@ -261,17 +268,17 @@ module Aws::KinesisVideoArchivedMedia
     #     initialization fragment, and media fragments available through the
     #     master playlist URL. The initialization fragment contains the
     #     codec private data for the stream, and other data needed to set up
-    #     the video decoder and renderer. The media fragments contain
-    #     H.264-encoded video frames and time stamps.
+    #     the video or audio decoder and renderer. The media fragments
+    #     contain H.264-encoded video frames or AAC-encoded audio samples.
     #
     # 4.  The media player receives the authenticated URL and requests
     #     stream metadata and media data normally. When the media player
     #     requests data, it calls the following actions:
     #
     #     * **GetHLSMasterPlaylist:** Retrieves an HLS master playlist,
-    #       which contains a URL for the `GetHLSMediaPlaylist` action, and
-    #       additional metadata for the media player, including estimated
-    #       bit rate and resolution.
+    #       which contains a URL for the `GetHLSMediaPlaylist` action for
+    #       each track, and additional metadata for the media player,
+    #       including estimated bitrate and resolution.
     #
     #     * **GetHLSMediaPlaylist:** Retrieves an HLS media playlist, which
     #       contains a URL to access the MP4 initialization fragment with
@@ -282,7 +289,9 @@ module Aws::KinesisVideoArchivedMedia
     #       `LIVE` or `ON_DEMAND`. The HLS media playlist is typically
     #       static for sessions with a `PlaybackType` of `ON_DEMAND`. The
     #       HLS media playlist is continually updated with new fragments for
-    #       sessions with a `PlaybackType` of `LIVE`.
+    #       sessions with a `PlaybackType` of `LIVE`. There is a distinct
+    #       HLS media playlist for the video track and the audio track (if
+    #       applicable) that contains MP4 media URLs for the specific track.
     #
     #     * **GetMP4InitFragment:** Retrieves the MP4 initialization
     #       fragment. The media player typically loads the initialization
@@ -292,32 +301,45 @@ module Aws::KinesisVideoArchivedMedia
     #
     #       The initialization fragment does not correspond to a fragment in
     #       a Kinesis video stream. It contains only the codec private data
-    #       for the stream, which the media player needs to decode video
-    #       frames.
+    #       for the stream and respective track, which the media player
+    #       needs to decode the media frames.
     #
     #     * **GetMP4MediaFragment:** Retrieves MP4 media fragments. These
     #       fragments contain the "`moof`" and "`mdat`" MP4 atoms and
-    #       their child atoms, containing the encoded fragment's video
-    #       frames and their time stamps.
+    #       their child atoms, containing the encoded fragment's media
+    #       frames and their timestamps.
     #
     #       <note markdown="1"> After the first media fragment is made available in a streaming
     #       session, any fragments that don't contain the same codec
-    #       private data are excluded in the HLS media playlist. Therefore,
-    #       the codec private data does not change between fragments in a
-    #       session.
+    #       private data cause an error to be returned when those different
+    #       media fragments are loaded. Therefore, the codec private data
+    #       should not change between fragments in a session. This also
+    #       means that the session fails if the fragments in a stream change
+    #       from having only video to having both audio and video.
+    #
+    #        </note>
+    #
+    #       Data retrieved with this action is billable. See [Pricing][6]
+    #       for details.
+    #
+    #     * **GetTSFragment:** Retrieves MPEG TS fragments containing both
+    #       initialization and media data for all tracks in the stream.
+    #
+    #       <note markdown="1"> If the `ContainerFormat` is `MPEG_TS`, this API is used instead
+    #       of `GetMP4InitFragment` and `GetMP4MediaFragment` to retrieve
+    #       stream media.
     #
     #        </note>
     #
-    #       Data retrieved with this action is billable. See
-    #       [Pricing](aws.amazon.comkinesis/video-streams/pricing/) for
-    #       details.
+    #       Data retrieved with this action is billable. For more
+    #       information, see [Kinesis Video Streams pricing][6].
     #
     # <note markdown="1"> The following restrictions apply to HLS sessions:
     #
     #  * A streaming session URL should not be shared between players. The
     #   service might throttle a session if multiple media players are
     #   sharing it. For connection limits, see [Kinesis Video Streams
-    #   Limits][5].
+    #   Limits][7].
     #
     # * A Kinesis video stream can have a maximum of five active HLS
     #   streaming sessions. If a new session is created when the maximum
@@ -332,26 +354,27 @@ module Aws::KinesisVideoArchivedMedia
     # You can monitor the amount of data that the media player consumes by
     # monitoring the `GetMP4MediaFragment.OutgoingBytes` Amazon CloudWatch
     # metric. For information about using CloudWatch to monitor Kinesis
-    # Video Streams, see [Monitoring Kinesis Video Streams][6]. For pricing
-    # information, see [Amazon Kinesis Video Streams Pricing][7] and [AWS
-    # Pricing][8]. Charges for both HLS sessions and outgoing AWS data
+    # Video Streams, see [Monitoring Kinesis Video Streams][8]. For pricing
+    # information, see [Amazon Kinesis Video Streams Pricing][6] and [AWS
+    # Pricing][9]. Charges for both HLS sessions and outgoing AWS data
     # apply.
     #
-    # For more information about HLS, see [HTTP Live Streaming][9] on the
-    # [Apple Developer site][10].
+    # For more information about HLS, see [HTTP Live Streaming][10] on the
+    # [Apple Developer site][11].
     #
     #
     #
     # [1]: https://www.iso.org/standard/55980.html
-    # [2]: http://docs.aws.amazon.com/kinesisvideostreams/latest/dg/latest/dg/producer-reference-nal.html
-    # [3]: https://tools.ietf.org/html/draft-pantos-http-live-streaming-23
-    # [4]: http://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_GetDataEndpoint.html
-    # [5]: http://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html
-    # [6]: http://docs.aws.amazon.com/kinesisvideostreams/latest/dg/monitoring.html
-    # [7]: https://aws.amazon.com/kinesis/video-streams/pricing/
-    # [8]: https://aws.amazon.com/pricing/
-    # [9]: https://developer.apple.com/streaming/
-    # [10]: https://developer.apple.com
+    # [2]: http://docs.aws.amazon.com/kinesisvideostreams/latest/dg/producer-reference-nal.html
+    # [3]: https://www.iso.org/standard/43345.html
+    # [4]: https://tools.ietf.org/html/draft-pantos-http-live-streaming-23
+    # [5]: http://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_GetDataEndpoint.html
+    # [6]: https://aws.amazon.com/kinesis/video-streams/pricing/
+    # [7]: http://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html
+    # [8]: http://docs.aws.amazon.com/kinesisvideostreams/latest/dg/monitoring.html
+    # [9]: https://aws.amazon.com/pricing/
+    # [10]: https://developer.apple.com/streaming/
+    # [11]: https://developer.apple.com
     #
     # @option params [String] :stream_name
     #   The name of the stream for which to retrieve the HLS master playlist
@@ -399,18 +422,18 @@ module Aws::KinesisVideoArchivedMedia
     #
     #   In both playback modes, if `FragmentSelectorType` is
     #   `PRODUCER_TIMESTAMP`, and if there are multiple fragments with the
-    #   same start time stamp, the fragment that has the larger fragment
-    #   number (that is, the newer fragment) is included in the HLS media
-    #   playlist. The other fragments are not included. Fragments that have
-    #   different time stamps but have overlapping durations are still
-    #   included in the HLS media playlist. This can lead to unexpected
-    #   behavior in the media player.
+    #   same start timestamp, the fragment that has the larger fragment number
+    #   (that is, the newer fragment) is included in the HLS media playlist.
+    #   The other fragments are not included. Fragments that have different
+    #   timestamps but have overlapping durations are still included in the
+    #   HLS media playlist. This can lead to unexpected behavior in the media
+    #   player.
     #
     #   The default is `LIVE`.
     #
     # @option params [Types::HLSFragmentSelector] :hls_fragment_selector
-    #   The time range of the requested fragment, and the source of the time
-    #   stamps.
+    #   The time range of the requested fragment, and the source of the
+    #   timestamps.
     #
     #   This parameter is required if `PlaybackMode` is `ON_DEMAND`. This
     #   parameter is optional if `PlaybackMode` is `LIVE`. If `PlaybackMode`
@@ -418,6 +441,19 @@ module Aws::KinesisVideoArchivedMedia
     #   `TimestampRange` should not be set. If `PlaybackMode` is `ON_DEMAND`,
     #   both `FragmentSelectorType` and `TimestampRange` must be set.
     #
+    # @option params [String] :container_format
+    #   Specifies which format should be used for packaging the media.
+    #   Specifying the `FRAGMENTED_MP4` container format packages the media
+    #   into MP4 fragments (fMP4 or CMAF). This is the recommended packaging
+    #   because there is minimal packaging overhead. The other container
+    #   format option is `MPEG_TS`. HLS has supported MPEG TS chunks since it
+    #   was released and is sometimes the only supported packaging on older
+    #   HLS players. MPEG TS typically has a 5-25 percent packaging overhead.
+    #   This means MPEG TS typically requires 5-25 percent more bandwidth and
+    #   cost than fMP4.
+    #
+    #   The default is `FRAGMENTED_MP4`.
+    #
     # @option params [String] :discontinuity_mode
     #   Specifies when flags marking discontinuities between fragments will be
     #   added to the media playlists. The default is `ALWAYS` when
@@ -425,17 +461,33 @@ module Aws::KinesisVideoArchivedMedia
     #   `PRODUCER_TIMESTAMP`.
     #
     #   Media players typically build a timeline of media content to play,
-    #   based on the time stamps of each fragment. This means that if there is
+    #   based on the timestamps of each fragment. This means that if there is
     #   any overlap between fragments (as is typical if HLSFragmentSelector is
     #   `SERVER_TIMESTAMP`), the media player timeline has small gaps between
     #   fragments in some places, and overwrites frames in other places. When
     #   there are discontinuity flags between fragments, the media player is
     #   expected to reset the timeline, resulting in the fragment being played
     #   immediately after the previous fragment. We recommend that you always
-    #   have discontinuity flags between fragments if the fragment time stamps
+    #   have discontinuity flags between fragments if the fragment timestamps
     #   are not accurate or if fragments might be missing. You should not
     #   place discontinuity flags between fragments for the player timeline to
-    #   accurately map to the producer time stamps.
+    #   accurately map to the producer timestamps.
+    #
+    # @option params [String] :display_fragment_timestamp
+    #   Specifies when the fragment start timestamps should be included in the
+    #   HLS media playlist. Typically, media players report the playhead
+    #   position as a time relative to the start of the first fragment in the
+    #   playback session. However, when the start timestamps are included in
+    #   the HLS media playlist, some media players might report the current
+    #   playhead as an absolute time based on the fragment timestamps. This
+    #   can be useful for creating a playback experience that shows viewers
+    #   the wall-clock time of the media.
+    #
+    #   The default is `NEVER`. When HLSFragmentSelector is
+    #   `SERVER_TIMESTAMP`, the timestamps will be the server start
+    #   timestamps. Similarly, when HLSFragmentSelector is
+    #   `PRODUCER_TIMESTAMP`, the timestamps will be the producer start
+    #   timestamps.
     #
     # @option params [Integer] :expires
     #   The time in seconds until the requested session expires. This value
@@ -486,7 +538,9 @@ module Aws::KinesisVideoArchivedMedia
     #         end_timestamp: Time.now,
     #       },
     #     },
+    #     container_format: "FRAGMENTED_MP4", # accepts FRAGMENTED_MP4, MPEG_TS
     #     discontinuity_mode: "ALWAYS", # accepts ALWAYS, NEVER
+    #     display_fragment_timestamp: "ALWAYS", # accepts ALWAYS, NEVER
     #     expires: 1,
     #     max_media_playlist_fragment_results: 1,
     #   })
@@ -507,6 +561,12 @@ module Aws::KinesisVideoArchivedMedia
     # Gets media for a list of fragments (specified by fragment number) from
     # the archived data in an Amazon Kinesis video stream.
     #
+    # <note markdown="1"> You must first call the `GetDataEndpoint` API to get an endpoint. Then
+    # send the `GetMediaForFragmentList` requests to this endpoint using the
+    # [--endpoint-url parameter][1].
+    #
+    #  </note>
+    #
     # The following limits apply when using the `GetMediaForFragmentList`
     # API:
     #
@@ -517,6 +577,10 @@ module Aws::KinesisVideoArchivedMedia
     #   megabytes per second (or 200 megabits per second) during a
     #   `GetMediaForFragmentList` session.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/cli/latest/reference/
+    #
     # @option params [required, String] :stream_name
     #   The name of the stream from which to retrieve fragment media.
     #
@@ -550,8 +614,24 @@ module Aws::KinesisVideoArchivedMedia
       req.send_request(options, &block)
     end
 
-    # Returns a list of Fragment objects from the specified stream and start
-    # location within the archived data.
+    # Returns a list of Fragment objects from the specified stream and
+    # timestamp range within the archived data.
+    #
+    # Listing fragments is eventually consistent. This means that even if
+    # the producer receives an acknowledgment that a fragment is persisted,
+    # the result might not be returned immediately from a request to
+    # `ListFragments`. However, results are typically available in less than
+    # one second.
+    #
+    # <note markdown="1"> You must first call the `GetDataEndpoint` API to get an endpoint. Then
+    # send the `ListFragments` requests to this endpoint using the
+    # [--endpoint-url parameter][1].
+    #
+    #  </note>
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/cli/latest/reference/
     #
     # @option params [required, String] :stream_name
     #   The name of the stream from which to retrieve a fragment list.
@@ -567,7 +647,7 @@ module Aws::KinesisVideoArchivedMedia
     #   ListFragmentsOutput$NextToken from a previously truncated response.
     #
     # @option params [Types::FragmentSelector] :fragment_selector
-    #   Describes the time stamp range and time stamp origin for the range of
+    #   Describes the timestamp range and timestamp origin for the range of
     #   fragments to return.
     #
     # @return [Types::ListFragmentsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -622,7 +702,7 @@ module Aws::KinesisVideoArchivedMedia
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-kinesisvideoarchivedmedia'
-      context[:gem_version] = '1.7.0'
+      context[:gem_version] = '1.8.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -12,8 +12,10 @@ module Aws::KinesisVideoArchivedMedia
     include Seahorse::Model
 
     ClientLimitExceededException = Shapes::StructureShape.new(name: 'ClientLimitExceededException')
+    ContainerFormat = Shapes::StringShape.new(name: 'ContainerFormat')
     ContentType = Shapes::StringShape.new(name: 'ContentType')
     DiscontinuityMode = Shapes::StringShape.new(name: 'DiscontinuityMode')
+    DisplayFragmentTimestamp = Shapes::StringShape.new(name: 'DisplayFragmentTimestamp')
     ErrorMessage = Shapes::StringShape.new(name: 'ErrorMessage')
     Expires = Shapes::IntegerShape.new(name: 'Expires')
     Fragment = Shapes::StructureShape.new(name: 'Fragment')
@@ -68,7 +70,9 @@ module Aws::KinesisVideoArchivedMedia
     GetHLSStreamingSessionURLInput.add_member(:stream_arn, Shapes::ShapeRef.new(shape: ResourceARN, location_name: "StreamARN"))
     GetHLSStreamingSessionURLInput.add_member(:playback_mode, Shapes::ShapeRef.new(shape: PlaybackMode, location_name: "PlaybackMode"))
     GetHLSStreamingSessionURLInput.add_member(:hls_fragment_selector, Shapes::ShapeRef.new(shape: HLSFragmentSelector, location_name: "HLSFragmentSelector"))
+    GetHLSStreamingSessionURLInput.add_member(:container_format, Shapes::ShapeRef.new(shape: ContainerFormat, location_name: "ContainerFormat"))
     GetHLSStreamingSessionURLInput.add_member(:discontinuity_mode, Shapes::ShapeRef.new(shape: DiscontinuityMode, location_name: "DiscontinuityMode"))
+    GetHLSStreamingSessionURLInput.add_member(:display_fragment_timestamp, Shapes::ShapeRef.new(shape: DisplayFragmentTimestamp, location_name: "DisplayFragmentTimestamp"))
     GetHLSStreamingSessionURLInput.add_member(:expires, Shapes::ShapeRef.new(shape: Expires, location_name: "Expires"))
     GetHLSStreamingSessionURLInput.add_member(:max_media_playlist_fragment_results, Shapes::ShapeRef.new(shape: PageLimit, location_name: "MaxMediaPlaylistFragmentResults"))
     GetHLSStreamingSessionURLInput.struct_class = Types::GetHLSStreamingSessionURLInput

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

@@ -20,11 +20,11 @@ module Aws::KinesisVideoArchivedMedia
     #   @return [Integer]
     #
     # @!attribute [rw] producer_timestamp
-    #   The time stamp from the producer corresponding to the fragment.
+    #   The timestamp from the producer corresponding to the fragment.
     #   @return [Time]
     #
     # @!attribute [rw] server_timestamp
-    #   The time stamp from the AWS server corresponding to the fragment.
+    #   The timestamp from the AWS server corresponding to the fragment.
     #   @return [Time]
     #
     # @!attribute [rw] fragment_length_in_milliseconds
@@ -43,9 +43,26 @@ module Aws::KinesisVideoArchivedMedia
       include Aws::Structure
     end
 
-    # Describes the time stamp range and time stamp origin of a range of
+    # Describes the timestamp range and timestamp origin of a range of
     # fragments.
     #
+    # Only fragments with a start timestamp greater than or equal to the
+    # given start time and less than or equal to the end time are returned.
+    # For example, if a stream contains fragments with the following start
+    # timestamps:
+    #
+    # * 00:00:00
+    #
+    # * 00:00:02
+    #
+    # * 00:00:04
+    #
+    # * 00:00:06
+    #
+    # A fragment selector range with a start time of 00:00:01 and end time
+    # of 00:00:04 would return the fragments with start times of 00:00:02
+    # and 00:00:04.
+    #
     # @note When making an API call, you may pass FragmentSelector
     #   data as a hash:
     #
@@ -58,11 +75,11 @@ module Aws::KinesisVideoArchivedMedia
     #       }
     #
     # @!attribute [rw] fragment_selector_type
-    #   The origin of the time stamps to use (Server or Producer).
+    #   The origin of the timestamps to use (Server or Producer).
     #   @return [String]
     #
     # @!attribute [rw] timestamp_range
-    #   The range of time stamps to return.
+    #   The range of timestamps to return.
     #   @return [Types::TimestampRange]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-video-archived-media-2017-09-30/FragmentSelector AWS API Documentation
@@ -87,7 +104,9 @@ module Aws::KinesisVideoArchivedMedia
     #             end_timestamp: Time.now,
     #           },
     #         },
+    #         container_format: "FRAGMENTED_MP4", # accepts FRAGMENTED_MP4, MPEG_TS
     #         discontinuity_mode: "ALWAYS", # accepts ALWAYS, NEVER
+    #         display_fragment_timestamp: "ALWAYS", # accepts ALWAYS, NEVER
     #         expires: 1,
     #         max_media_playlist_fragment_results: 1,
     #       }
@@ -142,10 +161,10 @@ module Aws::KinesisVideoArchivedMedia
     #
     #   In both playback modes, if `FragmentSelectorType` is
     #   `PRODUCER_TIMESTAMP`, and if there are multiple fragments with the
-    #   same start time stamp, the fragment that has the larger fragment
+    #   same start timestamp, the fragment that has the larger fragment
     #   number (that is, the newer fragment) is included in the HLS media
     #   playlist. The other fragments are not included. Fragments that have
-    #   different time stamps but have overlapping durations are still
+    #   different timestamps but have overlapping durations are still
     #   included in the HLS media playlist. This can lead to unexpected
     #   behavior in the media player.
     #
@@ -153,8 +172,8 @@ module Aws::KinesisVideoArchivedMedia
     #   @return [String]
     #
     # @!attribute [rw] hls_fragment_selector
-    #   The time range of the requested fragment, and the source of the time
-    #   stamps.
+    #   The time range of the requested fragment, and the source of the
+    #   timestamps.
     #
     #   This parameter is required if `PlaybackMode` is `ON_DEMAND`. This
     #   parameter is optional if `PlaybackMode` is `LIVE`. If `PlaybackMode`
@@ -164,6 +183,20 @@ module Aws::KinesisVideoArchivedMedia
     #   be set.
     #   @return [Types::HLSFragmentSelector]
     #
+    # @!attribute [rw] container_format
+    #   Specifies which format should be used for packaging the media.
+    #   Specifying the `FRAGMENTED_MP4` container format packages the media
+    #   into MP4 fragments (fMP4 or CMAF). This is the recommended packaging
+    #   because there is minimal packaging overhead. The other container
+    #   format option is `MPEG_TS`. HLS has supported MPEG TS chunks since
+    #   it was released and is sometimes the only supported packaging on
+    #   older HLS players. MPEG TS typically has a 5-25 percent packaging
+    #   overhead. This means MPEG TS typically requires 5-25 percent more
+    #   bandwidth and cost than fMP4.
+    #
+    #   The default is `FRAGMENTED_MP4`.
+    #   @return [String]
+    #
     # @!attribute [rw] discontinuity_mode
     #   Specifies when flags marking discontinuities between fragments will
     #   be added to the media playlists. The default is `ALWAYS` when
@@ -171,7 +204,7 @@ module Aws::KinesisVideoArchivedMedia
     #   `PRODUCER_TIMESTAMP`.
     #
     #   Media players typically build a timeline of media content to play,
-    #   based on the time stamps of each fragment. This means that if there
+    #   based on the timestamps of each fragment. This means that if there
     #   is any overlap between fragments (as is typical if
     #   HLSFragmentSelector is `SERVER_TIMESTAMP`), the media player
     #   timeline has small gaps between fragments in some places, and
@@ -179,10 +212,27 @@ module Aws::KinesisVideoArchivedMedia
     #   flags between fragments, the media player is expected to reset the
     #   timeline, resulting in the fragment being played immediately after
     #   the previous fragment. We recommend that you always have
-    #   discontinuity flags between fragments if the fragment time stamps
-    #   are not accurate or if fragments might be missing. You should not
-    #   place discontinuity flags between fragments for the player timeline
-    #   to accurately map to the producer time stamps.
+    #   discontinuity flags between fragments if the fragment timestamps are
+    #   not accurate or if fragments might be missing. You should not place
+    #   discontinuity flags between fragments for the player timeline to
+    #   accurately map to the producer timestamps.
+    #   @return [String]
+    #
+    # @!attribute [rw] display_fragment_timestamp
+    #   Specifies when the fragment start timestamps should be included in
+    #   the HLS media playlist. Typically, media players report the playhead
+    #   position as a time relative to the start of the first fragment in
+    #   the playback session. However, when the start timestamps are
+    #   included in the HLS media playlist, some media players might report
+    #   the current playhead as an absolute time based on the fragment
+    #   timestamps. This can be useful for creating a playback experience
+    #   that shows viewers the wall-clock time of the media.
+    #
+    #   The default is `NEVER`. When HLSFragmentSelector is
+    #   `SERVER_TIMESTAMP`, the timestamps will be the server start
+    #   timestamps. Similarly, when HLSFragmentSelector is
+    #   `PRODUCER_TIMESTAMP`, the timestamps will be the producer start
+    #   timestamps.
     #   @return [String]
     #
     # @!attribute [rw] expires
@@ -226,7 +276,9 @@ module Aws::KinesisVideoArchivedMedia
       :stream_arn,
       :playback_mode,
       :hls_fragment_selector,
+      :container_format,
       :discontinuity_mode,
+      :display_fragment_timestamp,
       :expires,
       :max_media_playlist_fragment_results)
       include Aws::Structure
@@ -283,11 +335,11 @@ module Aws::KinesisVideoArchivedMedia
     #   * AWS\_KINESISVIDEO\_FRAGMENT\_NUMBER - Fragment number returned in
     #     the chunk.
     #
-    #   * AWS\_KINESISVIDEO\_SERVER\_SIDE\_TIMESTAMP - Server-side time
-    #     stamp of the fragment.
+    #   * AWS\_KINESISVIDEO\_SERVER\_SIDE\_TIMESTAMP - Server-side timestamp
+    #     of the fragment.
     #
-    #   * AWS\_KINESISVIDEO\_PRODUCER\_SIDE\_TIMESTAMP - Producer-side time
-    #     stamp of the fragment.
+    #   * AWS\_KINESISVIDEO\_PRODUCER\_SIDE\_TIMESTAMP - Producer-side
+    #     timestamp of the fragment.
     #
     #   The following tags will be included if an exception occurs:
     #
@@ -313,8 +365,8 @@ module Aws::KinesisVideoArchivedMedia
       include Aws::Structure
     end
 
-    # Contains the range of time stamps for the requested media, and the
-    # source of the time stamps.
+    # Contains the range of timestamps for the requested media, and the
+    # source of the timestamps.
     #
     # @note When making an API call, you may pass HLSFragmentSelector
     #   data as a hash:
@@ -328,39 +380,39 @@ module Aws::KinesisVideoArchivedMedia
     #       }
     #
     # @!attribute [rw] fragment_selector_type
-    #   The source of the time stamps for the requested media.
+    #   The source of the timestamps for the requested media.
     #
     #   When `FragmentSelectorType` is set to `PRODUCER_TIMESTAMP` and
     #   GetHLSStreamingSessionURLInput$PlaybackMode is `ON_DEMAND`, the
-    #   first fragment ingested with a producer time stamp within the
+    #   first fragment ingested with a producer timestamp within the
     #   specified FragmentSelector$TimestampRange is included in the media
-    #   playlist. In addition, the fragments with producer time stamps
-    #   within the `TimestampRange` ingested immediately following the first
+    #   playlist. In addition, the fragments with producer timestamps within
+    #   the `TimestampRange` ingested immediately following the first
     #   fragment (up to the
     #   GetHLSStreamingSessionURLInput$MaxMediaPlaylistFragmentResults
     #   value) are included.
     #
-    #   Fragments that have duplicate producer time stamps are deduplicated.
+    #   Fragments that have duplicate producer timestamps are deduplicated.
     #   This means that if producers are producing a stream of fragments
-    #   with producer time stamps that are approximately equal to the true
+    #   with producer timestamps that are approximately equal to the true
     #   clock time, the HLS media playlists will contain all of the
-    #   fragments within the requested time stamp range. If some fragments
+    #   fragments within the requested timestamp range. If some fragments
     #   are ingested within the same time range and very different points in
     #   time, only the oldest ingested collection of fragments are returned.
     #
     #   When `FragmentSelectorType` is set to `PRODUCER_TIMESTAMP` and
     #   GetHLSStreamingSessionURLInput$PlaybackMode is `LIVE`, the producer
-    #   time stamps are used in the MP4 fragments and for deduplication. But
-    #   the most recently ingested fragments based on server time stamps are
+    #   timestamps are used in the MP4 fragments and for deduplication. But
+    #   the most recently ingested fragments based on server timestamps are
     #   included in the HLS media playlist. This means that even if
-    #   fragments ingested in the past have producer time stamps with values
+    #   fragments ingested in the past have producer timestamps with values
     #   now, they are not included in the HLS media playlist.
     #
     #   The default is `SERVER_TIMESTAMP`.
     #   @return [String]
     #
     # @!attribute [rw] timestamp_range
-    #   The start and end of the time stamp range for the requested media.
+    #   The start and end of the timestamp range for the requested media.
     #
     #   This value should not be present if `PlaybackType` is `LIVE`.
     #   @return [Types::HLSTimestampRange]
@@ -373,7 +425,7 @@ module Aws::KinesisVideoArchivedMedia
       include Aws::Structure
     end
 
-    # The start and end of the time stamp range for the requested media.
+    # The start and end of the timestamp range for the requested media.
     #
     # This value should not be present if `PlaybackType` is `LIVE`.
     #
@@ -393,7 +445,7 @@ module Aws::KinesisVideoArchivedMedia
     #       }
     #
     # @!attribute [rw] start_timestamp
-    #   The start of the time stamp range for the requested media.
+    #   The start of the timestamp range for the requested media.
     #
     #   If the `HLSTimestampRange` value is specified, the `StartTimestamp`
     #   value is required.
@@ -407,7 +459,7 @@ module Aws::KinesisVideoArchivedMedia
     #   @return [Time]
     #
     # @!attribute [rw] end_timestamp
-    #   The end of the time stamp range for the requested media. This value
+    #   The end of the timestamp range for the requested media. This value
     #   must be within 3 hours of the specified `StartTimestamp`, and it
     #   must be later than the `StartTimestamp` value.
     #
@@ -418,7 +470,7 @@ module Aws::KinesisVideoArchivedMedia
     #   value is required.
     #
     #   <note markdown="1"> This value is inclusive. The `EndTimestamp` is compared to the
-    #   (starting) time stamp of the fragment. Fragments that start before
+    #   (starting) timestamp of the fragment. Fragments that start before
     #   the `EndTimestamp` value and continue past it are included in the
     #   session.
     #
@@ -466,8 +518,8 @@ module Aws::KinesisVideoArchivedMedia
     #   @return [String]
     #
     # @!attribute [rw] fragment_selector
-    #   Describes the time stamp range and time stamp origin for the range
-    #   of fragments to return.
+    #   Describes the timestamp range and timestamp origin for the range of
+    #   fragments to return.
     #   @return [Types::FragmentSelector]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-video-archived-media-2017-09-30/ListFragmentsInput AWS API Documentation
@@ -481,8 +533,9 @@ module Aws::KinesisVideoArchivedMedia
     end
 
     # @!attribute [rw] fragments
-    #   A list of fragment numbers that correspond to the time stamp range
-    #   provided.
+    #   A list of archived Fragment objects from the stream that meet the
+    #   selector criteria. Results are in no specific order, even across
+    #   pages.
     #   @return [Array<Types::Fragment>]
     #
     # @!attribute [rw] next_token
@@ -499,7 +552,7 @@ module Aws::KinesisVideoArchivedMedia
       include Aws::Structure
     end
 
-    # The range of time stamps for which to return fragments.
+    # The range of timestamps for which to return fragments.
     #
     # @note When making an API call, you may pass TimestampRange
     #   data as a hash:
@@ -510,13 +563,13 @@ module Aws::KinesisVideoArchivedMedia
     #       }
     #
     # @!attribute [rw] start_timestamp
-    #   The starting time stamp in the range of time stamps for which to
+    #   The starting timestamp in the range of timestamps for which to
     #   return fragments.
     #   @return [Time]
     #
     # @!attribute [rw] end_timestamp
-    #   The ending time stamp in the range of time stamps for which to
-    #   return fragments.
+    #   The ending timestamp in the range of timestamps for which to return
+    #   fragments.
     #   @return [Time]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-video-archived-media-2017-09-30/TimestampRange AWS API Documentation

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-kinesisvideoarchivedmedia
 version: !ruby/object:Gem::Version
-  version: 1.7.0
+  version: 1.8.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-11-20 00:00:00.000000000 Z
+date: 2019-02-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core