Replicação de participantes do IVS | Streaming em tempo real - Amazon IVS
Usar replicação de participantes

Replicação de participantes do IVS | Streaming em tempo real

A replicação de participantes permite que você copie um participante de um palco para outro. Isso é útil quando você deseja que o mesmo participante apareça em vários palcos ao mesmo tempo, permitindo interações entre palcos.

Um caso de uso comum em aplicações de transmissão ao vivo social são as competições, geralmente chamadas de Modo VS, em que dois streamers são temporariamente combinados para que possam interagir um com o outro em tempo real, enquanto os espectadores de cada transmissão podem ver ambos os streamers.

Principais conceitos:

  • Palco de origem: o palco em que o participante ingressou originalmente, que é usado como fonte para replicação.

  • Palco de destino: o palco para o qual o participante é replicado.

  • Participante replicado: um participante em um palco que é replicado para um ou mais palcos de destino.

  • Réplica de participante: um participante em um palco de destino que é replicado de outro estágio (o palco de origem).

Usar replicação de participantes

Use a replicação de participantes para copiar um participante de um palco para outro.

Pré-requisitos

Para usar a replicação de participantes, é preciso ter pelo menos dois palcos já criados. Por exemplo, no cenário acima, temos dois publicadores ativos:

  1. Participante A, conectado ao palco A

  2. Participante B, conectado ao palco B

Vamos replicar o participante A no palco B e o participante B no palco A temporariamente, para dar suporte a uma competição frente a frente.

Iniciar replicação de participantes

Para replicar participantes, use a operação StartParticipantReplication. Você deve chamar isso uma vez para cada direção de replicação.

Replicar o participante A para o palco 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

Replicar o participante B para o palco 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

Uma vez que a replicação é iniciada, os participantes permanecem replicados até que você a interrompa explicitamente usando a operação StopParticipantReplication. Um participante replicado que se desconecta e depois se reconecta dentro do intervalo especificado por reconnectWindowSeconds aparecerá automaticamente novamente nos palcos de origem e destino. O valor padrão para reconnectWindowSeconds é 0.

Parar replicação de participantes

Para parar a replicação, chame a operação StopParticipantReplication.

Pare a replicação do participante A do palco A para o palco 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

Pare a replicação do participante B do palco B para o palco 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