Replicación de participantes de IVS | Transmisión en tiempo real - Amazon IVS
Uso de la replicación de participantes

Replicación de participantes de IVS | Transmisión en tiempo real

La replicación de participantes permite copiar a un participante de una fase a otra. Esto resulta útil cuando se quiere que el mismo participante aparezca en varias fases al mismo tiempo, lo que permite interacciones entre fases.

Un caso de uso habitual en las aplicaciones de transmisión en directo para redes sociales son las competiciones, que suelen denominarse modo VS, en las que dos streamers se unen de forma temporal para interactuar entre sí en tiempo real, mientras que los espectadores de cada transmisión pueden ver a ambos streamers.

Conceptos clave:

  • Fase de origen: la fase a la que el participante se unió originalmente y que se utiliza como origen para la replicación.

  • Fase de destino: la fase a la que se replica el participante.

  • Participante replicado: un participante en una fase que se replica en una o más fases de destino.

  • Réplica del participante: un participante en una fase de destino que se replica desde otra fase (la fase de origen).

Uso de la replicación de participantes

Utilice la replicación de participantes para copiar un participante de una fase a otra.

Requisitos previos

Para usar la replicación de participantes, debe tener al menos dos fases ya creadas. Por ejemplo, en el escenario anterior, tenemos dos publicadores activos:

  1. Participante A, conectado a la fase A

  2. Participante B, conectado a la fase B

Replicaremos al participante A en la fase B y al participante B en la fase A temporalmente, para permitir una competición cara a cara.

Inicio de la replicación de participantes

Para replicar a los participantes, utilice la operación StartParticipantReplication. Debe hacer la llamada una vez por cada dirección de replicación.

Replicar al participante A en la fase 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 al participante B en la fase 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

Una vez iniciada la replicación, los participantes permanecen replicados hasta que usted la detenga de forma explícita mediante la operación StopParticipantReplication. Un participante replicado que se desconecte y, posteriormente, se vuelva a conectar dentro del intervalo especificado por reconnectWindowSeconds, volverá a aparecer automáticamente en las fases de origen y destino. El valor predeterminado de reconnectWindowSeconds es 0.

Detención de la replicación de participantes

Para detener la replicación, llame a la operación StopParticipantReplication.

Detener la replicación del participante A de la fase A en la fase 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

Detener la replicación del participante B de la fase B en la fase 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