aws-sdk-kinesisvideowebrtcstorage 1.18.0 → 1.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 211394389d81a37b1a2a9109ac94d910acd41594c96580498d9f4c1761bcaf90
-  data.tar.gz: f6edaae9742f02c84990a95abb66770f9b1222da26967cd7d318563ab34ba264
+  metadata.gz: 784ed37cf2d37176fd4ebba74426f2312d001c93ba81261d320172a861ae4f5b
+  data.tar.gz: bfb671fc8fe12e836ccc1ba2d8655fc6fc2eb8cbe4e984ab364beb0bf07cf832
 SHA512:
-  metadata.gz: 2d486dd558bc2bd40d8a700f495945d3023e0ce5f8ec29013201e5aa63e229d780108abb2054b4801f658c576c9f589df86839507df3a92e66f5d7ec04fd4d5c
-  data.tar.gz: d1993feb627ec8b81064dd934914835bb5c9ddb62f0f05206ff91c9005230d94105d41da9ab3b9bbb7d51d2203bda83909abec1d1326e70f4b35eef79a51be3f
+  metadata.gz: 21e19ffd79c5d0f89b90e40cd5720b238bf5896b515d12ef113ce869195317627a3c049e55f94b26d07cad11944dfa8b422e1a7c5de91f194e9ede29e560fa7e
+  data.tar.gz: 6ae091f158b4f96f1b26aa92788aae413c8aabaeb8671e49f2cbfa020c9a8b5a2c581a3dad8087fcb20a8e26385d2e64dd5b835657acb797a1c6df1172cf2bd7

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.20.0 (2024-09-03)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.19.0 (2024-08-05)
+------------------
+
+* Feature - Add JoinStorageSessionAsViewer API
+
 1.18.0 (2024-07-02)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.18.0
+1.20.0

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

@@ -32,6 +32,7 @@ require 'aws-sdk-core/plugins/checksum_algorithm.rb'
 require 'aws-sdk-core/plugins/request_compression.rb'
 require 'aws-sdk-core/plugins/defaults_mode.rb'
 require 'aws-sdk-core/plugins/recursion_detection.rb'
+require 'aws-sdk-core/plugins/telemetry.rb'
 require 'aws-sdk-core/plugins/sign.rb'
 require 'aws-sdk-core/plugins/protocols/rest_json.rb'
 
@@ -83,6 +84,7 @@ module Aws::KinesisVideoWebRTCStorage
     add_plugin(Aws::Plugins::RequestCompression)
     add_plugin(Aws::Plugins::DefaultsMode)
     add_plugin(Aws::Plugins::RecursionDetection)
+    add_plugin(Aws::Plugins::Telemetry)
     add_plugin(Aws::Plugins::Sign)
     add_plugin(Aws::Plugins::Protocols::RestJson)
     add_plugin(Aws::KinesisVideoWebRTCStorage::Plugins::Endpoints)
@@ -330,6 +332,16 @@ module Aws::KinesisVideoWebRTCStorage
     #     ** Please note ** When response stubbing is enabled, no HTTP
     #     requests are made, and retries are disabled.
     #
+    #   @option options [Aws::Telemetry::TelemetryProviderBase] :telemetry_provider (Aws::Telemetry::NoOpTelemetryProvider)
+    #     Allows you to provide a telemetry provider, which is used to
+    #     emit telemetry data. By default, uses `NoOpTelemetryProvider` which
+    #     will not record or emit any telemetry data. The SDK supports the
+    #     following telemetry providers:
+    #
+    #     * OpenTelemetry (OTel) - To use the OTel provider, install and require the
+    #     `opentelemetry-sdk` gem and then, pass in an instance of a
+    #     `Aws::Telemetry::OTelProvider` for telemetry provider.
+    #
     #   @option options [Aws::TokenProvider] :token_provider
     #     A Bearer Token Provider. This can be an instance of any one of the
     #     following classes:
@@ -425,6 +437,12 @@ module Aws::KinesisVideoWebRTCStorage
 
     # @!group API Operations
 
