ゲーム制作者向け
スコアランキングをゲームに付ける
WebGameJpに登録したゲームなら、スコアSDKでオンラインのスコアランキングを無料で付けられます。サーバーの用意はいりません。送られたスコアは、WebGameJpのゲームページとランキングページにも表示されます。
1. SDKを読み込む
ゲームのHTMLに1行足します。data-game-id には、制作者ページの「マイゲーム」で編集画面を開くと出ているゲームIDを入れてください。
<script src="https://webgame.jp/sdk/v1.js" data-game-id="123"></script>
2. スコアを送る
スコアは0以上の整数です。名前は20文字まで。名前を省くと、前回の名前か「ゲスト」になります。
// ゲームオーバーのときに呼ぶ
WebGameJp.submitScore(score, { name: playerName })
.then(function (result) {
// result.rank … 何位か
// result.totalPlayers … 参加人数
// result.isPersonalBest … 自己ベストか
showMessage(result.rank + '位 / ' + result.totalPlayers + '人');
})
.catch(function (error) {
console.warn(error.message); // 送れなくてもゲームは続けられる
});
3. ランキングを見せる
// 上位10件を取ってきて、ゲームの中に表示する
WebGameJp.getRanking().then(function (scores) {
scores.forEach(function (row, i) {
console.log((i + 1) + '位 ' + row.player_name + ' ' + row.score);
});
});
// WebGameJp のランキングページを新しいタブで開く
WebGameJp.openRanking();
Unity(WebGL)の場合
WebGL用のindex.htmlに手順1の行を足し、jslibからSDKを呼びます。
// Assets/Plugins/WebGameJp.jslib
mergeInto(LibraryManager.library, {
SubmitScore: function (score) {
window.WebGameJp && WebGameJp.submitScore(score);
}
});
// C# 側
[DllImport("__Internal")] private static extern void SubmitScore(int score);
知っておいてほしいこと
- SDKを読み込んでから5秒たたないうちは、スコアを送れません(SDKが自動で待ってから送ります)。
- 同じ人が送れるのは1分に10回までです。
- ブラウザから送る仕組みなので、スコアの書き換えを完全には防げません。ランキングは遊びの目安として使ってください。
- 不自然なスコアは、運営が削除することがあります。