ChimeSDKMediaPipelines / Client / get_media_capture_pipeline

get_media_capture_pipeline#

ChimeSDKMediaPipelines.Client.get_media_capture_pipeline(**kwargs)#

Gets an existing media pipeline.

See also: AWS API Documentation

Request Syntax

response = client.get_media_capture_pipeline(
    MediaPipelineId='string'
)
Parameters:

MediaPipelineId (string) –

[REQUIRED]

The ID of the pipeline that you want to get.

Return type:

dict

Returns:

Response Syntax

{
    'MediaCapturePipeline': {
        'MediaPipelineId': 'string',
        'MediaPipelineArn': 'string',
        'SourceType': 'ChimeSdkMeeting',
        'SourceArn': 'string',
        'Status': 'Initializing'|'InProgress'|'Failed'|'Stopping'|'Stopped'|'Paused'|'NotStarted',
        'SinkType': 'S3Bucket',
        'SinkArn': 'string',
        'CreatedTimestamp': datetime(2015, 1, 1),
        'UpdatedTimestamp': datetime(2015, 1, 1),
        'ChimeSdkMeetingConfiguration': {
            'SourceConfiguration': {
                'SelectedVideoStreams': {
                    'AttendeeIds': [
                        'string',
                    ],
                    'ExternalUserIds': [
                        'string',
                    ]
                }
            },
            'ArtifactsConfiguration': {
                'Audio': {
                    'MuxType': 'AudioOnly'|'AudioWithActiveSpeakerVideo'|'AudioWithCompositedVideo'
                },
                'Video': {
                    'State': 'Enabled'|'Disabled',
                    'MuxType': 'VideoOnly'
                },
                'Content': {
                    'State': 'Enabled'|'Disabled',
                    'MuxType': 'ContentOnly'
                },
                'CompositedVideo': {
                    'Layout': 'GridView',
                    'Resolution': 'HD'|'FHD',
                    'GridViewConfiguration': {
                        'ContentShareLayout': 'PresenterOnly'|'Horizontal'|'Vertical'|'ActiveSpeakerOnly',
                        'PresenterOnlyConfiguration': {
                            'PresenterPosition': 'TopLeft'|'TopRight'|'BottomLeft'|'BottomRight'
                        },
                        'ActiveSpeakerOnlyConfiguration': {
                            'ActiveSpeakerPosition': 'TopLeft'|'TopRight'|'BottomLeft'|'BottomRight'
                        },
                        'HorizontalLayoutConfiguration': {
                            'TileOrder': 'JoinSequence'|'SpeakerSequence',
                            'TilePosition': 'Top'|'Bottom',
                            'TileCount': 123,
                            'TileAspectRatio': 'string'
                        },
                        'VerticalLayoutConfiguration': {
                            'TileOrder': 'JoinSequence'|'SpeakerSequence',
                            'TilePosition': 'Left'|'Right',
                            'TileCount': 123,
                            'TileAspectRatio': 'string'
                        },
                        'VideoAttribute': {
                            'CornerRadius': 123,
                            'BorderColor': 'Black'|'Blue'|'Red'|'Green'|'White'|'Yellow',
                            'HighlightColor': 'Black'|'Blue'|'Red'|'Green'|'White'|'Yellow',
                            'BorderThickness': 123
                        },
                        'CanvasOrientation': 'Landscape'|'Portrait'
                    }
                }
            }
        }
    }
}

