# 웹서비스(게임시작) 런처 및 Agent 실행 가이드

웹서비스에서 "게임시작"을 통해 런처 및 Agent를 실행하기 위한 방법을 가이드 합니다.

고려사항
- 웹서비스에서 런처 및 Agent를 실행하기 위해 SEED Public 제공하며, 제공된 SEED Public 라이브러리 사용법을 가이드합니다.

# 1. SEED Public 라이브러리

환경	내용	비고
dev	https://static-new-dev.onstove.com/sl-4.0.0/stove-launcher.js
qa	https://static-new-qa.onstove.com/sl-4.0.0/stove-launcher.js
qa2	https://static-new-qa2.onstove.com/sl-4.0.0/stove-launcher.js
Sandbox	https://static-new.gate8.com/sl-4.0.0/stove-launcher.js
Live	https://static-new.onstove.com/sl-4.0.0/stove-launcher.js

# 2. SEED Public 라이브러리 head 참조

아래와 같이 SEED Pubilc 라이브러리 js 파일의 경로를 가지는 Script 태그를 head 태그 안에 위치 시킵니다.

<head> 
    <meta charset="UTF-8" /> 
    <title>stove launcher</title> 
    <script src="https://static-new.gate8.com/sl-4.0.0/stove-launcher.js" async defer></script>
</head>

1
2
3
4
5

# 3. 런처 및 Agent 실행 (LauncherService.open)

아래와 같이 SEED Public 라이브러리 에서 제공하는 LauncherService.open 함수를 호출 하여 런처 및 Agent 를 실행 시킬 수 있습니다.

LauncherService.open(
    {
        // 런처 실행 옵션 설정
        gameId: 'STOVE_TTO',
        isAgent: true,
        inflow_path: 'TTO',
        exearg: 'arg1 arg2'
    },
    () => {
        successCallBack();           // 런처 실행 성공시 실행 콜백 할당
    },
    (errorCode) => {
        failCallBack(errorCode);     // 런처 실행 실패시 실행 콜백 할당
    }
);

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

# 3.1 LauncherService.open 옵션 명세

Option	Value(type)	Requirement	Default Value	Description
gameId	String	Y	없음	게임 아이디
isAgent	Boolean	Y	없음	Agent 사용 여부 (GUID 지원 게임만 가능) - true:Agent사용 - false:Launcher사용
inflow_path	String	N	false	사용처 ex) 티타이니 : TTO
exearg	String	Y	없음	Agent 가 런처를 실행할때 실행 인자로 전달할 매개변수 - 영어 대/소문자, 숫자, 특수문자, 공백만 지원 - 인자를 여러 개 전달해야 할 경우 공백으로 분리해서 전달, Agent에서 게임으로 공백으로 분리된 String 그대로 전달 합니다.
successCallBack	Function			런처 및 Agent 실행에 성공 했을때 호출되는 콜백 함수 등록 - 런처 및 Agent 실행 성공 했을때 추가 처리해야 할 부분이 있으면 콜백 함수를 등록하면 된다. - 별도로 처리가 없다면 빈 함수로 등록하면 된다.
failCallBack	Function (Number)			런처 및 Agent 실행에 실패 했을때 호출되는 콜백 함수 등록 - 런처 및 Agent 실행 실패시에 처리하기 위한 콜백 함수를 등록한다. - 에러 코드가 인자로 전달되며, 관련한 자세한 내용은 아래 에러 코드 정의를 참고한다.

# 3-2. failCallBack (에러 발생시) 에러 코드 정의

ErrorCode	Description	ETC
601	클라이언트 환경에 Agent 또는 Launcher 가 설치되어 있지 않을 때 해당 코드 번호를 반환합니다.	Agent Dwonload - Sandbox : https://sgs-gate8-dl.game.playstove.com/game/lcs/STOVESetup_SGA.exe?launcherfilename=STOVESetup_SGA_TT.exe - Live : https://sgs-live-dl.game.playstove.com/game/lcs/STOVESetup_SGA.exe?launcherfilename=STOVESetup_SGA_TT.exe
602	실행한 게임 서비스가 점검 중일 때 해당 코드 번호를 반환합니다.
603	Agent 또는 Launcher API 호출 후 응답값이 비정상적일 경우 해당 코드를 반환합니다.

# 4. 샘플코드

환경	내용	비고
Sandbox	https://static-new.gate8.com/sl-4.0.0/index.html

샘플 페이지가 정상 동작 안 할 경우 브라우저 캐시를 삭제하고 다시 시도해 주세요

← SEED 라이브러리 연동 통합게임점검 체크 API →