IVS 參與者複寫 | 即時串流 - Amazon IVS
使用參與者複寫

IVS 參與者複寫 | 即時串流

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

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

重要概念：

  • 來源舞台 – 參與者最初加入的舞台，用作複寫來源。

  • 目的地舞台 – 將參與者複寫所至的舞台。

  • 複寫的參與者 – 從一個舞台複寫至一或多個目的地舞台的參與者。

  • 複本參與者 – 目的地舞台中從另一個舞台 (來源舞台) 複寫的參與者。

使用參與者複寫

使用參與者複寫，將參與者從一個舞台複製到另一個舞台。

先決條件

若要使用參與者複寫，您必須至少已建立兩個舞台。例如，在上述案例中，我們有兩個作用中的發佈者：

  1. 參與者 A，連線至舞台 A

  2. 參與者 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 從舞台 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