+    # <note markdown="1"> Before using this API, you must call the `GetSignalingChannelEndpoint`
+    # API to request the WEBRTC endpoint. You then specify the endpoint and
+    # region in your `JoinStorageSession` API request.
+    #
+    #  </note>
+    #
     # Join the ongoing one way-video and/or multi-way audio WebRTC session
     # as a video producing device for an input channel. If there’s no
     # existing session for the channel, a new streaming session needs to be
@@ -432,17 +450,33 @@ module Aws::KinesisVideoWebRTCStorage
     # must be provided.
     #
     # Currently for the `SINGLE_MASTER` type, a video producing device is
-    # able to ingest both audio and video media into a stream, while viewers
-    # can only ingest audio. Both a video producing device and viewers can
-    # join the session first, and wait for other participants.
+    # able to ingest both audio and video media into a stream. Only video
+    # producing devices can join the session and record media.
     #
-    # While participants are having peer to peer conversations through
-    # webRTC, the ingested media session will be stored into the Kinesis
-    # Video Stream. Multiple viewers are able to playback real-time media.
+    # Both audio and video tracks are currently required for WebRTC
+    # ingestion.
     #
-    # Customers can also use existing Kinesis Video Streams features like
-    # `HLS` or `DASH` playback, Image generation, and more with ingested
-    # WebRTC media.
+    #  Current requirements:
+    #
+    #  * Video track: H.264
+    #
+    # * Audio track: Opus
+    #
+    # The resulting ingested video in the Kinesis video stream will have the
+    # following parameters: H.264 video and AAC audio.
+    #
+    # Once a master participant has negotiated a connection through WebRTC,
+    # the ingested media session will be stored in the Kinesis video stream.
+    # Multiple viewers are then able to play back real-time media through
+    # our Playback APIs.
+    #
+    # You can also use existing Kinesis Video Streams features like `HLS` or
+    # `DASH` playback, image generation via [GetImages][1], and more with
+    # ingested WebRTC media.
+    #
+    # <note markdown="1"> S3 image delivery and notifications are not currently supported.
+    #
+    #  </note>
     #
     # <note markdown="1"> Assume that only one video producing device client can be associated
     # with a session for the channel. If more than one client joins the
@@ -451,6 +485,19 @@ module Aws::KinesisVideoWebRTCStorage
     #
     #  </note>
     #
+    # **Additional information**
+    #
+    # * **Idempotent** - This API is not idempotent.
+    #
+    # * **Retry behavior** - This is counted as a new API call.
+    #
+    # * **Concurrent calls** - Concurrent calls are allowed. An offer is
+    #   sent once per each call.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/gs-getImages.html
+    #
     # @option params [required, String] :channel_arn
     #   The Amazon Resource Name (ARN) of the signaling channel.
     #
@@ -471,20 +518,69 @@ module Aws::KinesisVideoWebRTCStorage
       req.send_request(options)
     end
 
+    # Join the ongoing one way-video and/or multi-way audio WebRTC session
+    # as a viewer for an input channel. If there’s no existing session for
+    # the channel, create a new streaming session and provide the Amazon
+    # Resource Name (ARN) of the signaling channel (`channelArn`) and client
+    # id (`clientId`).
+    #
+    # Currently for `SINGLE_MASTER` type, a video producing device is able
+    # to ingest both audio and video media into a stream, while viewers can
+    # only ingest audio. Both a video producing device and viewers can join
+    # a session first and wait for other participants. While participants
+    # are having peer to peer conversations through WebRTC, the ingested
+    # media session will be stored into the Kinesis Video Stream. Multiple
+    # viewers are able to playback real-time media.
+    #
+    # Customers can also use existing Kinesis Video Streams features like
+    # `HLS` or `DASH` playback, Image generation, and more with ingested
+    # WebRTC media. If there’s an existing session with the same `clientId`
+    # that's found in the join session request, the new request takes
+    # precedence.
+    #
+    # @option params [required, String] :channel_arn
+    #   The Amazon Resource Name (ARN) of the signaling channel.
+    #
+    # @option params [required, String] :client_id
+    #   The unique identifier for the sender client.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.join_storage_session_as_viewer({
+    #     channel_arn: "ChannelArn", # required
+    #     client_id: "ClientId", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer AWS API Documentation
+    #
+    # @overload join_storage_session_as_viewer(params = {})
+    # @param [Hash] params ({})
+    def join_storage_session_as_viewer(params = {}, options = {})
+      req = build_request(:join_storage_session_as_viewer, params)
+      req.send_request(options)
+    end
+
     # @!endgroup
 
     # @param params ({})
     # @api private
     def build_request(operation_name, params = {})
       handlers = @handlers.for(operation_name)
