기술 자료

​
​

Development

User Acquisition

Monetization

산업 분야

Vivox Unity SDK

Vivox Unity SDK

Vivox
​
​
Vivox Unity SDK
  • Overview
  • Get started
  • Release notes
  • Developer guide
  • Tutorials
    • Implement Vivox Unity
    • Access Token Developer Guide
      • Access token terminology
      • Requests that require access tokens
      • Access token identifiers
      • Access token format
        • Access token header
        • Access token payload
        • Access token signature
        • Supported values for the Vivox action claim
      • Access token examples
      • Generate a token from the client
      • Generate a token on a secure server
      • Key update API
      • Access token error codes
  • Reference
  1. Vivox Unity SDK 기술 자료

액세스 토큰 페이로드

Understand the payload section of a Vivox Access Token.
읽는 시간 2분
최근 업데이트: 8달 전
페이로드는 base64url로 인코딩된 JSON 객체로, 토큰에서 보장하는 클레임을 포함합니다. 페이로드에 클레임을 순서에 상관없이 나열할 수 있습니다.
다음 표에 토큰에 사용할 수 있는 클레임이 자세히 나와 있습니다. 각 토큰에 필요한 파라미터에 대한 자세한 내용은 액세스 토큰 예제를 참고하시기 바랍니다.

페이로드 내 Unity Authentication ID

애플리케이션에서 Unity Authentication 서비스를 사용하여 플레이어를 인증하는 경우, Vivox 액세스 토큰 내에서 UAS ID를 사용하여 적절한 플레이어 ID를 확인할 수 있습니다. 플레이어를 식별하는 데 사용되는 SIP URI는 전체 SIP URI에서 플레이어 ID가 파싱되도록 적절한 형식이어야 합니다. 이 형식은 VAT가 적용되는 모든 Unity Moderation 서비스를 사용하는 데 필수입니다.
다음은 예상되는 SIP 형식의 예입니다.
sip:.issuer.unity_player_id.unity_environment_id.@domain.vivox.com
UAS에서 작동하려면 
f
와 
sub
필드가 이 형식을 사용해야 합니다.
참고
예제의 파라미터만 포함되어 있는지 확인합니다. 잘못된 파라미터가 포함된 클레임은 API 호출 시 ‘유효하지 않은 서명’ 또는 ‘잘못된 형식의 페이로드’ 오류가 반환됩니다.
클레임예제 값설명
vxi
1
토큰의 고유함을 보장합니다. 다른 모든 클레임이 동일하다면 이 값은 반드시 달라야 합니다. 그렇지 않으면 토큰이 이미 사용된 것으로 간주되어 거부될 수 있습니다. 토큰이 한 개 생성될 때마다 1씩 증가하는 무부호 정수를 사용하는 것이 좋습니다.
sub
sip:.blindmelon-AppName-dev.jerky.@tla.vivox.com
대상. 음소거와 추방 액션에 사용하는 사용자 SIP URI입니다. 음소거나 음소거 해제 또는 추방된 사용자입니다.
f
sip:.blindmelon-AppName-dev.beef.@tla.vivox.com
부터. 모든 액션에 사용하는 사용자 SIP URI입니다. 로그인, 채널 참여, 다른 사용자 음소거 등의 액션을 수행하는 사용자입니다.
iss
blindmelon-AppName-dev
애플리케이션별 발급자. Unity Cloud 대시보드에서 애플리케이션을 생성하면 발급자가 제공됩니다.
vxa
추방
Vivox 액션. 자세한 내용은 Vivox 액션 클레임에 지원되는 값을 참고하시기 바랍니다.
t
sip:confctl-g-blindmelon-AppName-dev.testchannel@tla.vivox.com
까지. 참여, 음소거, 추방, 트랜스크립션 액션에 사용하는 채널 SIP URI입니다. 액션이 발생하는 채널입니다.
exp
1600349400
만료 시점(epoch 초). 이 값은 일반적으로 현재 시각에 90초를 더한 값입니다.
Copyright © 2026 Unity Technologies
법률 정보개인정보 처리방침쿠키Documentation Terms of Use개인 정보 판매 또는 공유 금지개인정보 보호 선택(쿠키 설정)

'Unity', Unity 로고 및 기타 Unity 상표는 미국 및 기타 지역 내 Unity Technologies 또는 그 계열사의 상표 또는 등록상표입니다(자세한 내용은 여기에서 확인하세요). 기타 명칭 또는 브랜드는 해당 소유자의 상표입니다.

일부 페이지는 편의를 위해 기계 번역되었으며 부정확한 내용이 있을 수 있습니다. 정보가 상충되는 경우, 영어 버전을 우선으로 참조하세요.

  • 보고 있는 페이지

    • 페이로드 내 Unity Authentication ID

이 페이지의 문제 보고