# IVS 參與者複寫 \| 即時串流
<a name="rt-participant-replication"></a>

參與者複寫可讓您將參與者從一個舞台複製到另一個舞台。如果想要讓同一參與者同時出現在多個舞台，並啟用跨舞台互動，此功能很有用。

社交即時串流應用程式中的常見使用案例是比賽，通常稱為 VS 模式，在此模式下，兩個主播會暫時配對，以便彼此即時互動，同時每個主播的觀眾可以同時看到這兩名主播。

**重要概念：**
+ **來源舞台** – 參與者最初加入的舞台，用作複寫來源。
+ **目的地舞台** – 將參與者複寫所至的舞台。
+ **複寫的參與者** – 從一個舞台複寫至一或多個目的地舞台的參與者。
+ **複本參與者** – 目的地舞台中從另一個舞台 (來源舞台) 複寫的參與者。

## 使用參與者複寫
<a name="using-participant-replication-using"></a>

![使用參與者複寫，將參與者從一個舞台複製到另一個舞台。](http://docs.aws.amazon.com/zh_tw/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 從舞台 A 複寫到舞台 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
```

停止將參與者 B 從舞台 B 複寫到舞台 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
```