From 2028122ca47c77cc14164a0c194b4ddd1eb8db47 Mon Sep 17 00:00:00 2001 From: awstools Date: Thu, 27 Jun 2024 18:14:00 +0000 Subject: [PATCH] feat(client-chime-sdk-media-pipelines): Added Amazon Transcribe multi language identification to Chime SDK call analytics. Enabling customers sending single stream audio to generate call recordings using Chime SDK call analytics --- ...diaInsightsPipelineConfigurationCommand.ts | 2 + ...iaPipelineKinesisVideoStreamPoolCommand.ts | 17 ++++++- ...iaPipelineKinesisVideoStreamPoolCommand.ts | 2 +- ...diaInsightsPipelineConfigurationCommand.ts | 1 + ...diaInsightsPipelineConfigurationCommand.ts | 2 + ...iaPipelineKinesisVideoStreamPoolCommand.ts | 2 +- .../src/models/models_0.ts | 45 +++++++++++++++---- .../aws-models/chime-sdk-media-pipelines.json | 37 ++++++++------- 8 files changed, 81 insertions(+), 27 deletions(-) diff --git a/clients/client-chime-sdk-media-pipelines/src/commands/CreateMediaInsightsPipelineConfigurationCommand.ts b/clients/client-chime-sdk-media-pipelines/src/commands/CreateMediaInsightsPipelineConfigurationCommand.ts index a5c1f1b47665..db8c4935e28b 100644 --- a/clients/client-chime-sdk-media-pipelines/src/commands/CreateMediaInsightsPipelineConfigurationCommand.ts +++ b/clients/client-chime-sdk-media-pipelines/src/commands/CreateMediaInsightsPipelineConfigurationCommand.ts @@ -116,6 +116,7 @@ export interface CreateMediaInsightsPipelineConfigurationCommandOutput * LanguageModelName: "STRING_VALUE", * FilterPartialResults: true || false, * IdentifyLanguage: true || false, + * IdentifyMultipleLanguages: true || false, * LanguageOptions: "STRING_VALUE", * PreferredLanguage: "en-US" || "en-GB" || "es-US" || "fr-CA" || "fr-FR" || "en-AU" || "it-IT" || "de-DE" || "pt-BR", * VocabularyNames: "STRING_VALUE", @@ -223,6 +224,7 @@ export interface CreateMediaInsightsPipelineConfigurationCommandOutput * // LanguageModelName: "STRING_VALUE", * // FilterPartialResults: true || false, * // IdentifyLanguage: true || false, + * // IdentifyMultipleLanguages: true || false, * // LanguageOptions: "STRING_VALUE", * // PreferredLanguage: "en-US" || "en-GB" || "es-US" || "fr-CA" || "fr-FR" || "en-AU" || "it-IT" || "de-DE" || "pt-BR", * // VocabularyNames: "STRING_VALUE", diff --git a/clients/client-chime-sdk-media-pipelines/src/commands/CreateMediaPipelineKinesisVideoStreamPoolCommand.ts b/clients/client-chime-sdk-media-pipelines/src/commands/CreateMediaPipelineKinesisVideoStreamPoolCommand.ts index 51963a94d91a..4eb5e10808ea 100644 --- a/clients/client-chime-sdk-media-pipelines/src/commands/CreateMediaPipelineKinesisVideoStreamPoolCommand.ts +++ b/clients/client-chime-sdk-media-pipelines/src/commands/CreateMediaPipelineKinesisVideoStreamPoolCommand.ts @@ -43,7 +43,22 @@ export interface CreateMediaPipelineKinesisVideoStreamPoolCommandOutput __MetadataBearer {} /** - *

Creates an Kinesis video stream pool for the media pipeline.

+ *

Creates an Amazon Kinesis Video Stream pool for use with media stream + * pipelines.

+ * + *

If a meeting uses an opt-in Region as its + * MediaRegion, + * the KVS stream must be in that same Region. For example, if a meeting uses the af-south-1 Region, the KVS stream must also be in af-south-1. However, if the meeting uses a + * Region that AWS turns on by default, the KVS stream can be in any available Region, including an opt-in Region. For example, if the meeting uses ca-central-1, the KVS stream can be in + * eu-west-2, us-east-1, af-south-1, or any other Region that the Amazon Chime SDK supports.

+ *

To learn which AWS Region a meeting uses, call the GetMeeting API and + * use the MediaRegion + * parameter from the response.

+ *

For more information about opt-in Regions, refer to Available Regions in the + * Amazon Chime SDK Developer Guide, and + * Specify which AWS Regions your account can use, + * in the AWS Account Management Reference Guide.