Response Structure

  • (dict) –

    • MediaCapturePipeline (dict) –

      The media pipeline object.

      • MediaPipelineId (string) –

        The ID of a media pipeline.

      • MediaPipelineArn (string) –

        The ARN of the media capture pipeline

      • SourceType (string) –

        Source type from which media artifacts are saved. You must use ChimeMeeting.

      • SourceArn (string) –

        ARN of the source from which the media artifacts are saved.

      • Status (string) –

        The status of the media pipeline.

      • SinkType (string) –

        Destination type to which the media artifacts are saved. You must use an S3 Bucket.

      • SinkArn (string) –

        ARN of the destination to which the media artifacts are saved.

      • CreatedTimestamp (datetime) –

        The time at which the pipeline was created, in ISO 8601 format.

      • UpdatedTimestamp (datetime) –

        The time at which the pipeline was updated, in ISO 8601 format.

      • ChimeSdkMeetingConfiguration (dict) –

        The configuration for a specified media pipeline. SourceType must be ChimeSdkMeeting.

        • SourceConfiguration (dict) –

          The source configuration for a specified media pipeline.

          • SelectedVideoStreams (dict) –

            The selected video streams for a specified media pipeline. The number of video streams can’t exceed 25.

            • AttendeeIds (list) –

              The attendee IDs of the streams selected for a media pipeline.

              • (string) –

            • ExternalUserIds (list) –

              The external user IDs of the streams selected for a media pipeline.

              • (string) –

        • ArtifactsConfiguration (dict) –

          The configuration for the artifacts in an Amazon Chime SDK meeting.

          • Audio (dict) –

            The configuration for the audio artifacts.

            • MuxType (string) –

              The MUX type of the audio artifact configuration object.

          • Video (dict) –

            The configuration for the video artifacts.

            • State (string) –

              Indicates whether the video artifact is enabled or disabled.

            • MuxType (string) –

              The MUX type of the video artifact configuration object.

          • Content (dict) –

            The configuration for the content artifacts.

            • State (string) –

              Indicates whether the content artifact is enabled or disabled.

            • MuxType (string) –

              The MUX type of the artifact configuration.

          • CompositedVideo (dict) –

            Enables video compositing.

            • Layout (string) –

              The layout setting, such as GridView in the configuration object.

            • Resolution (string) –

              The video resolution setting in the configuration object. Default: HD at 1280 x 720. FHD resolution: 1920 x 1080.

            • GridViewConfiguration (dict) –

              The GridView configuration setting.

              • ContentShareLayout (string) –

                Defines the layout of the video tiles when content sharing is enabled.

              • PresenterOnlyConfiguration (dict) –

                Defines the configuration options for a presenter only video tile.

                • PresenterPosition (string) –

                  Defines the position of the presenter video tile. Default: TopRight.

              • ActiveSpeakerOnlyConfiguration (dict) –

                The configuration settings for an ActiveSpeakerOnly video tile.

                • ActiveSpeakerPosition (string) –

                  The position of the ActiveSpeakerOnly video tile.

              • HorizontalLayoutConfiguration (dict) –

                The configuration settings for a horizontal layout.

                • TileOrder (string) –

                  Sets the automatic ordering of the video tiles.

                • TilePosition (string) –

                  Sets the position of horizontal tiles.

                • TileCount (integer) –

                  The maximum number of video tiles to display.

                • TileAspectRatio (string) –

                  Specifies the aspect ratio of all video tiles.

              • VerticalLayoutConfiguration (dict) –

                The configuration settings for a vertical layout.

                • TileOrder (string) –

                  Sets the automatic ordering of the video tiles.

                • TilePosition (string) –

                  Sets the position of vertical tiles.

                • TileCount (integer) –

                  The maximum number of tiles to display.

                • TileAspectRatio (string) –

                  Sets the aspect ratio of the video tiles, such as 16:9.

              • VideoAttribute (dict) –

                The attribute settings for the video tiles.

                • CornerRadius (integer) –

                  Sets the corner radius of all video tiles.

                • BorderColor (string) –

                  Defines the border color of all video tiles.

                • HighlightColor (string) –

                  Defines the highlight color for the active video tile.

                • BorderThickness (integer) –

                  Defines the border thickness for all video tiles.

              • CanvasOrientation (string) –

                The orientation setting, horizontal or vertical.

Exceptions

  • ChimeSDKMediaPipelines.Client.exceptions.BadRequestException

  • ChimeSDKMediaPipelines.Client.exceptions.ForbiddenException

  • ChimeSDKMediaPipelines.Client.exceptions.UnauthorizedClientException

  • ChimeSDKMediaPipelines.Client.exceptions.ThrottledClientException

  • ChimeSDKMediaPipelines.Client.exceptions.NotFoundException

  • ChimeSDKMediaPipelines.Client.exceptions.ServiceUnavailableException

  • ChimeSDKMediaPipelines.Client.exceptions.ServiceFailureException