소개
JOGOS_SDK
를 통합하기 전에 반드시 요구사항을 준수해 주세요. 이 문서는 JOGOS_SDK
를 최적의 방식으로 사용할 수 있도록 기술, 게임 콘텐츠, 광고 및 계정 통합 요구사항에 대한 가이드를 제공합니다.
Unity와 Cocos는 전용 SDK를 사용할 수 있지만, 다른 엔진은 HTML5
버전으로 기능을 통합할 수 있습니다. 대부분의 WebGL
을 지원하는 게임 엔진은 브라우저에서 실행 시 JavaScript
와 상호작용할 수 있는 방법을 제공하기 때문입니다.
JOGOS_SDK
는 다음 모듈을 포함합니다:
모듈 | 설명 | 네이티브 HTML5 | Cocos | Unity |
---|---|---|---|---|
JOGOS_SDK.user | 로그인 사용자와 상호작용 | 🟩 완전 지원 | 🟩 완전 지원 | 🟩 완전 지원 |
JOGOS_SDK.game | 게임 동작 | 🟩 완전 지원 | 🟩 완전 지원 | 🟩 완전 지원 |
JOGOS_SDK.banner | 게임 내 배너 광고 | 🟩 완전 지원 | 🟩 완전 지원 | 🟩 완전 지원 |
JOGOS_SDK.ad | 동영상 광고 | 🟩 완전 지원 | 🟩 완전 지원 | 🟩 완전 지원 |
JOGOS_SDK.data | 클라우드 저장 | 🟦 출시 예정 | 🟦 출시 예정 | 🟦 출시 예정 |
JOGOS_SDK.friend | 친구 및 그룹 | 🟨 미지원 | 🟨 미지원 | 🟨 미지원 |
JOGOS_SDK.purchase | 인앱 결제 및 일회성 구매 | 🟩 완전 지원 | 🟩 완전 지원 | 🟩 완전 지원 |
JOGOS_SDK.Active | 도전 과제 및 리더보드 | 🟦 출시 예정 | 🟦 출시 예정 | 🟦 출시 예정 |
시작하기
이 섹션에서는 엔진에서 JOGOS_SDK
를 시작하고 실행하는 방법을 설명합니다.
게임의 index.html
파일 내 body
태그에 다음 스크립트를 추가하여 JOGOS_SDK
를 로드하세요:
html
<script src="https://www.jogos.com/sdk/jogos-sdk-v1.js"></script>
Promise
JOGOS_SDK
의 대부분의 메서드는 비동기식이며, await
방식으로 호출할 수 있습니다:
javascript
try {
const user = await window.JOGOS_SDK.user.getUser();
console.log(user);
} catch (err) {
console.log('사용자 정보 가져오기 오류: ', err);
}
Promise
방식으로도 호출할 수 있습니다:
javascript
window.JOGOS_SDK.user
.getUser()
.then((user) => console.log(user))
.catch((err) => console.log('사용자 정보 가져오기 오류: ', err));
예제 씬 다운로드: HTML5_Demo.zip
중요 정보
초기화 성공 콜백 후 SysInfo
정보를 얻을 수 있습니다. 이 섹션을 놓치지 마세요. 사용 중인 게임 엔진에 대한 중요한 정보가 포함되어 있습니다. 플랫폼 사용자의 현재 언어 유형을 얻을 수 있으며, 플레이어가 게임에 진입할 때 자동으로 현지화 언어를 매칭할 수 있습니다. 게임 내 실제 서버 시간을 업데이트할 수도 있습니다.
javascript
SysInfo{
"gameId": number; // 게임 ID
"hasGameGroup": bool; // 그룹 채팅 활성화 여부
"deviceType": "desktop"; // 가능한 값: "desktop", "tablet", "mobile"
"language": string; // 언어 유형
"os": "Windows 10"; // OS 및 버전
"browser": "Chrome 10.0"; // 브라우저 및 버전
"serverTime": number; // 현재 서버 시간
}
개발 및 테스트
개발 과정에서 JOGOS_SDK
를 다른 환경에서 실행하게 됩니다:
localhost
: 로컬 디버깅 시JOGOS_SDK
는동영상 광고/배너
등의 동작을 시뮬레이션하며, 실제 서비스와 상호작용하거나 실제 광고를 로드하지 않습니다.Preview tool
: 저희QA
환경에서 실제 미리보기 및 검증 기능을 제공합니다.JOGOS_SDK
통합이 완료된 후 개발자 포털 에서 새 게임을 생성하고 관련 게임 리소스 파일을 업로드하면 게임을 미리 볼 수 있습니다.