+ * * @example * Use a bare-bones client and the command you need to make an API call. * ```javascript diff --git a/clients/client-chime-sdk-media-pipelines/src/commands/DeleteMediaPipelineKinesisVideoStreamPoolCommand.ts b/clients/client-chime-sdk-media-pipelines/src/commands/DeleteMediaPipelineKinesisVideoStreamPoolCommand.ts index 7a758adcdd2e..2a91251bd39c 100644 --- a/clients/client-chime-sdk-media-pipelines/src/commands/DeleteMediaPipelineKinesisVideoStreamPoolCommand.ts +++ b/clients/client-chime-sdk-media-pipelines/src/commands/DeleteMediaPipelineKinesisVideoStreamPoolCommand.ts @@ -36,7 +36,7 @@ export interface DeleteMediaPipelineKinesisVideoStreamPoolCommandInput export interface DeleteMediaPipelineKinesisVideoStreamPoolCommandOutput extends __MetadataBearer {} /** - *

Deletes an Kinesis video stream pool.

+ *

Deletes an Amazon Kinesis Video Stream pool.

* @example * Use a bare-bones client and the command you need to make an API call. * ```javascript diff --git a/clients/client-chime-sdk-media-pipelines/src/commands/GetMediaInsightsPipelineConfigurationCommand.ts b/clients/client-chime-sdk-media-pipelines/src/commands/GetMediaInsightsPipelineConfigurationCommand.ts index e9fdd6e2a4d0..a0b7164ae367 100644 --- a/clients/client-chime-sdk-media-pipelines/src/commands/GetMediaInsightsPipelineConfigurationCommand.ts +++ b/clients/client-chime-sdk-media-pipelines/src/commands/GetMediaInsightsPipelineConfigurationCommand.ts @@ -121,6 +121,7 @@ export interface GetMediaInsightsPipelineConfigurationCommandOutput * // LanguageModelName: "STRING_VALUE", * // FilterPartialResults: true || false, * // IdentifyLanguage: true || false, + * // IdentifyMultipleLanguages: true || false, * // LanguageOptions: "STRING_VALUE", * // PreferredLanguage: "en-US" || "en-GB" || "es-US" || "fr-CA" || "fr-FR" || "en-AU" || "it-IT" || "de-DE" || "pt-BR", * // VocabularyNames: "STRING_VALUE", diff --git a/clients/client-chime-sdk-media-pipelines/src/commands/UpdateMediaInsightsPipelineConfigurationCommand.ts b/clients/client-chime-sdk-media-pipelines/src/commands/UpdateMediaInsightsPipelineConfigurationCommand.ts index eb604814578a..ade48ab85d83 100644 --- a/clients/client-chime-sdk-media-pipelines/src/commands/UpdateMediaInsightsPipelineConfigurationCommand.ts +++ b/clients/client-chime-sdk-media-pipelines/src/commands/UpdateMediaInsightsPipelineConfigurationCommand.ts @@ -115,6 +115,7 @@ export interface UpdateMediaInsightsPipelineConfigurationCommandOutput * LanguageModelName: "STRING_VALUE", * FilterPartialResults: true || false, * IdentifyLanguage: true || false, + * IdentifyMultipleLanguages: true || false, * LanguageOptions: "STRING_VALUE", * PreferredLanguage: "en-US" || "en-GB" || "es-US" || "fr-CA" || "fr-FR" || "en-AU" || "it-IT" || "de-DE" || "pt-BR", * VocabularyNames: "STRING_VALUE", @@ -215,6 +216,7 @@ export interface UpdateMediaInsightsPipelineConfigurationCommandOutput * // LanguageModelName: "STRING_VALUE", * // FilterPartialResults: true || false, * // IdentifyLanguage: true || false, + * // IdentifyMultipleLanguages: true || false, * // LanguageOptions: "STRING_VALUE", * // PreferredLanguage: "en-US" || "en-GB" || "es-US" || "fr-CA" || "fr-FR" || "en-AU" || "it-IT" || "de-DE" || "pt-BR", * // VocabularyNames: "STRING_VALUE", diff --git a/clients/client-chime-sdk-media-pipelines/src/commands/UpdateMediaPipelineKinesisVideoStreamPoolCommand.ts b/clients/client-chime-sdk-media-pipelines/src/commands/UpdateMediaPipelineKinesisVideoStreamPoolCommand.ts index 076c1950ed81..3d4239c3d3f8 100644 --- a/clients/client-chime-sdk-media-pipelines/src/commands/UpdateMediaPipelineKinesisVideoStreamPoolCommand.ts +++ b/clients/client-chime-sdk-media-pipelines/src/commands/UpdateMediaPipelineKinesisVideoStreamPoolCommand.ts @@ -42,7 +42,7 @@ export interface UpdateMediaPipelineKinesisVideoStreamPoolCommandOutput __MetadataBearer {} /** - *

