# IVS 参与者复制 \| 实时直播功能
<a name="rt-participant-replication"></a>

通过参与者复制，您可以将参与者从一个暂存区复制到另一个暂存区。当您想让同一个参与者同时出现在多个暂存区，从而实现跨暂存区互动时，这一功能很有用。

在社交直播应用程序中，一个常见的使用案例是竞赛，通常被称为 VS 模式。在这种模式下，两个主播临时配对，以便于实时互动，而每场直播的观众可以看到这两个主播。

**重要概念：**
+ **源暂存区** — 参与者最初加入的暂存区，用作复制源。
+ **目标暂存区** — 参与者复制到的暂存区。
+ **复制的参与者** — 一个暂存区中复制到一个或多个目标暂存区的参与者。
+ **副本参与者** — 从另一暂存区（源暂存区）进行复制的目标暂存区参与者。

## 使用参与者复制
<a name="using-participant-replication-using"></a>

![使用参与者复制，将参与者从一个暂存区复制到另一个暂存区。](http://docs.aws.amazon.com/zh_cn/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
```