概要

JOGOS_SDKを統合する前に、必ず要件をご確認ください。技術、ゲームコンテンツ、広告、アカウント統合に関する最適な実装方法をご案内します。
Unity および Cocos 以外のエンジンは、専用 SDK が用意されていないため、HTML5版を用いて統合してください。WebGLに対応するほとんどのゲームエンジンはブラウザ上でJavaScriptと連携できます。

JOGOS_SDKは以下のモジュールを含みます：

モジュール	説明	SDKサポート	統合推奨
JOGOS_SDK.init	SDKの初期化	🟩 完全サポート	☑️ 必須（後述）
JOGOS_SDK.game	ゲームビヘイビア	🟩 完全サポート	☑️ 必須（ゲームのロード・開始・一時停止を通知）
JOGOS_SDK.user	ログインユーザーとの連携	🟩 完全サポート	🔳 ユーザー機能を利用する場合必須
JOGOS_SDK.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の成功前に他のメソッドを呼び出すと、"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 情報

初期化成功後に取得できるSysInfoは、ゲームエンジン情報やプラットフォーム言語、サーバー時刻など重要な情報を含みます。プレイヤーのロケールを自動判定し、ゲーム起動時に言語を自動切替可能です。また、正確なサーバー時刻も取得できます。

javascript

SysInfo{
    "gameId": number；//ゲームID
    "hasGameGroup":bool；//グループチャット有効フラグ
    "deviceType": "desktop" ；// デスクトップ/タブレット/モバイル
    "language": string；//言語
    "os":"Windows 10"；//OSとバージョン
    "browser":"Chrome 10.0"；//ブラウザとバージョン
    "serverTime": number；//現在のサーバー時刻
}

開発とテスト

開発中は以下の環境でJOGOS_SDKを実行します：

localhost
ローカル開発時、JOGOS_SDKは動画広告/バナーなどをエミュレートし、実際のサービスや広告はロードしません。
Preview tool
当社QA環境で本物のプレビュー・検証機能を提供します。JOGOS_SDKの統合完了後、開発者ポータルで新規ゲームを作成し、ゲームリソースをアップロードするとプレビュー可能です。

概要 ​

はじめに ​

SysInfo 情報 ​

開発とテスト ​

概要

はじめに

SysInfo 情報

開発とテスト