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メソッドが正常に実行されるまで、他のどのメソッドも使用できません。ゲーム開始前にこの操作を実行することを強く推奨します。

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情報を取得できます。この部分は必ず確認してください。ここには使用しているゲームエンジンに関する重要な情報が含まれています。プラットフォームユーザーが現在使用している言語タイプを取得できます。プレイヤーがゲームに入ったときに自動的にローカライズされた言語に一致させることができます。ゲーム内の実際のサーバー時間を更新するなど。

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を統合した後、 開発者ポータル で新しいゲームを作成し、関連するゲームリソースファイルをアップロードすると、ゲームをプレビューできます。