소개

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

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

모듈	설명	SDK 지원	접수 권고사항
JOGOS_SDK.init	SDK 초기화	🟩 완전 지원	☑️ 필수 접수, 아래에서 구체적 설명
JOGOS_SDK.game	게임 행동	🟩 완전 지원	☑️ 필수, 당사에 게임 로드, 시작 또는 일시 정지 알림
JOGOS_SDK.user	로그인 사용자와 상호 작용	🟩 완전 지원	🔳 선택사항, 사용자 시스템 사용 시 필요
JOGOS_SDK.banner	게임 내 배너 광고	🟩 완전 지원	🔳 선택사항, 게임 내 Banner 광고가 있는 경우
JOGOS_SDK.ad	보상형 동영상 및 전면 광고	🟩 완전 지원	🔳 선택사항, 게임 내 동영상 광고가 있는 경우
JOGOS_SDK.data	클라우드 저장	🟦 출시 예정	🔳 선택사항, Jogos 클라우드 저장소 사용 시
JOGOS_SDK.friend	친구 및 그룹	🟨 지원 예정	🔳 선택사항, 게임 내 플레이어 상호 작용 시스템 사용 시
JOGOS_SDK.payment	인앱 결제 및 일괄 구매	🟦 출시 예정	🔳 선택사항, 게임에 인앱 결제 또는 일괄 구매가 있는 경우
JOGOS_SDK.active	도전 과제 및 리더보드	🟩 완전 지원	🔳 선택사항, Jogos의 도전 과제 및 리더보드 시스템 사용 시
JOGOS_SDK.cdkey	교환 코드 기능	🟦 출시 예정	🔳 선택사항, Jogos가 CDkey 관리를 위해 필요한 경우

시작하기

이 섹션에서는 엔진에서 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

let systemInfo = await window.JOGOS_SDK.init();

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('Get user error: ', err);
}

Promise 방식을 사용하여 호출할 수도 있습니다:

javascript

window.JOGOS_SDK.user
  .getUser()
  .then((user) => console.log(user))
  .catch((err) => console.log('Get user error: ', err));

다운로드 가능한 예제 씬 참조: HTML5_Demo.zip

SysInfo 정보

초기화 성공 콜백 후, 획득할 수 있는 SysInfo 정보를 놓치지 마십시오. 여기에는 사용 중인 게임 엔진에 대한 중요한 정보가 포함되어 있습니다; 플랫폼 사용자가 현재 사용하는 언어 유형을获取할 수 있습니다; 플레이어가 게임에 진입할 때 자동으로 현지화 언어를匹配하게 합니다. 게임 내 실제 서버 시간 등을 업데이트합니다.

javascript

SysInfo{
    "gameId": number; //게임 Id
    "hasGameGroup":bool; //그룹 채팅 활성화 여부
    "deviceType": "desktop" ; // 가능한 값: "desktop", "tablet", "mobile"
    "language": string; //언어 유형
    "os":"Windows 10"; //시스템 및 버전
    "browser":"Chrome 10.0"; //브라우저 및 버전
    "serverTime": number; //현재 서버 시간
}

개발 및 테스트

개발 과정에서 다른 환경에서 JOGOS_SDK를 실행하게 됩니다:

localhost 로컬 디버깅 개발 시, JOGOS_SDK는 동영상 광고/배너 및 기타 행동을 시도적으로 모의 실행하며, 서비스와 상호 작용하거나 실제 광고를 로드하지 않습니다.
Preview tool 저희의 QA 환경에서 실제 미리보기 및 검증 기능을 제공합니다. 게임에 JOGOS_SDK 통합 후, 개발자 포털에서 새 게임을 생성하고 관련 게임 리소스 파일을 업로드하면 게임을 미리볼 수 있습니다.

소개 ​

시작하기 ​

SysInfo 정보 ​

개발 및 테스트 ​

소개

시작하기

SysInfo 정보

개발 및 테스트