+      tracer = config.telemetry_provider.tracer_provider.tracer(
+        Aws::Telemetry.module_to_tracer_name('Aws::KinesisVideoWebRTCStorage')
+      )
       context = Seahorse::Client::RequestContext.new(
         operation_name: operation_name,
         operation: config.api.operation(operation_name),
         client: self,
         params: params,
-        config: config)
+        config: config,
+        tracer: tracer
+      )
       context[:gem_name] = 'aws-sdk-kinesisvideowebrtcstorage'
-      context[:gem_version] = '1.18.0'
+      context[:gem_version] = '1.20.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -15,8 +15,10 @@ module Aws::KinesisVideoWebRTCStorage
 
     AccessDeniedException = Shapes::StructureShape.new(name: 'AccessDeniedException')
     ChannelArn = Shapes::StringShape.new(name: 'ChannelArn')
+    ClientId = Shapes::StringShape.new(name: 'ClientId')
     ClientLimitExceededException = Shapes::StructureShape.new(name: 'ClientLimitExceededException')
     InvalidArgumentException = Shapes::StructureShape.new(name: 'InvalidArgumentException')
+    JoinStorageSessionAsViewerInput = Shapes::StructureShape.new(name: 'JoinStorageSessionAsViewerInput')
     JoinStorageSessionInput = Shapes::StructureShape.new(name: 'JoinStorageSessionInput')
     ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
     String = Shapes::StringShape.new(name: 'String')
@@ -30,6 +32,10 @@ module Aws::KinesisVideoWebRTCStorage
     InvalidArgumentException.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "message"))
     InvalidArgumentException.struct_class = Types::InvalidArgumentException
 
+    JoinStorageSessionAsViewerInput.add_member(:channel_arn, Shapes::ShapeRef.new(shape: ChannelArn, required: true, location_name: "channelArn"))
+    JoinStorageSessionAsViewerInput.add_member(:client_id, Shapes::ShapeRef.new(shape: ClientId, required: true, location_name: "clientId"))
+    JoinStorageSessionAsViewerInput.struct_class = Types::JoinStorageSessionAsViewerInput
+
     JoinStorageSessionInput.add_member(:channel_arn, Shapes::ShapeRef.new(shape: ChannelArn, required: true, location_name: "channelArn"))
     JoinStorageSessionInput.struct_class = Types::JoinStorageSessionInput
 
@@ -65,6 +71,18 @@ module Aws::KinesisVideoWebRTCStorage
         o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
       end)
+
+      api.add_operation(:join_storage_session_as_viewer, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "JoinStorageSessionAsViewer"
+        o.http_method = "POST"
+        o.http_request_uri = "/joinStorageSessionAsViewer"
+        o.input = Shapes::ShapeRef.new(shape: JoinStorageSessionAsViewerInput)
+        o.output = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure))
+        o.errors << Shapes::ShapeRef.new(shape: ClientLimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidArgumentException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+      end)
     end
 
   end

data/lib/aws-sdk-kinesisvideowebrtcstorage/endpoint_provider.rb

@@ -32,7 +32,7 @@ module Aws::KinesisVideoWebRTCStorage
             raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
           end
           if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
