IVS 参加者のレプリケーション | リアルタイムストリーミング

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

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

主要なコンセプト:

参加者のレプリケーションの使用

前提条件

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

対戦形式をサポートするために、一時的に参加者 A をステージ B に、参加者 B をステージ 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 です。

参加者のレプリケーションを停止する

レプリケーションを停止するには、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