엑솔라 런처를 사용하여 여러분의 애플리케이션을 사용자에게 전달하고 업데이트할 수 있습니다. 런처는 인증 도구를 내장하고 있습니다. 사용자 이름과 비밀번호의 재입력을 피하려면 런처를 통해 애플리케이션에서 인증하도록 설정하세요.

1. 애플리케이션에서 런처 인증 로직을 구현합니다.
2. 애플리케이션 빌드 생성을 수행하여 런처에 업로드합니다.

런처를 통해 인증용 로직 구현하기

런처를 통한 애플리케이션의 권한 부여 절차:

1. 사용자가 런처에서 권한 부여를 받습니다.
2. 사용자가 애플리케이션을 설치하고 실행합니다.
3. 런처가 애플리케이션을 실행하고 사용자 매개 변수를 명령 줄을 통해 전달합니다. 권한 부여 토큰이 xsolla-login-token 매개 변수에서 전달됩니다.
4. 애플리케이션이 명령 줄 매개 변수를 처리하고 토큰을 얻습니다.
5. 애플리케이션이 받은 토큰의 유효성을 검사합니다.
6. 애플리케이션이 권한 부여 페이지를 표시하지 않고 자동으로 사용자에게 권한을 부여합니다.

설명된 로직을 구현하려면 AuthViaXsollaLauncher SDK 메소드를 사용하면 됩니다.

런처를 통한 인증용 스크립트의 예시:

using UnityEngine;
using Xsolla.Auth;
using Xsolla.Core;

namespace Xsolla.Samples.Authorization
{
	public class AuthorizationViaXsollaLauncher : MonoBehaviour
	{
		private void Start()
		{
			// Start authorization via Xsolla Launcher
			// Pass callback functions for success and error cases
			XsollaAuth.AuthViaXsollaLauncher(OnSuccess, OnError);
		}

		private void OnSuccess()
		{
			Debug.Log("Authorization successful");
			// Add actions taken in case of success
		}

		private void OnError(Error error)
		{
			Debug.LogError($"Authorization failed. Error: {error.errorMessage}");
			// Add actions taken in case of error
		}
	}
}

애플리케이션 빌드 만들기

1. Unity 프로젝트로 이동합니다.
2. SDK 설정이 런처 설정(런처 > 일반 설정 > 인증)의 관리자 페이지에 지정된 로그인 프로젝트 ID를 표시하는지 확인해 주세요.

3. 토큰이 처리되고 있는 사용자 권한 부여 장면을 실행합니다.
4. 메인 메뉴에서 File > Build settings을 클릭한 다음 Add Open Scenes을 클릭합니다. 권한 부여 장면이 목록에 첫 번째로 추가되었는지 확인합니다.
5. Build를 클릭합니다.
6. 팝업 창에서 완료된 빌드가 위치할 디렉터리로 가는 경로를 지정합니다.

네이티브 인증을 사용하면 플레이어가 설치된 Steam 애플리케이션을 통해 여러분의 애플리케이션으로 진입할 수 있습니다.

네이티브 인증 설정 방법:

1. 관리자 페이지에서 Steam을 통한 암묵인증을 설정합니다.
2. Unity 프로젝트를 구성합니다.
3. Steam을 통한 인증용 로직을 구현합니다.
4. Steam을 통한 인증을 확인합니다.

내 Unity 프로젝트 구성하기

1. Unity 프로젝트의 루트 폴더에 있는 steam_appid.txt 파일을 엽니다.
2. 파일에서 Steam의 애플리케이션 ID를 지정하고 변경 사항을 저장합니다. 파일의 기본값은 Steam 테스트 프로젝트의 ID인 480입니다.
3. 변경 사항을 적용하려면 Unity 에디터를 다시 시작합니다.

Steam을 통해 인증용 로직 구현하기

인증을 시작하려면 SilentAuth SDK 메소드를 사용하고 다음 매개변수를 전달합니다.

• providerName - 애플리케이션의 퍼블리싱 플랫폼입니다. steam을 값으로 전달합니다.
• appId - Steam에서 애플리케이션 ID입니다. 이 값은 steam_appid.txt 파일에 지정된 값과 일치해야 합니다.
• sessionTicket - Steam 세션 티켓입니다. 이를 구하려면 SteamUtils.GetSteamSessionTicket() 메소드를 호출합니다.
• onSuccess - 성공한 사용자 인증 콜백입니다.
• onError - 오류 콜백입니다.

Steam을 통한 인증용 스크립트의 예시:

using UnityEngine;
using Xsolla.Auth;
using Xsolla.Core;

namespace Xsolla.Samples.Steam
{
	public class SteamNativeAuthorization : MonoBehaviour
	{
		private void Start()
		{
			// Get the steam session ticket from `SteamUtils` class
			var steamSessionTicket = SteamUtils.GetSteamSessionTicket();

			// Start silent authentication
			// Pass `steam` as `providerName` parameter
			// Pass your `Steam App ID` as `appId` parameter. We use `480` as an example
			// Pass `steamSessionTicket` variable as the `sessionTicket` parameter
			// Pass callback functions for success and error cases
			XsollaAuth.SilentAuth("steam", "480", steamSessionTicket, OnSuccess, OnError);
		}

		private void OnSuccess()
		{
			Debug.Log("Authorization successful");
			// Add actions taken in case of success
		}

		private void OnError(Error error)
		{
			Debug.LogError($"Authorization failed. Error: {error.errorMessage}");
			// Add actions taken in case of error
		}
	}
}

Steam을 통한 인증 확인

1. Steam을 시작하고 로그인합니다. 그렇지 않으면 Requested steam session ticket is null. Please check your Steam settings 오류와 함께 콜백 함수가 호출됩니다.
2. 단독 플랫폼을 위한 Unity 프로젝트 빌드를 생성하고 Unity 편집기에서 실행하거나 장면을 시작합니다. 모든 내용이 정상이면 애플리케이션에 자동으로 로그인합니다.