Updates an Kinesis video stream pool in a media pipeline.

+ *

Updates an Amazon Kinesis Video Stream pool in a media pipeline.

* @example * Use a bare-bones client and the command you need to make an API call. * ```javascript diff --git a/clients/client-chime-sdk-media-pipelines/src/models/models_0.ts b/clients/client-chime-sdk-media-pipelines/src/models/models_0.ts index a56fa7a0b47a..0f7d9aa6c592 100644 --- a/clients/client-chime-sdk-media-pipelines/src/models/models_0.ts +++ b/clients/client-chime-sdk-media-pipelines/src/models/models_0.ts @@ -268,6 +268,10 @@ export interface AmazonTranscribeCallAnalyticsProcessorConfiguration { /** *

A structure that contains the configuration settings for an Amazon Transcribe processor.

+ * + *

Calls to this API must include a LanguageCode, IdentifyLanguage, or IdentifyMultipleLanguages parameter. + * If you include more than one of those parameters, your transcription job fails.

+ * * @public */ export interface AmazonTranscribeProcessorConfiguration { @@ -386,6 +390,12 @@ export interface AmazonTranscribeProcessorConfiguration { */ IdentifyLanguage?: boolean; + /** + *

Turns language identification on or off for multiple languages.

+ * @public + */ + IdentifyMultipleLanguages?: boolean; + /** *

The language options for the transcription, such as automatic language detection.

* @public @@ -2849,6 +2859,20 @@ export class ConflictException extends __BaseException { /** *

The configuration of an Kinesis video stream.

+ * + *

If a meeting uses an opt-in Region as its + * MediaRegion, + * the KVS stream must be in that same Region. For example, if a meeting uses the af-south-1 Region, the KVS stream must also be in af-south-1. However, if the meeting uses a + * Region that AWS turns on by default, the KVS stream can be in any available Region, including an opt-in Region. For example, if the meeting uses ca-central-1, the KVS stream can be in + * eu-west-2, us-east-1, af-south-1, or any other Region that the Amazon Chime SDK supports.

+ *

To learn which AWS Region a meeting uses, call the GetMeeting API and + * use the MediaRegion + * parameter from the response.

+ *

For more information about opt-in Regions, refer to Available Regions in the + * Amazon Chime SDK Developer Guide, and + * Specify which AWS Regions your account can use, + * in the AWS Account Management Reference Guide.

+ * * @public */ export interface KinesisVideoStreamConfiguration { @@ -2870,13 +2894,13 @@ export interface KinesisVideoStreamConfiguration { */ export interface CreateMediaPipelineKinesisVideoStreamPoolRequest { /** - *

The configuration settings for the video stream.

+ *

The configuration settings for the stream.

* @public */ StreamConfiguration: KinesisVideoStreamConfiguration | undefined; /** - *

The name of the video stream pool.

+ *

The name of the pool.

* @public */ PoolName: string | undefined; @@ -2888,7 +2912,7 @@ export interface CreateMediaPipelineKinesisVideoStreamPoolRequest { ClientRequestToken?: string; /** - *

The tags assigned to the video stream pool.

+ *

The tags assigned to the stream pool.

* @public */ Tags?: Tag[]; @@ -2971,7 +2995,10 @@ export interface KinesisVideoStreamPoolConfiguration { */ export interface CreateMediaPipelineKinesisVideoStreamPoolResponse { /** - *

The configuration for the Kinesis video stream pool.

+ *

The configuration for applying the streams to the pool.

+ * + *

+ * * @public */ KinesisVideoStreamPoolConfiguration?: KinesisVideoStreamPoolConfiguration; @@ -3011,7 +3038,7 @@ export type MediaStreamPipelineSinkType = */ export interface MediaStreamSink { /** - *

The ARN of the media stream sink.

+ *

The ARN of the Kinesis Video Stream pool returned by the CreateMediaPipelineKinesisVideoStreamPool API.

* @public */ SinkArn: string | undefined; @@ -3047,7 +3074,7 @@ export interface MediaStreamSource { SourceType: MediaPipelineSourceType | undefined; /** - *

The ARN of the media stream source.

+ *

The ARN of the meeting.

* @public */ SourceArn: string | undefined; @@ -3179,7 +3206,7 @@ export interface DeleteMediaPipelineRequest { */ export interface DeleteMediaPipelineKinesisVideoStreamPoolRequest { /** - *

The ID of the pool being deleted.

+ *

The unique identifier of the requested resource. Valid values include the name and ARN of the media pipeline Kinesis Video Stream pool.

* @public */ Identifier: string | undefined; @@ -3292,7 +3319,7 @@ export interface GetMediaPipelineResponse { */ export interface GetMediaPipelineKinesisVideoStreamPoolRequest { /** - *

The ID of the video stream pool.

+ *

The unique identifier of the requested resource. Valid values include the name and ARN of the media pipeline Kinesis Video Stream pool.

* @public */ Identifier: string | undefined; @@ -3971,7 +3998,7 @@ export interface KinesisVideoStreamConfigurationUpdate { */ export interface UpdateMediaPipelineKinesisVideoStreamPoolRequest { /** - *

The ID of the video stream pool.

+ *

The unique identifier of the requested resource. Valid values include the name and ARN of the media pipeline Kinesis Video Stream pool.

* @public */ Identifier: string | undefined; diff --git a/codegen/sdk-codegen/aws-models/chime-sdk-media-pipelines.json b/codegen/sdk-codegen/aws-models/chime-sdk-media-pipelines.json index a6a9ba97cc18..9c93ac5e3aab 100644 --- a/codegen/sdk-codegen/aws-models/chime-sdk-media-pipelines.json +++ b/codegen/sdk-codegen/aws-models/chime-sdk-media-pipelines.json @@ -256,6 +256,13 @@ "smithy.api#documentation": "

Turns language identification on or off.

" } }, + "IdentifyMultipleLanguages": { + "target": "com.amazonaws.chimesdkmediapipelines#Boolean", + "traits": { + "smithy.api#default": false, + "smithy.api#documentation": "

Turns language identification on or off for multiple languages.

" + } + }, "LanguageOptions": { "target": "com.amazonaws.chimesdkmediapipelines#LanguageOptions", "traits": { @@ -282,7 +289,7 @@ } }, "traits": { - "smithy.api#documentation": "

A structure that contains the configuration settings for an Amazon Transcribe processor.

" + "smithy.api#documentation": "

A structure that contains the configuration settings for an Amazon Transcribe processor.

\n \n

Calls to this API must include a LanguageCode, IdentifyLanguage, or IdentifyMultipleLanguages parameter. \n If you include more than one of those parameters, your transcription job fails.

\n " } }, "com.amazonaws.chimesdkmediapipelines#Arn": { @@ -2428,7 +2435,7 @@ } ], "traits": { - "smithy.api#documentation": "

Creates an Kinesis video stream pool for the media pipeline.

", + "smithy.api#documentation": "

Creates an Amazon Kinesis Video Stream pool for use with media stream\n pipelines.

\n \n

If a meeting uses an opt-in Region as its \n MediaRegion, \n the KVS stream must be in that same Region. For example, if a meeting uses the af-south-1 Region, the KVS stream must also be in af-south-1. However, if the meeting uses a \n Region that AWS turns on by default, the KVS stream can be in any available Region, including an opt-in Region. For example, if the meeting uses ca-central-1, the KVS stream can be in \n eu-west-2, us-east-1, af-south-1, or any other Region that the Amazon Chime SDK supports.

\n

To learn which AWS Region a meeting uses, call the GetMeeting API and \n use the MediaRegion \n parameter from the response.

\n

For more information about opt-in Regions, refer to Available Regions in the \n Amazon Chime SDK Developer Guide, and \n Specify which AWS Regions your account can use, \n in the AWS Account Management Reference Guide.

\n ", "smithy.api#http": { "method": "POST", "uri": "/media-pipeline-kinesis-video-stream-pools", @@ -2442,14 +2449,14 @@ "StreamConfiguration": { "target": "com.amazonaws.chimesdkmediapipelines#KinesisVideoStreamConfiguration", "traits": { - "smithy.api#documentation": "

The configuration settings for the video stream.

", + "smithy.api#documentation": "

The configuration settings for the stream.

", "smithy.api#required": {} } }, "PoolName": { "target": "com.amazonaws.chimesdkmediapipelines#KinesisVideoStreamPoolName", "traits": { - "smithy.api#documentation": "

The name of the video stream pool.

", + "smithy.api#documentation": "

The name of the pool.

", "smithy.api#required": {} } }, @@ -2463,7 +2470,7 @@ "Tags": { "target": "com.amazonaws.chimesdkmediapipelines#TagList", "traits": { - "smithy.api#documentation": "

The tags assigned to the video stream pool.

" + "smithy.api#documentation": "

The tags assigned to the stream pool.

" } } }, @@ -2477,7 +2484,7 @@ "KinesisVideoStreamPoolConfiguration": { "target": "com.amazonaws.chimesdkmediapipelines#KinesisVideoStreamPoolConfiguration", "traits": { - "smithy.api#documentation": "

The configuration for the Kinesis video stream pool.

" + "smithy.api#documentation": "

The configuration for applying the streams to the pool.

\n \n

\n " } } }, @@ -2801,7 +2808,7 @@ } ], "traits": { - "smithy.api#documentation": "

Deletes an Kinesis video stream pool.

", + "smithy.api#documentation": "

Deletes an Amazon Kinesis Video Stream pool.

", "smithy.api#http": { "method": "DELETE", "uri": "/media-pipeline-kinesis-video-stream-pools/{Identifier}", @@ -2815,7 +2822,7 @@ "Identifier": { "target": "com.amazonaws.chimesdkmediapipelines#NonEmptyString", "traits": { - "smithy.api#documentation": "

The ID of the pool being deleted.

", + "smithy.api#documentation": "

The unique identifier of the requested resource. Valid values include the name and ARN of the media pipeline Kinesis Video Stream pool.

", "smithy.api#httpLabel": {}, "smithy.api#required": {} } @@ -3206,7 +3213,7 @@ "Identifier": { "target": "com.amazonaws.chimesdkmediapipelines#NonEmptyString", "traits": { - "smithy.api#documentation": "

The ID of the video stream pool.

", + "smithy.api#documentation": "

The unique identifier of the requested resource. Valid values include the name and ARN of the media pipeline Kinesis Video Stream pool.

", "smithy.api#httpLabel": {}, "smithy.api#required": {} } @@ -3681,7 +3688,7 @@ } }, "traits": { - "smithy.api#documentation": "

The configuration of an Kinesis video stream.

" + "smithy.api#documentation": "

The configuration of an Kinesis video stream.

\n \n

If a meeting uses an opt-in Region as its \n MediaRegion, \n the KVS stream must be in that same Region. For example, if a meeting uses the af-south-1 Region, the KVS stream must also be in af-south-1. However, if the meeting uses a \n Region that AWS turns on by default, the KVS stream can be in any available Region, including an opt-in Region. For example, if the meeting uses ca-central-1, the KVS stream can be in \n eu-west-2, us-east-1, af-south-1, or any other Region that the Amazon Chime SDK supports.

\n

To learn which AWS Region a meeting uses, call the GetMeeting API and \n use the MediaRegion \n parameter from the response.

\n

For more information about opt-in Regions, refer to Available Regions in the \n Amazon Chime SDK Developer Guide, and \n Specify which AWS Regions your account can use, \n in the AWS Account Management Reference Guide.

\n " } }, "com.amazonaws.chimesdkmediapipelines#KinesisVideoStreamConfigurationUpdate": { @@ -5401,7 +5408,7 @@ "SinkArn": { "target": "com.amazonaws.chimesdkmediapipelines#Arn", "traits": { - "smithy.api#documentation": "

The ARN of the media stream sink.

", + "smithy.api#documentation": "

The ARN of the Kinesis Video Stream pool returned by the CreateMediaPipelineKinesisVideoStreamPool API.

", "smithy.api#required": {} } }, @@ -5456,7 +5463,7 @@ "SourceArn": { "target": "com.amazonaws.chimesdkmediapipelines#Arn", "traits": { - "smithy.api#documentation": "

The ARN of the media stream source.

", + "smithy.api#documentation": "

The ARN of the meeting.

", "smithy.api#required": {} } } @@ -5813,7 +5820,7 @@ }, "traits": { "smithy.api#length": { - "min": 2, + "min": 1, "max": 2 } } @@ -7042,7 +7049,7 @@ } ], "traits": { - "smithy.api#documentation": "

Updates an Kinesis video stream pool in a media pipeline.

", + "smithy.api#documentation": "

Updates an Amazon Kinesis Video Stream pool in a media pipeline.

", "smithy.api#http": { "method": "PUT", "uri": "/media-pipeline-kinesis-video-stream-pools/{Identifier}", @@ -7056,7 +7063,7 @@ "Identifier": { "target": "com.amazonaws.chimesdkmediapipelines#NonEmptyString", "traits": { - "smithy.api#documentation": "

The ID of the video stream pool.

", + "smithy.api#documentation": "

The unique identifier of the requested resource. Valid values include the name and ARN of the media pipeline Kinesis Video Stream pool.

", "smithy.api#httpLabel": {}, "smithy.api#required": {} }