

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Selecionar recursos de reunião do SDK do Amazon Chime.
<a name="js-meeting-features"></a>

Ao chamar a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html), é possível especificar recursos para disponibilizar aos clientes que ingressam na sessão. Observe que algumas opções de recursos geram cobrança adicional.

Os seguintes recursos estão disponíveis para sessões:
+ `Audio.EchoReduction`: redução do eco de machine learning.
+ `Video.MaxResolution`: resolução máxima de vídeo da webcam.
+ `Content.MaxResolution`: resolução máxima de compartilhamento de conteúdo.
+ `Attendees.MaxCount`: número máximo de participantes.

**Topics**
+ [Usando Audio.EchoReduction](#audio-echo-reduction)
+ [Usando Video.MaxResolution](#video-max-resolution)
+ [Usando Content.MaxResolution](#js-content-resolution)
+ [Usando Attendees.MaxCount](#js-max-attendees)
+ [Usar recursos de reunião em uma aplicação cliente](#meeting-features-client-app)

## Usando Audio.EchoReduction
<a name="audio-echo-reduction"></a>

Use `Audio.EchoReduction` para ajudar a impedir que o som do alto-falante de um usuário circule de volta para a reunião.

A redução de eco é ideal para situações em que o alto-falante do usuário será o principal dispositivo de saída para o áudio da reunião. Por exemplo, quando vários usuários estão participando de uma reunião usando o mesmo dispositivo em uma sala de conferência ou quando um participante remoto individual não está usando fones de ouvido.

A redução de eco está disponível nas bibliotecas cliente JavaScript e React. Para obter mais informações, consulte a [documentação em GitHub](https://aws.github.io/amazon-chime-sdk-js/modules/amazonvoice_focus.html#what-is-echo-reduction). Sujeito a custos adicionais. Consulte os detalhes na [página de Preços do SDK do Amazon Chime](https://aws.amazon.com/chime/chime-sdk/pricing/).

## Usando Video.MaxResolution
<a name="video-max-resolution"></a>

Use `Video.MaxResolution` para especificar a resolução máxima de vídeo da webcam para a reunião. O recurso fornece as seguintes opções:
+ `None`: nenhum vídeo de câmera permitido
+ `HD`: vídeo de câmera de alta definição (1280x720p)
+ `FHD`: vídeo de câmera em full HD (1920x1080)

Se um vídeo FHD (1080p) for solicitado, será criada uma sessão de WebRTC de alta definição. Consulte os detalhes na [página de Preços do SDK do Amazon Chime](https://aws.amazon.com/chime/chime-sdk/pricing/).

Se um cliente tentar enviar vídeo de webcam acima do máximo especificado, o serviço rejeitará o vídeo e enviará o seguinte erro:

`Disabled video/content send capability, reason: Video resolution is above limit of current meeting feature selection.`

## Usando Content.MaxResolution
<a name="js-content-resolution"></a>

Use `Content.MaxResolution` para especificar a resolução máxima de compartilhamento de conteúdo para a reunião. O recurso fornece as seguintes opções: 
+ `None`: nenhum compartilhamento de conteúdo permitido
+ `FHD`: compartilhamento de conteúdo em full HD (1920x1080)
+ `UHD`: compartilhamento de conteúdo em ultra HD (3840x2160)

Se um conteúdo em UHD (4K) for solicitado, será criada uma sessão de WebRTC de alta definição.

Se um cliente tentar enviar um compartilhamento de conteúdo além da resolução máxima, a escala da resolução será reduzida verticalmente para o máximo especificado. Você escala aplicando `MediaTrackConstraints` à trilha de compartilhamento de conteúdo. Os exemplos a seguir mostram como escalar uma trilha de compartilhamento.

```
const constraint: MediaTrackConstraints = {
    width: { ideal: videoQualitySettings.videoWidth },
    height: { ideal: videoQualitySettings.videoHeight },
    frameRate: { ideal: videoQualitySettings.videoFrameRate },
  };
  this.context.logger.info(
    `Video track (content = ${isContentAttendee}) with constraint: ${JSON.stringify(
      constraint
    )}, trackSettings: ${JSON.stringify(trackSettings)}`
  );
  try {
    await mediaStreamTrack.applyConstraints(constraint);
  } catch (error) {
    this.context.logger.info(
      `Could not apply constraint for video track (content = ${isContentAttendee})`
    );
  }
```

A tabela a seguir mostra o comportamento esperado para o compartilhamento de conteúdo.


| Recurso do conteúdo | Resolução nativa de compartilhamento de conteúdo | Escalabilidade | Resolução da codificação de conteúdo | 
| --- | --- | --- | --- | 
| FHD | 1280x720 | Não | 1280x720 | 
| FHD | 1920x1080 | Não | 1920x1080 | 
| FHD | 3840x2160 | Sim | 1920x1080 | 
| UHD | 1920x1080 | Não | 1920x1080 | 
| UHD | 3840x2160 | Não | 3840x2160 | 
| UHD | 4200x2400 | Sim | 3780x2160 | 

## Usando Attendees.MaxCount
<a name="js-max-attendees"></a>

Use `Attendee.MaxCount` para especificar o número de participantes permitidos em uma reunião. O limite superior de Attendee.MaxCount depende do tipo de sessão. Para uma sessão padrão, você pode selecionar no máximo 250 participantes. Para uma sessão de alta definição, você *deve* selecionar um valor de até 25 participantes. 

Se você solicitar vídeo em FHD (1080p) ou conteúdo em UHD (4K), sua sessão será de alta definição.

Os custos de capacidade dos participantes se aplicam a sessões de alta definição. Consulte os detalhes na [página de Preços do SDK do Amazon Chime](https://aws.amazon.com/chime/chime-sdk/pricing/).

## Usar recursos de reunião em uma aplicação cliente
<a name="meeting-features-client-app"></a>



### Criar uma reunião com recursos especificados
<a name="js-create-meetings-sdk-namespace"></a>

Para criar uma reunião, chame a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html) e especifique os recursos de reunião desejados. O exemplo a seguir mostra como especificar todos os recursos.

```
// You must migrate to the Amazon Chime SDK Meetings namespace.
const chime = AWS.ChimeSDKMeetings({ region: "{{eu-central-1}}" });

// Create meeting 
const meetingInfo = await chime.createMeeting({
    ...
    MeetingFeatures: {
      Audio: {
        EchoReduction: '{{AVAILABLE}}' 
      },
      Video: {
        MaxResolution: '{{FHD}}' 
      },
      Content: {
        MaxResolution: '{{UHD}}' 
      },
      Attendee: {
        MaxCount: {{25}} 
      },
    } 
  }).promise();
```

### Usar recursos de reunião em um cliente
<a name="js-client-level"></a>

Depois de criar uma reunião com os recursos desejados, você pode transmitir o `joinInfo` ao criar o objeto `MeetingSessionConfiguration`. Os recursos da reunião são usados na criação de `meetingSession` para definir a resolução e a taxa de bits do vídeo da webcam, e a resolução e a taxa de bits do compartilhamento de conteúdo.

```
const configuration = new MeetingSessionConfiguration(this.joinInfo.Meeting, this.joinInfo.Attendee);

this.meetingSession = new DefaultMeetingSession(
    configuration,
    this.meetingLogger,
    this.deviceController,
    new DefaultEventController(configuration, this.meetingLogger, this.eventReporter)
);
```