Transcription

lib/ex_aws/chime.ex

@@ -9,6 +9,7 @@ defmodule ExAws.Chime do
   alias ExAws.Chime.CreateAttendeeRequestItem
   alias ExAws.Chime.Credentials
   alias ExAws.Chime.EmergencyCallingConfiguration
+  alias ExAws.Chime.EngineTranscribeSettings
   alias ExAws.Chime.GeoMatchParams
   alias ExAws.Chime.LoggingConfiguration
   alias ExAws.Chime.MeetingNotificationConfiguration
@@ -1157,6 +1158,32 @@ defmodule ExAws.Chime do
     )
   end
 
+  @spec start_transcription(String.t(), EngineTranscribeSettings.t()) :: JSON.t()
+  def start_transcription(meeting_id, engine_transcribe_settings) do
+    json_request(
+      "/meetings/#{meeting_id}/transcription",
+      %{
+        operation: "start"
+      },
+      %{
+        "TranscriptionConfiguration" => %{
+          "EngineTranscribeSettings" => engine_transcribe_settings
+        }
+      }
+    )
+  end
+
+  @spec stop_transcription(String.t()) :: JSON.t()
+  def stop_transcription(meeting_id) do
+    json_request(
+      "/meetings/#{meeting_id}/transcription",
+      %{
+        operation: "stop"
+      },
+      %{}
+    )
+  end
+
   ### HELPERS
 
   defp delete_request(action, params \\ %{}), do: rest_request(action, :delete, params)
@@ -1204,7 +1231,7 @@ defmodule ExAws.Chime do
 
   defp parse({:error, error}, _), do: {:error, error}
 
-  defp normalise_data(struct) when is_map(struct) do
+  def normalise_data(struct) when is_map(struct) do
     struct
     |> Map.drop([:__struct__])
     |> Enum.reduce(%{}, fn
@@ -1214,8 +1241,9 @@ defmodule ExAws.Chime do
     end)
   end
 
-  defp normalise_data(v) when is_list(v), do: Enum.map(v, &normalise_data/1)
-  defp normalise_data(v) when is_binary(v), do: v
-  defp normalise_data(v) when is_integer(v), do: v
-  defp normalise_data(v) when is_boolean(v), do: v
+  def normalise_data(v) when is_atom(v), do: to_string(v)
+  def normalise_data(v) when is_list(v), do: Enum.map(v, &normalise_data/1)
+  def normalise_data(v) when is_binary(v), do: v
+  def normalise_data(v) when is_integer(v), do: v
+  def normalise_data(v) when is_boolean(v), do: v
 end

lib/ex_aws/chime/engine_transcribe_settings.ex

@@ -0,0 +1,45 @@
+defmodule ExAws.Chime.EngineTranscribeSettings do
+  @moduledoc """
+  Module representing the Chime EngineTranscribeSettings data type
+
+  See https://docs.aws.amazon.com/chime/latest/APIReference/API_EngineTranscribeSettings.html
+  """
+
+  defstruct [
+    :content_identification_type,
+    :content_redaction_type,
+    :enable_partial_results_stabilization,
+    :identify_language,
+    :language_code,
+    :language_model_name,
+    :language_options,
+    :partial_results_stability,
+    :pii_entity_types,
+    :preferred_language,
+    :region,
+    :vocabulary_filter_method,
+    :vocabulary_filter_name,
+    :vocabulary_filter_names,
+    :vocabulary_name,
+    :vocabulary_names
+  ]
+
+  @type t :: %__MODULE__{
+          content_identification_type: String.t() | nil,
+          content_redaction_type: String.t() | nil,
+          enable_partial_results_stabilization: boolean() | nil,
+          identify_language: boolean() | nil,
+          language_code: String.t() | nil,
+          language_model_name: String.t() | nil,
+          language_options: String.t() | nil,
+          partial_results_stability: String.t() | nil,
+          pii_entity_types: String.t() | nil,
+          preferred_language: String.t() | nil,
+          region: String.t() | nil,
+          vocabulary_filter_method: String.t() | nil,
+          vocabulary_filter_name: String.t() | nil,
+          vocabulary_filter_names: String.t() | nil,
+          vocabulary_name: String.t() | nil,
+          vocabulary_names: String.t() | nil
+        }
+end

lib/ex_aws/chime/media_pipelines.ex

