IVS 참가자 복제 | 실시간 스트리밍
참가자 복제를 사용하면 한 단계에서 다른 단계로 참가자를 복사할 수 있습니다. 이는 동일한 참가자가 여러 단계에 동시에 표시되도록 하여 단계 간 상호 작용을 활성화하려는 경우에 유용합니다.
소셜 라이브 스트리밍 애플리케이션의 일반적인 사용 사례는 VS Mode라고도 하는 경쟁으로, 두 스트리머가 일시적으로 일치하여 실시간으로 서로 상호 작용할 수 있는 반면 각 스트림의 뷰어는 두 스트리머를 모두 볼 수 있습니다.
핵심 개념:
-
소스 단계 — 참가자가 원래 조인한 단계로, 복제 소스로 사용됩니다.
-
대상 단계 — 참가자가 복제되는 단계입니다.
-
복제된 참가자 — 하나 이상의 대상 단계에 복제되는 단계의 참가자입니다.
-
복제본 참가자 — 다른 단계(소스 단계)에서 복제되는 대상 단계의 참가자입니다.
참가자 복제 사용

사전 조건
참가자 복제를 사용하려면 두 개 이상의 단계가 이미 생성되어 있어야 합니다. 예를 들어 위 시나리오에는 활성 게시자가 두 개 있습니다.
-
참가자 A, A단계에 연결됨
-
참가자 B, B단계에 연결됨
참가자 A를 단계 B로, 참가자 B를 단계 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입니다.
참가자 복제 중지
복제를 중지하려면 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