사용자 지정 참가자 순서 지정 - Amazon IVS
사용자 지정 순서 지동 작동 방식순서 지정 속성을 사용하여 토큰 생성사용 사례 예시이전 버전과의 호환성

사용자 지정 참가자 순서 지정

사용자 지정 참가자 순서 지정을 사용하면 주요 참가자의 배치 및 PiP 창의 참가자 선택을 포함하여 참가자 토큰의 사용자 지정 속성 값을 기반으로 그리드 및 PiP 레이아웃 모두에서 참가자의 배치를 제어할 수 있습니다. 이를 통해 결정론적 참가자 배치가 가능하고 역할 기반 레이아웃을 활성화할 수 있습니다.

사용자 지정 순서 지동 작동 방식

participantOrderAttribute가 레이아웃 구성에 지정되면 참가자는 다음 규칙에 따라 순서가 지정됩니다.

  • 토큰에 순서 지정 속성이 지정된 참가자가 먼저 배치되고, 속성 값을 기준으로 숫자 순서로 정렬됩니다.

  • 순서 지정 속성이 없는 참가자는 도착 시간 순서 지정으로 돌아가서 순서가 지정된 참가자 뒤에 배치됩니다.

  • 여러 참가자의 순서 지정 값이 동일한 경우 스테이지에 도착한 시간을 기준으로 정렬됩니다.

  • 순서 지정은 (사전 순서가 아닌) 숫자 순서 정렬을 사용하므로 "10"은 ("1" 뒤가 아닌) "9" 뒤에 옵니다.

  • 음수 값이 지원됩니다. 음수 값은 양수 값 앞에 배치됩니다.

  • 숫자가 아닌 값(예: "abc", "1.5")은 유효하지 않은 것으로 취급되며, 이 값을 가진 참가자에게 도착 시간 순서 지정이 적용됩니다.

중요: 참가자 순서 지정(도착 시간 또는 사용자 지정 기준)은 구성이 시작된 후 적용됩니다. 구성이 시작되기 전에 스테이지에 참가하는 참가자에 대해서는 올바른 참가자 순서 지정이 보장되지 않습니다.

순서 지정 속성을 사용하여 토큰 생성

사용자 지정 참가자 순서 지정을 사용하려면 참가자 토큰을 생성할 때 참가자 토큰에 순서 지정 속성을 포함합니다.

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

custom-participant-order 속성을 추천 슬롯 및 PiP 창의 참가자를 선택하는 속성과 결합할 수 있습니다.

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

사용 사례 예시

사용 사례 예시:

  • 일관적인 배치 - 참가자가 동일한 토큰으로 다시 연결할 때 위치를 유지합니다.

  • 역할 기반 배치 - 예를 들어 교사에는 order=1, 학생에는 order=2를 지정할 수 있습니다.

  • 우선 순위 기반 레이아웃 - 순서 값이 낮은 VIP 참가자가 먼저 표시됩니다.

  • 동적 레이아웃 - 복잡한 시나리오에서 사용자 지정 순서 지정과 featuredParticipantAttribute 및 pipParticipantAttribute를 결합할 수 있습니다.

  • 스테이지 간 상호 작용 - 서로 다른 스테이지의 스트리머가 상호 작용하는 VS Mode 경쟁과 같은 시나리오에 참가자 복제를 사용하는 경우 순서 지정 속성을 재정의하여 대상 스테이지 구성에서의 배치를 제어할 수 있습니다.

참고: 참가자 복제 사용 사례의 경우 복제를 시작할 때 필요에 따라 참가자 속성(순서 속성 포함)을 재정의하여 대상 스테이지에서 원하는 레이아웃을 달성할 수 있습니다.

이전 버전과의 호환성

사용자 지정 참가자 순서 지정은 선택적 기능이며 이전 버전과 완전히 호환됩니다. participantOrderAttribute가 없는 기존 구성은 도착 시간 순서 지정을 사용하여 변경 없이 계속 작동합니다. participantOrderAttribute가 빈 문자열로 설정된 경우 시스템은 사용자 지정 순서 지정을 완전히 무시하고 기본 동작이 적용됩니다.