# IVS 参加者のレプリケーション \$1 リアルタイムストリーミング
<a name="rt-participant-replication"></a>

参加者のレプリケーションでは、あるステージから別のステージに参加者をコピーできます。これは、同じ参加者を複数のステージに同時に表示し、ステージ間のインタラクションを有効にする場合に便利です。

ソーシャルライブストリーミングアプリケーションの一般的なユースケースは、VS モードと呼ばれる対戦形式です。この形式では、2 人の配信者が一時的にマッチングされ、リアルタイムで相互にやり取りできるようになります。また、各配信者の視聴者は両方の配信者を同時に視聴することができます。

**主要なコンセプト:**
+ **ソースステージ** — 参加者が最初に参加したステージ。レプリケーションのソースとして使用されます。
+ **宛先ステージ** — 参加者がレプリケートされるステージ。
+ **レプリケートされる参加者** — 1 つ以上の宛先ステージにレプリケートされるステージの参加者。
+ **レプリカ参加者** — 別のステージ (ソースステージ) からレプリケートされる宛先ステージの参加者。

## 参加者のレプリケーションの使用
<a name="using-participant-replication-using"></a>

![\[参加者のレプリケーションを使用して、あるステージから別のステージに参加者をコピーします。\]](http://docs.aws.amazon.com/ja_jp/ivs/latest/RealTimeUserGuide/images/Participant_Replication.png)


### 前提条件
<a name="using-participant-replication-prerequisites"></a>

参加者のレプリケーションを使用するには、少なくとも 2 つのステージがすでに作成されている必要があります。たとえば、上記のシナリオでは、2 人のアクティブなパブリッシャーが存在しています。

1. **ステージ A** に接続された**参加者 A**

1. **ステージ B** に接続された**参加者 B**

対戦形式をサポートするために、一時的に参加者 A をステージ B に、参加者 B をステージ A にレプリケートします。

### 参加者のレプリケーションを開始する
<a name="using-participant-replication-start"></a>

参加者をレプリケートするには、StartParticipantReplication オペレーションを使用します。これはレプリケーション方向ごとに 1 回呼び出す必要があります。

参加者 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
```