アセット一覧へ

連動

GAMELA イベント連動

ゲームのスコアや終了結果を、任意でGAMELAへ渡すための公式連動ガイドです。通常のHTMLゲームには不要です。

ライセンス
CC0・商用利用／改変／再配布可・クレジット不要
使い方
投稿画面でGAMELA連動を有効にし、このコードをゲームの終了処理・スコア更新処理へ追加します。

組み込みコード

// スコアが変わった時に呼び出す（任意）
function reportGamelaScore(score) {
  window.GamePost?.score(Math.max(0, Math.floor(Number(score) || 0)));
}

// ゲームが終わった時に呼び出す（任意）
function finishGamelaGame(result, score = 0) {
  window.GamePost?.complete({
    result, // "clear" / "fail" / "quit"
    score: Math.max(0, Math.floor(Number(score) || 0)),
  });
}

// 使用例
// reportGamelaScore(currentScore);
// finishGamelaGame("clear", currentScore);

SETUP

GAMELAで連動を使う手順

  1. このページのコードを、投稿するHTMLゲームの script 内へ追加します。
  2. 投稿画面で「GAMELA連動を有効にする」をオンにします。オンにすると、この公式アセットは自動で使用アセットへ記録されます。
  3. サイト上のスコアを表示したい場合だけ「スコアを受信する」をオンにします。
  4. ゲーム終了後にGAMELAの結果画面を出したい場合だけ「終了通知でゲームを閉じ、サイトリザルトを表示する」をオンにします。

IMPORTANT

使う前に確認すること

  • 連動は任意です。スコアやゲームオーバーの概念がないゲームは、何も追加せず通常どおり投稿できます。
  • GamePost が存在しない環境でも動くよう optional chaining を使っています。単体でHTMLを開いた場合もエラーになりません。
  • 終了通知を送っても、投稿設定でサイトリザルトをオンにしない限り、ゲーム画面は閉じません。

MADE WITH THIS ASSET

このアセットを使ったゲーム

このアセットを利用した公開作品はまだありません。