> **Experimental**
>
> `@aws-cdk/aws-medialive-alpha` is an [**experimental**](https://docs.aws.amazon.com/cdk/api/stability.html) (alpha) package: its API may change in any release, without a major version bump.
# FrameCaptureOutputGroupProps

Properties for a Frame Capture output group.

Used as argument in: [OutputGroupConfiguration.frameCapture](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.OutputGroupConfiguration.html#framecapture)

- Stability: [Experimental](https://docs.aws.amazon.com/cdk/api/stability.html)
- Source: [`lib/output-group.ts`](https://github.com/aws/aws-cdk/blob/v2.278.0/packages/@aws-cdk/aws-medialive-alpha/lib/output-group.ts#L1017)

## Example

TypeScript:

```ts
declare const bucket: s3.IBucket;
declare const video: medialive.EncodeConfiguration;

medialive.OutputGroupConfiguration.frameCapture({
  name: 'thumbnails',
  destinations: [medialive.S3OutputDestination.toBucket(bucket, 'thumbnails/live')],
  outputs: [{ encodes: [video], outputName: 'thumb' }],
});
```

Python:

```python
# bucket: s3.IBucket
# video: medialive.EncodeConfiguration

medialive.OutputGroupConfiguration.frame_capture(
    name="thumbnails",
    destinations=[medialive.S3OutputDestination.to_bucket(bucket, "thumbnails/live")],
    outputs=[medialive.FrameCaptureOutputDefinition(encodes=[video], output_name="thumb")]
)
```

Java:

```java
IBucket bucket;
EncodeConfiguration video;

OutputGroupConfiguration.frameCapture(FrameCaptureOutputGroupProps.builder()
        .name("thumbnails")
        .destinations(List.of(S3OutputDestination.toBucket(bucket, "thumbnails/live")))
        .outputs(List.of(FrameCaptureOutputDefinition.builder().encodes(List.of(video)).outputName("thumb").build()))
        .build());
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.AWS.MediaLive.Alpha
IBucket bucket;
EncodeConfiguration video;

OutputGroupConfiguration.FrameCapture(new FrameCaptureOutputGroupProps {
    Name = "thumbnails",
    Destinations = new [] { S3OutputDestination.ToBucket(bucket, "thumbnails/live") },
    Outputs = new [] { new FrameCaptureOutputDefinition { Encodes = new [] { video }, OutputName = "thumb" } }
});
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awsmedialivealpha/v2
var bucket IBucket
var video EncodeConfiguration

medialive.OutputGroupConfiguration_FrameCapture(&FrameCaptureOutputGroupProps{
	Name: jsii.String("thumbnails"),
	Destinations: []S3OutputDestination{
		medialive.S3OutputDestination_ToBucket(bucket, jsii.String("thumbnails/live")),
	},
	Outputs: []FrameCaptureOutputDefinition{
		&FrameCaptureOutputDefinition{
			Encodes: []EncodeConfiguration{
				video,
			},
			OutputName: jsii.String("thumb"),
		},
	},
})
```

## Properties

- `destinations`: [S3OutputDestination](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.S3OutputDestination.html)[] (required) — The destinations for this output group — one per pipeline.

  Array position determines the pipeline mapping:
  - `destinations[0]` → Pipeline 0
  - `destinations[1]` → Pipeline 1 (STANDARD channels only)

  For a SINGLE_PIPELINE channel, provide exactly 1 destination.
  For a STANDARD channel, provide exactly 2 destinations.

- `frameCaptureS3CannedAcl`: [S3CannedAcl](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.S3CannedAcl.html) — The S3 canned ACL to apply to each frame capture output.

  **Default:** no canned ACL

- `name`: string (required) — The name of this output group.

  Used as the destination reference ID. Underscores are normalised to hyphens internally.

- `outputs`: [FrameCaptureOutputDefinition](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.FrameCaptureOutputDefinition.html)[] — The outputs for this Frame Capture output group.

  **Default:** no initial outputs