-            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
+            if Aws::Endpoints::Matchers.boolean_equals?(Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"), true)
               return Aws::Endpoints::Endpoint.new(url: "https://kinesisvideo-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
             end
             raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"

data/lib/aws-sdk-kinesisvideowebrtcstorage/endpoints.rb

@@ -26,5 +26,19 @@ module Aws::KinesisVideoWebRTCStorage
       end
     end
 
+    class JoinStorageSessionAsViewer
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::KinesisVideoWebRTCStorage::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
   end
 end

data/lib/aws-sdk-kinesisvideowebrtcstorage/plugins/endpoints.rb

@@ -60,6 +60,8 @@ module Aws::KinesisVideoWebRTCStorage
           case context.operation_name
           when :join_storage_session
             Aws::KinesisVideoWebRTCStorage::Endpoints::JoinStorageSession.build(context)
+          when :join_storage_session_as_viewer
+            Aws::KinesisVideoWebRTCStorage::Endpoints::JoinStorageSessionAsViewer.build(context)
           end
         end
       end

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

@@ -50,6 +50,23 @@ module Aws::KinesisVideoWebRTCStorage
       include Aws::Structure
     end
 
+    # @!attribute [rw] channel_arn
+    #   The Amazon Resource Name (ARN) of the signaling channel.
+    #   @return [String]
+    #
+    # @!attribute [rw] client_id
+    #   The unique identifier for the sender client.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewerInput AWS API Documentation
+    #
+    class JoinStorageSessionAsViewerInput < Struct.new(
+      :channel_arn,
+      :client_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] channel_arn
     #   The Amazon Resource Name (ARN) of the signaling channel.
     #   @return [String]

data/lib/aws-sdk-kinesisvideowebrtcstorage.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-kinesisvideowebrtcstorage/customizations'
 # @!group service
 module Aws::KinesisVideoWebRTCStorage
 
-  GEM_VERSION = '1.18.0'
+  GEM_VERSION = '1.20.0'
 
 end

data/sig/client.rbs

@@ -50,6 +50,7 @@ module Aws
                       ?session_token: String,
                       ?sigv4a_signing_region_set: Array[String],
                       ?stub_responses: untyped,
+                      ?telemetry_provider: Aws::Telemetry::TelemetryProviderBase,
                       ?token_provider: untyped,
                       ?use_dualstack_endpoint: bool,
                       ?use_fips_endpoint: bool,
@@ -78,6 +79,13 @@ module Aws
                                   channel_arn: ::String
                                 ) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure]
                               | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure]
+
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/KinesisVideoWebRTCStorage/Client.html#join_storage_session_as_viewer-instance_method
+      def join_storage_session_as_viewer: (
+                                            channel_arn: ::String,
+                                            client_id: ::String
+                                          ) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure]
+                                        | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure]
     end
   end
 end

data/sig/resource.rbs

@@ -50,6 +50,7 @@ module Aws
                         ?session_token: String,
                         ?sigv4a_signing_region_set: Array[String],
                         ?stub_responses: untyped,
+                        ?telemetry_provider: Aws::Telemetry::TelemetryProviderBase,
                         ?token_provider: untyped,
                         ?use_dualstack_endpoint: bool,
                         ?use_fips_endpoint: bool,

data/sig/types.rbs

@@ -23,6 +23,12 @@ module Aws::KinesisVideoWebRTCStorage
       SENSITIVE: []
     end
 
+    class JoinStorageSessionAsViewerInput
+      attr_accessor channel_arn: ::String
+      attr_accessor client_id: ::String
+      SENSITIVE: []
+    end
+
     class JoinStorageSessionInput
       attr_accessor channel_arn: ::String
       SENSITIVE: []

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-kinesisvideowebrtcstorage
 version: !ruby/object:Gem::Version
-  version: 1.18.0
+  version: 1.20.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-07-02 00:00:00.000000000 Z
+date: 2024-09-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.201.0
+        version: 3.203.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.201.0
+        version: 3.203.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement