1단계. 연동 환경 구성
Steam 계정으로 로그인하려면 외부 콘솔과 Hive 콘솔 설정을 마치고, 앱이 지원할 OS에 맞는 Add-on을 설치해야 합니다. 준비를 마친 뒤 2단계. 로그인을 구현하세요.
1. Steamworks에서 인증 정보 준비
Steamworks에서 Publisher Web API Key와 Steam App ID를 준비하세요.
2. Hive 콘솔에 인증 정보 등록
Steam 로그인을 활성화하고 Publisher Web API Key를 등록하세요. 자세한 절차는 Steam 로그인 인증 정보를 참조하세요.
Steam App ID는 로그인 설정에 입력하지 않습니다. Store App ID 등록에서 Steam 스토어 App ID의 Store App ID로 등록하세요.
3. Add-on 설치
앱이 지원할 OS에 맞는 Add-on을 설치합니다.
- Windows, macOS:
com.com2usplatform.hiveaxyl.auth.addon.steam - Android, iOS:
com.com2usplatform.hiveaxyl.auth.addon.webauth
설치와 초기화 방법은 모듈 설치 및 초기화를 참조하세요.
4. Steamworks 초기화
Windows와 macOS에서는 Steam 로그인 Add-on이 Steamworks를 통해 인증 티켓을 받습니다. Hive Axyl SDK는 Steamworks를 초기화하지 않으므로, 앱이 직접 초기화하고 유지해야 합니다.
초기화에 사용하는 SteamAPI는 Steam 로그인 Add-on이 com.com2usplatform.hiveaxyl.steamworks 패키지와 함께 가져오는 외부 패키지 com.rlabrecque.steamworks.net이 제공합니다. using Steamworks;를 추가해 사용하세요.
- 앱 시작 시
SteamAPI.Init()을 한 번 호출합니다. - 매 프레임
SteamAPI.RunCallbacks()를 호출해 Steamworks의 콜백을 처리합니다. - Steam 클라이언트 밖에서 개발용으로 실행한다면 실행 파일과 같은 위치에 steam_appid.txt 파일을 두고 Steam App ID를 적어 둡니다.
초기화하기 전에 Add-on을 호출하면 결과가 Failure로 반환되고 Failure.Problem.Code에 FailedPrecondition이 담깁니다.
5. Android와 iOS의 앱 콜백 준비
Android와 iOS에서는 웹 로그인 세션으로 Steam 로그인 페이지를 엽니다. Steam은 로그인 결과를 앱 고유 스킴 주소로 돌려보내지 않으므로, Steam의 응답은 Hive Axyl 중계 주소를 거쳐 앱 콜백 주소 {appId}://oauth-callback으로 돌아옵니다.
Android에서는 앱 콜백 주소의 스킴인 App ID를 빌드 설정에 등록하세요. iOS는 추가 설정이 필요하지 않습니다. 요청 구성과 콜백 처리는 2단계. 로그인을 참조하세요.