概要

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.gameItem	アイテム＆ストア	🟩 完全サポート	🔳 JシングルゲームでJogosがアイテムリスト＆課金を管理する場合は不要
JOGOS_SDK.room	バトルルーム	🟨 未サポート	🔳 LANマルチ対応でプラットフォームがオンラインルームを提供する場合は不要

はじめに

本節では各エンジンで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 JogosSDK.getUser();
console.log(user);
} catch (err) {
console.log (' ユーザー取得失敗：', err);
}
// 同等の Promise 呼び出し方法：
JogosSDK
.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；//現在のサーバー時刻
    "bannerIntervalTime": number;//ゲームバナー広告の表示間隔時間
    "MidgameIntervalTime": number;//ゲーム中間のインタースティシャル広告の表示間隔時間
}

開発とテスト

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

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

概要 ​

はじめに ​

SysInfo 情報 ​

開発とテスト ​

概要

はじめに

SysInfo 情報

開発とテスト