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

Settings for ESAM (Event Signaling and Management) ad avail handling.

MediaLive signals ad avail
events to an external POIS (Placement Opportunity Information System) endpoint.

- Stability: [Experimental](/cdk/api/stability.html)
- Source: [`lib/avail-settings.ts`](https://github.com/aws/aws-cdk/blob/v2.274.0-alpha.0/packages/@aws-cdk/aws-medialive-alpha/lib/avail-settings.ts#L164)

## Example

```ts
import { StringParameter } from 'aws-cdk-lib/aws-ssm';

declare const stack: Stack;
declare const input: medialive.IInput;
declare const bucket: s3.IBucket;
declare const video: medialive.EncodeConfiguration;
declare const poisPassword: StringParameter;

new medialive.Channel(stack, 'Channel', {
  inputs: [{ input }],
  availSettings: medialive.AvailSettings.esam({
    pois: {
      url: 'https://pois.example.com/esam',
      username: 'pois-user',
      password: poisPassword,
    },
    acquisitionPointId: 'acquisition-point-1',
    adAvailOffset: Duration.millis(200),
  }),
  scte35SegmentationScope: medialive.Scte35SegmentationScope.SCTE35_ENABLED_OUTPUT_GROUPS,
  outputGroups: [
    medialive.OutputGroupConfiguration.hls({
      name: 'hls',
      destinations: [medialive.OutputDestination.toBucket(bucket, 'live/stream')],
      outputs: [{ encodes: [video], outputName: 'hls_out' }],
    }),
  ],
});
```

## Properties

- `acquisitionPointId`: string (required) — The acquisition point identity sent to the POIS in MCC requests.

- `adAvailOffset`: [Duration](/cdk/api/v2/docs/aws-cdk-lib.Duration.html) — Offset added to the input ad avail PTS time.

  **Default:** service default

- `pois`: [PoisEndpoint](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.PoisEndpoint.html) (required) — The POIS endpoint connection details — URL and optional credentials.

- `zoneIdentity`: string — The ID of a zone the POIS uses to control the placement of ad avails.

  **Default:** service default