Orden personalizado de los participantes - Amazon IVS
Cómo funciona el orden personalizadoCreación de tokens con atributos de ordenEjemplos de casos de usoCompatibilidad con versiones anteriores

Orden personalizado de los participantes

El orden personalizado de los participantes le permite controlar la posición de los participantes en los diseños de cuadrícula y de imagen en imagen en función de los valores de los atributos personalizados en los tokens de los participantes, incluida la posición de los participantes destacados y la selección de los participantes para la ventana de imagen en imagen. Esto proporciona un posicionamiento determinista de los participantes y permite diseños basados en roles.

Cómo funciona el orden personalizado

Cuando participantOrderAttribute se especifica en la configuración del diseño, los participantes se ordenan de acuerdo con las siguientes reglas:

  • Los participantes con el atributo de orden especificado en sus tokens se posicionan en primer lugar y se ordenan numéricamente según los valores de sus atributos.

  • Los participantes sin el atributo de orden se ordenan según la hora de llegada y se colocan después de los participantes ordenados.

  • Cuando varios participantes tienen valores de orden idénticos, se subclasifican según su hora de llegada al escenario.

  • El orden utiliza una clasificación numérica (no lexicográfica), por lo que el número «10» viene después del «9» (no después del «1»).

  • También se admiten valores negativos. Se colocan antes de los valores positivos.

  • Los valores no numéricos (p. ej., «abc», «1,5») se consideran inválidos y esos participantes se ordenan según la hora de llegada.

Importante: El orden de los participantes (ya sea en función de la hora de llegada o de forma personalizada) surtirá efecto una vez que se haya iniciado la composición. El orden correcto de los participantes no está garantizado para los participantes que se unan al escenario antes de que comience la composición.

Creación de tokens con atributos de orden

Para utilizar un orden de participantes personalizado, incluya el atributo de ordenación en sus tokens de participante al crearlos:

aws ivs-realtime create-participant-token --stage-arn "arn:aws:ivs:us-east-1:123456789012:stage/u9OiE29bT7Xp" --attributes order=1

aws ivs-realtime create-participant-token --stage-arn "arn:aws:ivs:us-east-1:123456789012:stage/u9OiE29bT7Xp" --attributes order=2

aws ivs-realtime create-participant-token --stage-arn "arn:aws:ivs:us-east-1:123456789012:stage/u9OiE29bT7Xp" --attributes order=3

Puedes combinar el atributo de orden de los participantes personalizados con los atributos para seleccionar a los participantes del espacio destacado y de la ventana de imagen en imagen:

aws ivs-realtime create-participant-token --stage-arn "arn:aws:ivs:us-east-1:123456789012:stage/u9OiE29bT7Xp" --attributes order=2,isFeatured=true

aws ivs-realtime create-participant-token --stage-arn "arn:aws:ivs:us-east-1:123456789012:stage/u9OiE29bT7Xp" --attributes order=3,isFeatured=true

aws ivs-realtime create-participant-token --stage-arn "arn:aws:ivs:us-east-1:123456789012:stage/u9OiE29bT7Xp" --attributes order=4,isPip=true

Ejemplos de casos de uso

Entre los casos de uso de ejemplo se incluyen:

  • Posicionamiento uniforme: los participantes mantienen sus posiciones cuando se vuelven a conectar con el mismo token.

  • Posicionamiento basado en roles: por ejemplo, puede especificar a los profesores con un orden igual a 1 y a los estudiantes con un orden igual a 2.

  • Diseños basados en prioridades: los participantes VIP con valores de orden más bajos aparecerían primero.

  • Diseños dinámicos: puede combinar el orden personalizado con featuredParticipantAttribute y pipParticipantAttribute para escenarios complejos.

  • Interacciones entre escenarios: al utilizar la replicación de participantes en escenarios como las competiciones del modo VS, en las que interactúan streamers de diferentes escenarios, puede anular los atributos de orden para controlar el posicionamiento en la composición del escenario de destino.

Nota: Para los casos de uso de la replicación de los participantes, puede anular los atributos de los participantes (incluido el atributo de orden) según sea necesario al iniciar una replicación para lograr el diseño deseado en la etapa de destino.

Compatibilidad con versiones anteriores

El orden personalizado de los participantes es una característica opcional y es totalmente compatible con versiones anteriores. Las composiciones existentes sin participantOrderAttribute siguen funcionando sin cambios y utilizan el orden de llegada. Cuando se establece participantOrderAttribute en una cadena vacía, el sistema ignora por completo el orden personalizado y vuelve al comportamiento predeterminado.