공식 홈페이지에서 “게임 시작” 버튼을 통해 스토브 클라이언트를 실행하기 위한 가이드입니다.
모든 스토브의 게임은 스토브 클라이언트를 통해 실행됩니다.
고려사항
•
웹서비스에서 런처 및 Agent를 실행하기 위해 SEED Public 제공하며, 제공된 SEED Public 라이브러리 사용법을 가이드합니다.
1. SEED Public 라이브러리
환경 | 내용 | 비고 |
Live | https://static-new.onstove.com/sl-4.0.0/stove-launcher.js | |
Sandbox | https://static-new.gate8.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.onstove.com/sl-4.0.0/stove-launcher.js" async defer></script>
</head>
JavaScript
복사
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); // 런처 실행 실패시 실행 콜백 할당
}
);
JavaScript
복사
3.1 LauncherService.open 옵션 명세
Option | Value(type) | Requirement | Default Value | Description |
gameId | String | Y | 없음 | 게임 아이디 |
isAgent | Boolean | Y | 없음 | False 로 설정 |
inflow_path | String | N | false | 사용처 |
exearg | String | Y | 없음 | 런처를 실행할때 실행 인자로 전달할 매개변수 |
successCallBack | Function | 런처 및 Agent 실행에 성공 했을때 호출되는 콜백 함수 등록
- 런처 및 Agent 실행 성공 했을때 추가 처리해야 할 부분이 있으면 콜백 함수를 등록하면 된다.
- 별도로 처리가 없다면 빈 함수로 등록하면 된다. | ||
failCallBack | Function (Number) | 런처 및 Agent 실행에 실패 했을때 호출되는 콜백 함수 등록
- 런처 및 Agent 실행 실패시에 처리하기 위한 콜백 함수를 등록한다.
- 에러 코드가 인자로 전달되며, 관련한 자세한 내용은 아래 에러 코드 정의를 참고한다. |
3.2. failCallBack (에러 발생시) 에러 코드 정의
ErrorCode | Description | ETC |
601 | 클라이언트 환경에 Agent 또는 Launcher 가 설치되어 있지 않을 때 해당 코드 번호를 반환합니다. | |
602 | 실행한 게임 서비스가 점검 중일 때 해당 코드 번호를 반환합니다. | |
603 | Agent 또는 Launcher API 호출 후 응답값이 비정상적일 경우 해당 코드를 반환합니다. |
4. 샘플코드
환경 | 내용 | 비고 |
Sandbox | https://static-new.gate8.com/sl-4.0.0/index.html |
•
샘플 페이지가 정상 동작 안 할 경우 브라우저 캐시를 삭제하고 다시 시도해 주세요
