Skip to content

소개

JOGOS_SDK를 통합하기 전에 반드시 요구사항을 준수해 주세요. 이 문서는 JOGOS_SDK를 최적의 방식으로 사용할 수 있도록 기술, 게임 콘텐츠, 광고 및 계정 통합 요구사항에 대한 가이드를 제공합니다.
Unity와 Cocos는 전용 SDK를 사용할 수 있지만, 다른 엔진은 HTML5 버전으로 기능을 통합할 수 있습니다. 대부분의 WebGL을 지원하는 게임 엔진은 브라우저에서 실행 시 JavaScript와 상호작용할 수 있는 방법을 제공하기 때문입니다.

JOGOS_SDK는 다음 모듈을 포함합니다:

모듈설명네이티브 HTML5CocosUnity
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>
수동 초기화

JOGOS_SDK는 사용 전 초기화가 필요합니다. JOGOS_SDK.init 메서드를 호출하여 초기화를 완료하세요:

javascript
await window.JOGOS_SDK.init();

JOGOS_SDK.init 메서드는 비동기식이며, 이 메서드가 성공적으로 실행되기 전에는 다른 어떤 메서드도 사용할 수 없습니다. 게임 시작 전에 이 작업을 수행할 것을 강력히 권장합니다.

JOGOS_SDK.init 메서드가 성공적으로 호출되지 않은 상태에서 다른 메서드를 호출하면 "460 Can only be called after the successful call of the JOGOS_SDK.init method" 예외가 발생합니다.

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 통합이 완료된 후 개발자 포털 에서 새 게임을 생성하고 관련 게임 리소스 파일을 업로드하면 게임을 미리 볼 수 있습니다.