@@ -0,0 +1,71 @@
+defmodule ExAws.Chime.MediaPipelines do
+  @moduledoc """
+  """
+
+  alias ExAws.Chime
+  alias ExAws.Chime.Tag
+  alias ExAws.Chime.MediaPipelines
+  alias ExAws.Operation.JSON
+
+  @type state() :: :AudioOnly | :AudioWithActiveSpeakerVideo | :AudioWithCompositedVideo
+
+  ### AWS Chime Media Pipelines API
+
+  @spec create_media_capture_pipeline(
+          String.t(),
+          String.t(),
+          MediaPipelines.ChimeSdkMeetingConfiguration.t() | nil,
+          [Tag.t()] | nil
+        ) :: JSON.t()
+  def create_media_capture_pipeline(source_arn, sink_arn, config \\ nil, tags \\ nil) do
+    json_request(
+      "/sdk-media-capture-pipelines",
+      %{
+        SourceType: "ChimeSdkMeeting",
+        SourceArn: source_arn,
+        SinkType: "S3Bucket",
+        SinkArn: sink_arn,
+        ChimeSdkMeetingConfiguration: config,
+        Tags: tags
+      }
+    )
+  end
+
+  @spec delete_media_capture_pipeline(String.t()) :: JSON.t()
+  def delete_media_capture_pipeline(pipeline_id) do
+    json_request(
+      "/sdk-media-capture-pipelines/#{pipeline_id}",
+      %{},
+      :delete
+    )
+  end
+
+  # See https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaConcatenationPipeline.html
+  @spec create_media_concatenation_pipeline(
+          [MediaPipelines.ConcatenationSource.t()],
+          [MediaPipelines.ConcatenationSink.t()],
+          [Tag.t()] | nil
+        ) :: JSON.t()
+  def create_media_concatenation_pipeline(sources, sinks, tags \\ nil) do
+    json_request(
+      "/sdk-media-concatenation-pipelines",
+      %{
+        Sources: sources,
+        Sinks: sinks,
+        Tags: tags
+      }
+    )
+  end
+
+  ### HELPERS
+
+  defp json_request(path, data, method \\ :post) do
+    %JSON{
+      headers: [{"content-type", "application/json"}],
+      http_method: method,
+      path: path,
+      data: Chime.normalise_data(data),
+      service: :"chime-sdk-media-pipelines"
+    }
+  end
+end

lib/ex_aws/chime/media_pipelines/artifacts_concatenation_configuration.ex

@@ -0,0 +1,30 @@
+defmodule ExAws.Chime.MediaPipelines.ArtifactsConcatenationConfiguration do
+  @moduledoc """
+  Module representing the Chime ArtifactsConcatenationConfiguration data type
+
+  See https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_ArtifactsConcatenationConfiguration.html
+  """
+
+  defstruct [
+    :audio,
+    :composited_video,
+    :content,
+    :data_channel,
+    :meeting_events,
+    :transcription_messages,
+    :video
+  ]
+
+  alias ExAws.Chime.MediaPipelines
+
+  @type t :: %__MODULE__{
+          audio: MediaPipelines.AudioConcatenationConfiguration.t(),
+          composited_video: MediaPipelines.CompositedVideoConcatenationConfiguration.t(),
+          content: MediaPipelines.ContentConcatenationConfiguration.t(),
+          data_channel: MediaPipelines.DataChannelConcatenationConfiguration.t(),
+          meeting_events: MediaPipelines.MeetingEventsConcatenationConfiguration.t(),
+          transcription_messages:
+            MediaPipelines.TranscriptionMessagesConcatenationConfiguration.t(),
+          video: MediaPipelines.VideoConcatenationConfiguration.t()
+        }
+end

lib/ex_aws/chime/media_pipelines/artifacts_configuration.ex

@@ -0,0 +1,23 @@
+defmodule ExAws.Chime.MediaPipelines.ArtifactsConfiguration do
+  @moduledoc """
+  Module representing the Chime ArtifactsConfiguration data type
+
+  See https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_ArtifactsConfiguration.html
+  """
+
+  defstruct [
+    :audio,
+    :content,
+    :video,
+    :composited_video
+  ]
+
+  alias ExAws.Chime.MediaPipelines
+
+  @type t :: %__MODULE__{
+          audio: MediaPipelines.AudioArtifactsConfiguration.t(),
+          content: MediaPipelines.ContentArtifactsConfiguration.t(),
+          video: MediaPipelines.VideoArtifactsConfiguration.t(),
+          composited_video: MediaPipelines.CompositedVideoArtifactsConfiguration.t()
+        }
+end

lib/ex_aws/chime/media_pipelines/audio_artifacts_configuration.ex

@@ -0,0 +1,15 @@
+defmodule ExAws.Chime.MediaPipelines.AudioArtifactsConfiguration do
+  @moduledoc """
+  Module representing the Chime AudioArtifactsConfiguration data type
+
+  See https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_AudioArtifactsConfiguration.html
+  """
+
+  defstruct [
+    :mux_type
+  ]
+
+  @type t :: %__MODULE__{
+          mux_type: :AudioOnly | :AudioWithActiveSpeakerVideo | :AudioWithCompositedVideo
+        }
+end

lib/ex_aws/chime/media_pipelines/audio_concatenation_configuration.ex

