Aviso de fim do suporte: em 20 de maio de 2026, AWS encerrará o suporte para AWS SimSpace Weaver. Depois de 20 de maio de 2026, você não poderá mais acessar o SimSpace Weaver console ou os SimSpace Weaver recursos. Para obter mais informações, consulte [AWS SimSpace Weaver Fim do suporte](https://docs.aws.amazon.com/simspaceweaver/latest/userguide/simspaceweaver-end-of-support.html). 

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á.

# Relógio
<a name="working-with_configuring-simulation_clock"></a>

A seção `clock` especifica as propriedades do relógio da simulação. Atualmente, você só pode configurar a **taxa de atualização** (o número de marcações por segundo que o relógio envia aos aplicativos). A taxa de atualização é a taxa máxima. A taxa efetiva de marcações pode ser menor porque todas as operações (como atualizações de entidades) de uma marcação devem terminar antes que a próxima marcação possa começar. A taxa de atualização também é chamada de **taxa de relógio**.

Os valores válidos para a `tick_rate` dependem da `sdk_version` especificada em seu esquema.

**Valores válidos para a taxa de atualização**
+ Versões anteriores a `"1.14"`:
  + `10`
  + `15`
  + `30`
+ Versão `"1.14"` ou posterior:
  + `"10"`
  + `"15"`
  + `"30"`
  + `"unlimited"`

    Para obter mais informações, consulte [Taxa de atualização ilimitada](#working-with_configuring-simulation_clock_unlimited).

**Importante**  
Para esquemas com uma `sdk_version` anterior a `"1.14"` o valor da `tick_rate` é um **número inteiro**, como `30`.
Para esquemas com uma `sdk_version` de `"1.14"` ou posterior, o valor da `tick_rate` é uma **string**, como `"30"`. O valor **deve incluir aspas duplas**.  
Se você converter um esquema com versão `"1.12"` ou `"1.13"` em versão `"1.14"` ou posterior, deverá colocar o valor da `tick_rate` entre aspas duplas.

## Taxa de atualização ilimitada
<a name="working-with_configuring-simulation_clock_unlimited"></a>

É possível definir a `tick_rate` para `"unlimited"` para permitir que a simulação seja executada tão rapidamente quanto seu código puder ser executado. Com uma taxa de tick ilimitada, SimSpace Weaver envia o próximo tick imediatamente após todos os aplicativos concluírem os commits do tick atual.

**Importante**  
A taxa de ticks ilimitada não é suportada nas SimSpace Weaver versões anteriores à 1.14.0. O valor mínimo da `sdk_version` no esquema é `"1.14"`.

**Taxa de atualização ilimitada no SimSpace Weaver Local**  
O SimSpace Weaver Local implementa `"unlimited"` como se o esquema especificasse uma taxa de atualização de 10 kHz (10.000). O efeito é o mesmo de uma taxa de atualização ilimitada na Nuvem AWS. Ainda é preciso especificar `tick_rate: "unlimited"` no esquema. Para saber mais sobre o SimSpace Weaver Local, consulte [Desenvolvimento local em SimSpace Weaver](working-with_local-development.md).

## Perguntas frequentes sobre o relógio
<a name="working-with_configuring-simulation_clock_faq"></a>

### P1. Posso alterar uma simulação STARTED para usar uma taxa de atualização diferente?
<a name="working-with_configuring-simulation_clock_faq_q1"></a>

Não é possível alterar a taxa de atualização de uma simulação que já existe no Nuvem AWS em nenhum estágio de seu ciclo de vida. Também não é possível alterar a taxa de atualização de uma simulação em execução no SimSpace Weaver Local. É possível definir a `tick_rate` no esquema e iniciar uma nova simulação a partir desse esquema.

### P2. Posso executar minha simulação com uma taxa de atualização ilimitada em uma versão anterior a 1.14?
<a name="working-with_configuring-simulation_clock_faq_q2"></a>

Não, a taxa de atualização ilimitada não é compatível nas versões anteriores a 1.14.0.

## Solução de problemas do relógio
<a name="working-with_configuring-simulation_clock_troubleshooting"></a>

Se sua simulação falhar no início, você pode verificar o valor de `"StartError"` na saída da **DescribeSimulation**API. Um valor inválido de `tick_rate` no esquema produzirá os seguintes erros.

**nota**  
A saída de erro mostrada aqui é exibida em várias linhas para melhorar a legibilidade. A saída real do erro consiste em uma única linha.
+ A `sdk_version` é anterior a `"1.14"` e o valor da `tick_rate` é um número inteiro inválido. Valores válidos: `10`, `15`, `30`

  ```
  "[{\"errorType\":\"SchemaFormatInvalid\",\"errorMessage\":
      \"$.clock.tick_rate: does not have a value in the enumeration [10, 15, 30]\"}]"
  ```
+ A `sdk_version` é anterior a `"1.14"` e o valor da `tick_rate` é uma string. Valores válidos: `10`, `15`, `30`

  ```
  "[{\"errorType\":\"SchemaFormatInvalid\",\"errorMessage\":
      \"$.clock.tick_rate: does not have a value in the enumeration [10, 15, 30]\"},
      {\"errorType\":\"SchemaFormatInvalid\",
      \"errorMessage\":\"$.clock.tick_rate: string found, integer expected\"}]"
  ```
+ A `sdk_version` é `"1.14"` ou posterior e o valor da `tick_rate` é uma string inválida. Valores válidos: `"10"`, `"15"`, `"30"`, `"unlimited"`

  ```
  "[{\"errorType\":\"SchemaFormatInvalid\",\"errorMessage\":
      \"$.clock.tick_rate: does not have a value in the enumeration [10, 15, 30, unlimited]\"}]"
  ```
+ A `sdk_version` é `"1.14"` ou posterior e o valor da `tick_rate` é um número inteiro. Valores válidos: `"10"`, `"15"`, `"30"`, `"unlimited"`

  ```
  "[{\"errorType\":\"SchemaFormatInvalid\",\"errorMessage\":
      \"$.clock.tick_rate: does not have a value in the enumeration [10, 15, 30, unlimited]\"},
      {\"errorType\":\"SchemaFormatInvalid\",
      \"errorMessage\":\"$.clock.tick_rate: integer found, string expected\"}]"
  ```