Réplication du participant IVS | Diffusion en temps réel - Amazon IVS
Utilisation de la réplication du participant

Réplication du participant IVS | Diffusion en temps réel

La réplication du participant vous permet de copier un participant d’une étape à l’autre. Cela est utile lorsque vous souhaitez que le même participant apparaisse dans plusieurs étapes en même temps, ce qui permet des interactions entre les étapes.

Les compétitions, souvent appelées mode Versus (VS), constituent un cas d’utilisation courant dans les applications de diffusion en direct sur les réseaux sociaux, où deux diffuseurs sont temporairement mis en relation afin qu’ils puissent interagir ensemble en temps réel, tandis que les spectateurs de chaque flux peuvent voir les deux diffuseurs.

Concepts clés :

  • Étape source : étape à laquelle le participant a initialement rejoint le flux, qui est utilisée comme source de réplication.

  • Étape de destination : étape vers laquelle le participant est répliqué.

  • Participant répliqué : participant à une étape qui est répliqué vers une ou plusieurs étapes de destination.

  • Participant à un réplica : participant à une étape de destination qui est répliqué à partir d’une autre étape (l’étape source).

Utilisation de la réplication du participant

Utilisez la réplication du participant pour copier un participant d’une étape à l’autre.

Prérequis

Pour pouvoir utiliser la réplication du participant, vous devez avoir déjà créé au moins deux étapes. Par exemple, dans le scénario ci-dessus, nous avons deux diffuseurs de publication actifs :

  1. Le participant A, connecté à l’étape A

  2. Le participant B, connecté à l’étape B

Nous reproduirons temporairement le participant A dans l’étape B et le participant B dans l’étape A, afin de soutenir une compétition en face-à-face.

Débuter la réplication du participant

Pour répliquer des participants, utilisez l’opération StartParticipantReplication. Vous devez appeler cette opération une fois pour chaque direction de réplication.

Répliquez le participant A dans l’étape 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

Répliquez le participant B dans l’étape 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

Une fois la réplication démarrée, les participants restent répliqués jusqu’à ce que vous arrêtiez explicitement l’opération à l’aide de l’opération StopParticipantReplication. Un participant répliqué qui se déconnecte puis se reconnecte durant l’intervalle spécifié par reconnectWindowSeconds réapparaîtra automatiquement à la fois dans les étapes source et de destination. La valeur par défaut du paramètre reconnectWindowSeconds est 0.

Arrêter la réplication du participant

Pour arrêter la réplication, appelez l’opération StopParticipantReplication.

Arrêtez la réplication du participant A de l’étape A à l’étape 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

Arrêtez la réplication du participant B de l’étape B à l’étape 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