# Etapa 2: criar um palco com gravação opcional de participantes
Um palco corresponde a um espaço virtual no qual os participantes podem trocar vídeos em tempo real. Ele é o recurso fundamental da API de streaming em tempo real. É possível criar um estágio usando o console ou a operação CreateStage.
Recomendamos que, sempre que possível, você crie um novo palco para cada sessão lógica e exclua-o quando terminar, em vez de manter os palcos antigos para possível reutilização. Se os recursos obsoletos (palcos antigos, que não devem ser reutilizados) não forem limpos, é provável que você atinja o limite do número máximo de palcos mais rapidamente.
Você pode criar um palco (com ou sem gravação de participante individual) no console do Amazon IVS ou na AWS CLI. A criação e a gravação de palco são discutidas abaixo.
## Gravação individual de participante
Você tem a opção de habilitar a gravação de participantes individuais para um palco. Se o recurso de gravação de participantes individuais no S3 estiver habilitado, todas as transmissões de participantes individuais para o palco serão gravadas e salvas em um bucket de armazenamento do Amazon S3 de sua propriedade. Posteriormente, a gravação fica disponível para reprodução sob demanda.
*Configurar isso é uma opção avançada.* Por padrão, a gravação é desabilitada quando um palco é criado.
Antes que possa configurar um palco para gravação, é necessário criar uma *configuração de armazenamento*. Trata-se de um recurso que especifica um local do Amazon S3 no qual as transmissões gravadas para o canal são armazenadas. É possível criar e gerenciar configurações de armazenamento usando o console ou a CLI; os dois procedimentos são apresentados abaixo. Após criar a configuração de armazenamento, basta associá-la a um palco ao criar o palco (conforme descrito abaixo) ou posteriormente, atualizando um palco existente. (Na API, consulte [CreateStage](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/API_CreateStage.html) e [UpdateStage](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/API_UpdateStage.html).) É possível associar vários palcos à mesma configuração de armazenamento. É possível excluir uma configuração de armazenamento que não esteja mais associada a nenhum palco.
Lembre-se das seguintes restrições:
+ É necessário ser proprietário do bucket do S3. Ou seja, a conta que configura um palco para gravação precisa ser proprietária do bucket do S3 no qual as gravações serão armazenadas.
+ O palco, a configuração de armazenamento e o local do S3 precisam estar na mesma região da AWS. Se você criar palcos em outras regiões e quiser gravá-los, também será necessário definir as configurações de armazenamento e os buckets do S3 nessas regiões.
Para gravar em seu bucket do S3, é necessária autorização com suas credenciais da AWS. Para conceder o acesso necessário ao IVS, um [perfil vinculado a serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html) (SLR) do AWS IAM é criado automaticamente quando a configuração de gravação é criada: o SLR é limitado a conceder permissão de gravação ao IVS somente no bucket específico.
Observe que problemas de rede entre o local de streaming e a AWS ou na AWS podem resultar em alguma perda de dados durante a gravação do seu fluxo. Em casos como este, o Amazon IVS prioriza o stream ao vivo em relação à gravação. Para obter redundância, grave de forma local por meio da sua ferramenta de streaming.
Para obter mais informações (inclusive como configurar o pós-processamento ou a reprodução de VOD em seus arquivos gravados), consulte [Gravação de participante individual](rt-individual-participant-recording.md).
### Como desabilitar a gravação
Para desabilitar a gravação do Amazon S3 em um palco existente:
+ Console: na página de detalhes do palco relevante, na seção **Gravar fluxos de participantes individuais**, desative a opção **Habilitar gravação automática** em **Gravação automática no S3** e escolha **Salvar alterações**. Isso removerá a associação da configuração de armazenamento do palco; os fluxos nesse palco não serão mais gravados.
+ Na CLI: execute o comando `update-stage` e o submeta no ARN de configuração de gravação como uma string vazia:
```
aws ivs-realtime update-stage --arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh --auto-participant-recording-configuration storageConfigurationArn=""
```
Isso retorna um objeto de palco com uma string vazia para `storageConfigurationArn`, indicando que a gravação está desabilitada.
## Instruções do console para a criação de um palco do IVS
1. Abra o [console do Amazon IVS](https://console.aws.amazon.com/ivs).
(Você também pode acessar o console do Amazon IVS via [Console de Gerenciamento da AWS ](https://console.aws.amazon.com/).)
1. No painel de navegação esquerdo, selecione **Palcos** e, em seguida, selecione **Criar palco**. A janela **Criar palco** é exibida.
![\[Use a janela Criar palco para criar um novo palco e um token de participante para ele.\]](http://docs.aws.amazon.com/pt_br/ivs/latest/RealTimeUserGuide/images/Create_Stage_Console_IPR.png)
1. Opcionalmente, insira um **Nome de palco**.
1. Se você quiser habilitar a gravação individual de participantes, conclua as etapas em [Configurar a gravação automática de participantes individuais no Amazon S3 (opcional)](#getting-started-create-stage-ipr) abaixo.
1. Selecione **Criar palco** para criar o palco. A página de detalhes do palco é exibida para o novo palco.
### Configurar a gravação automática de participantes individuais no Amazon S3 (opcional)
Siga estas etapas para habilitar a gravação de participantes individuais durante a criação de um palco:
1. Na página **Criar palco**, em **Gravar participantes individuais**, ative **Habilitar gravação automática**. O sistema exibirá campos adicionais para a escolha dos **Tipos de mídia gravada**, de uma **Configuração de armazenamento** existente ou para criar uma nova e escolher se deseja gravar miniaturas em um intervalo.
![\[Use a caixa de diálogo Gravar participantes individuais para configurar a gravação de participantes individuais para um palco.\]](http://docs.aws.amazon.com/pt_br/ivs/latest/RealTimeUserGuide/images/Create_Stage_Console_enable_IPR.png)
1. Escolha quais tipos de mídia gravar.
1. Escolha **Criar configuração de armazenamento**. Uma nova janela se abrirá com opções que permitem criar um bucket do Amazon S3 e anexá-lo à nova configuração de gravação.
![\[Use a janela Criar configuração de armazenamento para criar uma nova configuração de armazenamento para um palco.\]](http://docs.aws.amazon.com/pt_br/ivs/latest/RealTimeUserGuide/images/Create_Storage_Configuration_IPR.png)
1. Preencha os campos:
1. Opcionalmente, insira um **Nome de configuração de gravação**.
1. Insira um **Bucket name (Nome do bucket)**.
1. Escolha **Criar configuração de armazenamento** para criar um novo recurso de configuração de armazenamento com um ARN exclusivo. Normalmente, a criação da configuração de gravação leva alguns segundos, mas pode demorar até 20 segundos. Quando a configuração de armazenamento for criada, você retornará para a janela **Criar palco**. Nela, a área **Gravar participantes individuais** mostrará sua nova **Configuração de armazenamento** e o bucket do S3 (**Armazenamento**) que você criou.
![\[Crie um palco usando o console do IVS: nova configuração de armazenamento criada.\]](http://docs.aws.amazon.com/pt_br/ivs/latest/RealTimeUserGuide/images/Create_Stage_Console_Storage_Configuration.png)
1. Opcionalmente, você pode habilitar outras opções não padrão, como gravar réplicas de participantes, mesclar gravações de participantes individuais e gravação de miniaturas.
![\[Crie um palco usando o console do IVS: habilite opções avançadas, como gravação de miniaturas e combinação de IPR.\]](http://docs.aws.amazon.com/pt_br/ivs/latest/RealTimeUserGuide/images/Create_Stage_Console_IPR_Stitching.png)
## Instruções da CLI para a criação de um palco do IVS
Para instalar a AWS CLI, consulte [Install or update to the latest version of the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
Agora, você pode usar a CLI para criar e gerenciar recursos seguindo um dos dois procedimentos abaixo, dependendo se deseja criar um palco com ou sem a gravação de participantes individuais habilitada.
### Criar um palco sem gravação de participantes individuais
A API do palco está sob o namespace ivs-realtime. Por exemplo, para criar um palco:
```
aws ivs-realtime create-stage --name "test-stage"
```
A resposta é:
```
{
"stage": {
"arn": "arn:aws:ivs:us-west-2:376666121854:stage/VSWjvX5XOkU3",
"name": "test-stage"
}
}
```
### Criar um palco com gravação de participantes individuais
Para criar um palco com a gravação de participantes individuais habilitada:
```
aws ivs-realtime create-stage --name "test-stage-participant-recording" --auto-participant-recording-configuration storageConfigurationArn=arn:aws:ivs:us-west-2:123456789012:storage-configuration/LKZ6QR7r55c2,mediaTypes=AUDIO_VIDEO
```
Como opção, você pode transmitir o parâmetro `thumbnailConfiguration` para definir manualmente o modo de armazenamento e gravação em miniatura e o intervalo de miniaturas em segundos:
```
aws ivs-realtime create-stage --name "test-stage-participant-recording" --auto-participant-recording-configuration storageConfigurationArn=arn:aws:ivs:us-west-2:123456789012:storage-configuration/LKZ6QR7r55c2,mediaTypes=AUDIO_VIDEO,thumbnailConfiguration="{targetIntervalSeconds=10,storage=[SEQUENTIAL,LATEST],recordingMode=INTERVAL}"
```
Como opção, transmita o parâmetro `recordingReconnectWindowSeconds` para habilitar a mesclagem de gravações fragmentadas de participantes individuais:
```
aws ivs-realtime create-stage --name "test-stage-participant-recording" --auto-participant-recording-configuration "storageConfigurationArn=arn:aws:ivs:us-west-2:123456789012:storage-configuration/LKZ6QR7r55c2,mediaTypes=AUDIO_VIDEO,thumbnailConfiguration="{targetIntervalSeconds=10,storage=[SEQUENTIAL,LATEST],recordingMode=INTERVAL}",recordingReconnectWindowSeconds=60"
```
A resposta é:
```
{
"stage": {
"arn": "arn:aws:ivs:us-west-2:123456789012:stage/VSWjvX5XOkU3",
"autoParticipantRecordingConfiguration": {
"hlsConfiguration": {
"targetSegmentDurationSeconds": 6
},
"mediaTypes": [
"AUDIO_VIDEO"
],
"recordingReconnectWindowSeconds": 60,
"recordParticipantReplicas": true,
"storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/LKZ6QR7r55c2",
"thumbnailConfiguration": {
"recordingMode": "INTERVAL",
"storage": [
"SEQUENTIAL",
"LATEST"
],
"targetIntervalSeconds": 10
}
},
"endpoints": {
"events": "",
"rtmp": "",
"rtmps": "",
"whip": ""
},
"name": "test-stage-participant-recording"
}
}
```