# Replica dei partecipanti IVS I Streaming in tempo reale
<a name="rt-participant-replication"></a>

La replica dei partecipanti consente di copiare un partecipante da una fase all'altra. Ciò è utile quando si desidera che lo stesso partecipante appaia in più fasi contemporaneamente, consentendo interazioni tra fasi.

Un caso d’uso comune nelle applicazioni di social live streaming è rappresentato dalle competizioni, spesso chiamate Modalità VS, in cui due streamer vengono abbinati temporaneamente per interagire in tempo reale, mentre gli spettatori di ciascun flusso possono vedere entrambi gli streamer.

**Concetti chiave:**
+ **Fase di origine**: la fase in cui il partecipante si è unito originariamente, utilizzata come origine per la replica.
+ **Fase di destinazione**: fase in cui viene replicato il partecipante. 
+ **Partecipante replicato**: un partecipante a una fase che viene replicata in una o più fasi di destinazione. 
+ **Partecipante replica**: un partecipante a una fase di destinazione che viene replicato da un'altra fase (la fase di origine).

## Utilizzo della Replica dei partecipanti
<a name="using-participant-replication-using"></a>

![\[Utilizza la replica dei partecipanti per copiare un partecipante da una fase all’altra.\]](http://docs.aws.amazon.com/it_it/ivs/latest/RealTimeUserGuide/images/Participant_Replication.png)


### Prerequisiti
<a name="using-participant-replication-prerequisites"></a>

Per utilizzare la replica dei partecipanti, devi aver creato almeno due fasi. Ad esempio, nello scenario precedente, abbiamo due publisher attivi:

1. **Partecipante A**, collegato alla **fase A**

1. **Partecipante B**, collegato alla **fase B**

Replicheremo temporaneamente il partecipante A nella fase B e il partecipante B nella fase A, per supportare una competizione testa a testa.

### Avvio della replica dei partecipanti
<a name="using-participant-replication-start"></a>

Per replicare i partecipanti, utilizza l'operazione StartParticipantReplication. È necessario chiamarla una volta per ogni direzione di replica.

Replica il partecipante A nella fase B:

```
aws ivs-realtime start-participant-replication \ 
  --source-stage-arn arn:aws:ivs:us-east-1:123456789012:stage/StageA \
  --destination-stage-arn arn:aws:ivs:us-east-1:123456789012:stage/StageB \
  --participant-id participant-a-id \
  --reconnect-window-seconds 10
```

Replica il partecipante B nella fase A:

```
aws ivs-realtime start-participant-replication \ 
  --source-stage-arn arn:aws:ivs:us-east-1:123456789012:stage/StageB \
  --destination-stage-arn arn:aws:ivs:us-east-1:123456789012:stage/StageA \
  --participant-id participant-b-id \
  --reconnect-window-seconds 10
```

Una volta avviata la replica, i partecipanti restano replicati finché non viene interrotta esplicitamente utilizzando l'operazione StopParticipantReplication. Un partecipante replicato che si disconnette e successivamente si riconnette entro l'intervallo specificato da `reconnectWindowSeconds` riapparirà automaticamente sia nella fase di origine che in quella di destinazione. Il valore predefinito per `reconnectWindowSeconds` è 0.

### Interrompi replica dei partecipanti
<a name="using-participant-replication-stop"></a>

Per interrompere la replica, chiamare l'operazione StopParticipantReplication.

Interrompere la replica del partecipante A dalla fase A alla fase B:

```
aws ivs-realtime stop-participant-replication \ 
  --source-stage-arn arn:aws:ivs:us-east-1:123456789012:stage/StageA \
  --destination-stage-arn arn:aws:ivs:us-east-1:123456789012:stage/StageB \
  --participant-id participant-a-id
```

Interrompere la replica del partecipante B dalla fase B alla fase A:

```
aws ivs-realtime stop-participant-replication \ 
  --source-stage-arn arn:aws:ivs:us-east-1:123456789012:stage/StageB \
  --destination-stage-arn arn:aws:ivs:us-east-1:123456789012:stage/StageA \
  --participant-id participant-b-id
```