기술 자료

지원

Vivox Unity SDK

Vivox Unity SDK

게임에 로그인

How to sign in a player to Vivox services.
읽는 시간 1분최근 업데이트: 4일 전
Vivox SDK를 초기화한 후 사용자는 게임에 할당된 Vivox 인스턴스에 로그인할 수 있습니다. 플레이어에 사용되는 이름은 Unity AuthenticationId이거나 Unity Authentication을 사용하지 않는 경우 새 GUID입니다.
참고
발행자나 도메인을 Account 생성자에 전달한 사용자 이름의 일부에 포함해서는 안 됩니다. Account 생성자가 이를 처리합니다.
초기화 후 
VivoxService.Instance.LoginAsync
 메서드를 호출하여 Vivox에 로그인합니다. 
  • VivoxService.Instance.LoginAsync
    의 선택적 인수는 사용자의 표시 이름을 설정하거나, 텍스트 투 스피치를 활성화하거나, 차단된 사용자 목록을 로드할 수 있는 LoginOptions 구조체입니다.
LoginOptions에 표시 이름이 설정된 경우 이 이름은 참여하는 채널의 모든 사용자에게 표시됩니다. 
VivoxService.Instance.ParticipantAddedToChannel
 또는 
VivoxService.Instance.ParticipantRemovedFromChannel
의 VivoxParticipant 결과 내에서 DisplayName으로 수신됩니다.
  • 이 표시 이름은 현재 세션에서만 유효하며 Vivox 네트워크에서 유지되지 않습니다.
  • 표시 이름 길이는 최대 127바이트를 초과할 수 없습니다.
참고
Vivox SDK는 표시 이름을 검사하지 않습니다. 표시 이름의 게임 규칙 준수 여부, 게임 내 렌더러에서 지원하는 폰트 문자의 사용 여부, 이름의 중복 및 사칭 여부를 확인하는 것은 개임 개발자의 책임입니다. 게임 클라이언트가 아닌 게임 서버 등의 대역 외 수단을 사용하여 표시 이름을 확인하는 것이 좋습니다.
다음은 로그인 프로세스를 시작하고 DisplayName을 ‘Bob’으로 설정하고 텍스트 투 스피치를 활성화하는 방법에 대한 예제를 보여 주는 코드입니다. 
using UnityEngine;using Unity.Services.Vivox;class LogInExample : MonoBehaviour{    . . .    async void LoginUserAsync()    {        // For this example, the VivoxService is initialized.        var loginOptions = new LoginOptions()        {            DisplayName = "Bob",            EnableTTS = true        };        VivoxService.Instance.LoginAsync(loginOptions)    }    . . .}
LoginAsync가 호출되었을 때 이벤트를 가져오기 위해 
VivoxService.Instance.LoggedIn
과 
VivoxService.Instance.LoggedOut
을 구독할 수 있습니다. 다음은 
VivoxService.Instance.LoggedIn
과 
VivoxService.Instance.LoggedOut
이벤트 구독 방식과 함수로 다른 LoginState 값을 처리하는 방법의 예제를 보여 주는 코드입니다. 
using UnityEngine;using Unity.Services.Vivox;class LoginPropChangeExample : MonoBehaviour{    . . .    VivoxService.Instance.LoggedIn += onLoggedIn;    VivoxService.Instance.LoggedOut += onLoggedOut;    . . .    private void onLoggedIn()    {        // Operations as needed    }    private void onLoggedOut()    {        // Operations as needed    }}
참고
애플리케이션이 시작될 때 사용자가 로그인하는 것이 바람직합니다. 사용자가 앱 내에서 다른 계정으로 로그인할 수 있는 경우, 사용자가 게임 서버에 연결할 때 로그인하는 것이 바람직합니다.