

# IVS 참가자 복제 \| 실시간 스트리밍
<a name="rt-participant-replication"></a>

참가자 복제를 사용하면 한 단계에서 다른 단계로 참가자를 복사할 수 있습니다. 이는 동일한 참가자가 여러 단계에 동시에 표시되도록 하여 단계 간 상호 작용을 활성화하려는 경우에 유용합니다.

소셜 라이브 스트리밍 애플리케이션의 일반적인 사용 사례는 VS Mode라고도 하는 경쟁으로, 두 스트리머가 일시적으로 일치하여 실시간으로 서로 상호 작용할 수 있는 반면 각 스트림의 뷰어는 두 스트리머를 모두 볼 수 있습니다.

**핵심 개념:**
+ **소스 단계** — 참가자가 원래 조인한 단계로, 복제 소스로 사용됩니다.
+ **대상 단계** — 참가자가 복제되는 단계입니다.
+ **복제된 참가자** — 하나 이상의 대상 단계에 복제되는 단계의 참가자입니다.
+ **복제본 참가자** — 다른 단계(소스 단계)에서 복제되는 대상 단계의 참가자입니다.

## 참가자 복제 사용
<a name="using-participant-replication-using"></a>

![참가자 복제를 사용하여 한 단계에서 다른 단계로 참가자를 복사합니다.](http://docs.aws.amazon.com/ko_kr/ivs/latest/RealTimeUserGuide/images/Participant_Replication.png)


### 사전 조건
<a name="using-participant-replication-prerequisites"></a>

참가자 복제를 사용하려면 두 개 이상의 단계가 이미 생성되어 있어야 합니다. 예를 들어 위 시나리오에는 활성 게시자가 두 개 있습니다.

1. **참가자 A**, A**단계에 연결됨**

1. **참가자 B**, B**단계에 연결됨**

참가자 A를 단계 B로, 참가자 B를 단계 A로 일시적으로 복제하여 직접 경쟁을 지원할 것입니다.

### 참가자 복제 시작
<a name="using-participant-replication-start"></a>

참가자를 복제하려면 StartParticipantReplication 작업을 사용합니다. 각 복제 방향에 대해 이를 한 번 호출해야 합니다.

참가자 A를 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
```

참가자 B를 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
```

복제가 시작되면 StopParticipantReplication 작업을 사용하여 명시적으로 중지할 때까지 참가자는 복제된 상태로 유지됩니다. `reconnectWindowSeconds`에서 지정한 간격 내에 연결을 끊었다가 나중에 다시 연결하는 복제된 참가자는 소스 및 대상 단계 모두에 자동으로 다시 나타납니다. `reconnectWindowSeconds`의 기본값은 0입니다.

### 참가자 복제 중지
<a name="using-participant-replication-stop"></a>

복제를 중지하려면 StopParticipantReplication 작업을 호출합니다.

A단계에서 B단계로 참가자 A의 복제를 중지합니다.

```
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
```

B단계에서 A단계로 참가자 B의 복제를 중지합니다.

```
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
```