Unity용 SDK / 애플리케이션 런처를 통한 인증
 문서로 돌아가기

Unity용 SDK

  • 통합 가이드

  • 데모 프로젝트

  • 인증

  • 카탈로그

  • 구독

  • 프로모션

  • 아이템 구매

  • 플레이어 인벤토리

  • 사용자 계정 및 특성

  • 애플리케이션 빌드 가이드

  • 문제 해결


  • 애플리케이션 런처를 통한 인증

    엑솔라 런처 또는 Steam을 사용해 사용자에게 애플리케이션을 전달하는 경우, 런처의 자격 증명을 통해 사용자를 자동으로 인증할 수 있습니다.

    방법

    저희가 제공하는 방법 안내서에서 고급 설정에 대해 자세히 알아보세요.

    런처를 통해 애플리케이션에서 권한 부여 설정 방법

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

    주의
    런처를 사용하려면 로그인을 구현해야 합니다. 다른 권한 부여 시스템을 사용하는 것은 지원되지 않습니다.

    함께 작업하기 위한 SDK와 런처를 설정

    1. 런처 설정은 게시자 계정에서 합니다.

    알림
    config.json 파일에서, 다음 객체의 값을 바꾸는 것으로 충분합니다.
    • launcher_project_id런처 ID게시자 계정 > 런처 > 일반 설정 > 일반 정보에서 명시하며
    • login_project_id로그인 ID게시자 계정 > 런처 > 일반 설정 > 인증에서 명시합니다

    1. 런처 UI 맞춤 설정.

    주의
    엑솔라 서버와 SDK 통합은 Commerce API 호출이 사용하므로 런처 스토어는 지원되지 않습니다.

    1. 런처 권한 부여 로직을 귀하의 애플리케이션에서 구현합니다.
    2. 런처 설치 파일 및 빌드 아카이브를 생성합니다.
    3. 애플리케이션 빌드를 생성합니다.
    4. 엑솔라 업데이트 서버에 애플리케이션 빌드를 업로드합니다.

    런처를 통한 권한 부여 논리 구현

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

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

    알림
    SDK 메서드가 얻은 토큰을 사용하여 인게임 스토어 열기, 결체 처리 등을 합니다. 토큰을 Token.Instance 속성을 전달합니다.

    애플리케이션 빌드 만들기

    1. Unity 프로젝트로 이동합니다.
    2. Window > Xsolla > Edit Settings을 메인 메뉴에서 클릭합니다. Inspector 창에서:
      1. Project ID 필드에서 프로젝트 ID를 지정하는데, 이는 게시자 계정 > 프로젝트 설정 > 프로젝트 ID에서 찾을 수 있습니다.
      2. Login ID 필드에서 로그인 ID를 지정하는데, 이는 게시자 계정 > 런처 > 일반 설정 > 인증에서 찾을 수 있습니다.

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

    이 기사가 도움이 되었나요?
    감사합니다!
    개선해야 할 점이 있을까요? 메시지
    유감입니다
    이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
    의견을 보내 주셔서 감사드립니다!
    메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
    숨기기

    Steam을 통한 네이티브 인증 설정 방법

    주의
    Unity 프로젝트에 데모 프로젝트를 포함했다면 이 사용 방법 가이드를 사용하세요.

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

    네이티브 인증 설정 방법:

    1. 게시자 계정에서 Steam을 통한 암묵 인증 설정.
    2. Unity 프로젝트 구성.
    3. 이벤트 처리 구성.
    4. Steam을 통한 인증 확인.

    내 Unity 프로젝트 구성하기

    1. steam_appid.txt 파일을 생성하고 해당 파일에 Steam의 애플리케이션 ID를 입력합니다. 그런 다음 이 파일을 프로젝트의 Assets/Plugins/Steamworks.NET/redist/ 카탈로그에 배치합니다.

    알림
    GitHub에서 SDK를 다운로드한 경우에 Assets/Plugins/Steamworks.NET/redist/ 카탈로그에서 steam_appid.txt파일을 찾을 수 있습니다. 이 파일에는 데모 프로젝트용 Steam의 애플리케이션 ID가 포함되어 있습니다.

    1. Unity 프로젝트를 엽니다.
    2. 메인 메뉴에서 Window > Xsolla > Demo Settings으로 이동합니다.
    3. Inspector패널에서:
      1. Use Steam authorization 상자를 선택합니다.
      2. Steam App ID필드에 Steam의 애플리케이션 ID를 지정합니다. 값은 steam_appid.txt 파일의 값과 동일해야 합니다.

    이벤트 처리 구성하기

    Steam을 통해 사용자를 인증하려면 session ticketSilentAuth 메소드로 전달해야 합니다. 예시는 데모 프로젝트SteamAuth.cs 클래스를 참조합니다.

    Steam을 통한 인증 확인

    1. 단독 플랫폼에 사용하거나 장면을 시작하기 위한 Unity 프로젝트 빌드를 생성합니다.
    2. Steam을 실행한 후 로그인합니다.
    3. 내 애플리케이션을 실행합니다. 모든 내용이 정상일 경우 애플리케이션에 자동으로 로그인합니다.

    이 기사가 도움이 되었나요?
    감사합니다!
    개선해야 할 점이 있을까요? 메시지
    유감입니다
    이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
    의견을 보내 주셔서 감사드립니다!
    메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
    숨기기
    마지막 업데이트: 2022년 8월 1일

    오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.

    문제 보고
    콘텐츠를 항상 검토합니다. 여러분의 피드백은 콘텐츠를 개선에 도움이 됩니다.
    후속 조치를 위해 이메일을 제공해 주세요
    의견을 보내 주셔서 감사드립니다!