概要
JOGOS_SDK
を統合する前に、必ず要件に従ってください。これにより、JOGOS_SDK
を最適な方法で使用することができ、技術的な要件、ゲームコンテンツ、広告、アカウント統合の要件に関するガイダンスが提供されます。 Unity と Cocos には専用の SDK を使用できる他、その他のエンジンはHTML5
バージョンを介してこれらの機能を統合できます。なぜなら、WebGL
をサポートするほとんどのゲームエンジンは、ブラウザで実行される際にJavaScript
と対話する方法を備えているからです。
JOGOS_SDK
には以下のモジュールが含まれています。
モジュール | 説明 | 原生 HTML5 | Cocos | Unity |
---|---|---|---|---|
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>
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
を統合した後、 開発者ポータル で新しいゲームを作成し、関連するゲームリソースファイルをアップロードすると、ゲームをプレビューできます。