@@ -0,0 +1,16 @@
+defmodule ExAws.Chime.MediaPipelines.AudioConcatenationConfiguration do
+  @moduledoc """
+  Module representing the Chime AudioConcatenationConfiguration data type
+  See https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_AudioConcatenationConfiguration.html
+  """
+
+  defstruct [
+    :state
+  ]
+
+  alias ExAws.Chime.MediaPipelines
+
+  @type t :: %__MODULE__{
+          state: MediaPipelines.state()
+        }
+end

lib/ex_aws/chime/media_pipelines/chime_sdk_meeting_concatenation_configuration.ex

@@ -0,0 +1,16 @@
+defmodule ExAws.Chime.MediaPipelines.ChimeSdkMeetingConcatenationConfiguration do
+  @moduledoc """
+  Module representing the Chime ChimeSdkMeetingConcatenationConfiguration data type.
+
+  See https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_ChimeSdkMeetingConcatenationConfiguration.html
+  """
+
+  defstruct [
+    :artifacts_configuration
+  ]
+
+  @type t :: %__MODULE__{
+          artifacts_configuration:
+            ExAws.Chime.MediaPipelines.ArtifactsConcatenationConfiguration.t()
+        }
+end

lib/ex_aws/chime/media_pipelines/chime_sdk_meeting_configuration.ex

@@ -0,0 +1,19 @@
+defmodule ExAws.Chime.MediaPipelines.ChimeSdkMeetingConfiguration do
+  @moduledoc """
+  Module representing the Chime ChimeSdkMeetingConfiguration data type.
+
+  See https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_ChimeSdkMeetingConfiguration.html
+  """
+
+  alias ExAws.Chime.MediaPipelines
+
+  defstruct [
+    :artifacts_configuration,
+    :source_configuration
+  ]
+
+  @type t :: %__MODULE__{
+          artifacts_configuration: MediaPipelines.ArtifactsConfiguration.t() | nil,
+          source_configuration: MediaPipelines.SourceConfiguration.t() | nil
+        }
+end

lib/ex_aws/chime/media_pipelines/composited_video_artifacts_configuration.ex

@@ -0,0 +1,18 @@
+defmodule ExAws.Chime.MediaPipelines.CompositedVideoArtifactsConfiguration do
+  @moduledoc """
+  Module representing the Chime CompositedVideoArtifactsConfiguration data type
+  See https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CompositedVideoArtifactsConfiguration.html
+  """
+
+  defstruct [
+    :grid_view_configuration,
+    :layout,
+    :resolution
+  ]
+
+  @type t :: %__MODULE__{
+          grid_view_configuration: ExAws.Chime.MediaPipelines.GridViewConfiguration.t(),
+          layout: :GridView | nil,
+          resolution: :HD | :FHD | nil
+        }
+end

lib/ex_aws/chime/media_pipelines/composited_video_concatenation_configuration.ex

@@ -0,0 +1,16 @@
+defmodule ExAws.Chime.MediaPipelines.CompositedVideoConcatenationConfiguration do
+  @moduledoc """
+  Module representing the Chime CompositedVideoConcatenationConfiguration data type
+  See https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CompositedVideoConcatenationConfiguration.html
+  """
+
+  defstruct [
+    :state
+  ]
+
+  alias ExAws.Chime.MediaPipelines
+
+  @type t :: %__MODULE__{
+          state: MediaPipelines.state()
+        }
+end

lib/ex_aws/chime/media_pipelines/concatenation_sink.ex

@@ -0,0 +1,17 @@
+defmodule ExAws.Chime.MediaPipelines.ConcatenationSink do
+  @moduledoc """
+  Module representing the Chime ConcatenationSink data type
+
+  See https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_ConcatenationSink.html
+  """
+
+  defstruct [
+    :s3_bucket_sink_configuration,
+    :type
+  ]
+
+  @type t :: %__MODULE__{
+          s3_bucket_sink_configuration: ExAws.Chime.MediaPipelines.S3BucketSinkConfiguration.t(),
+          type: :S3Bucket
+        }
+end

lib/ex_aws/chime/media_pipelines/concatenation_source.ex

@@ -0,0 +1,20 @@
+defmodule ExAws.Chime.MediaPipelines.ConcatenationSource do
+  @moduledoc """
+  Module representing the Chime ConcatenationSource data type
+
+  See https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_ConcatenationSource.html
+  """
+
+  defstruct [
+    :media_capture_pipeline_source_configuration,
+    :type
+  ]
+
+  alias ExAws.Chime.MediaPipelines
+
+  @type t :: %__MODULE__{
+          media_capture_pipeline_source_configuration:
+            MediaPipelines.MediaCapturePipelineSourceConfiguration.t(),
+          type: :MediaCapturePipeline
+        }
+end