ESKEES EN

ESKEES の作品を自分のサイトに置く

アルファ版（2026 年 9 月時点）の内容です。予告なく変更される場合があります。

ESKEES で作った作品（.eskx / .emg）は、showcase の外でも遊べます。方法は 3 つです。

  • showcase の作品を埋め込む … iframe を 1 行貼るだけ。公式サンプルも、投稿された作品も置けます。
  • 自分の .eskx を置く … ESKEES Player（CDN）を読み込み、<eskees-player> タグでファイルの URL を指定します。showcase に投稿していない作品も置けます。
  • Studio から Web ページとして書き出す … 作品を埋め込んだ HTML 1 ファイルができます。置くだけで遊べます。

どれも、showcase と同じ再生エンジンで動きます。スクリプト・UI・マスク・ステージ・物理・サウンド・カメラも、そのまま動きます。

動作例

下は、このページに <eskees-player> で置いた「かさねて 2048」です。押すと始まります（矢印キー・スワイプで操作）。

1. showcase の作品を埋め込む

showcase の作品のページで「埋め込む」を押すと、貼り付けるコードが表示されます。作品の URL が https://showcase.eskees.com/w/作品の ID なら、次のとおりです。

<iframe src="https://showcase.eskees.com/embed/作品の ID"
  style="width: 100%; aspect-ratio: 16 / 9; border: 0"
  allow="autoplay; fullscreen; gamepad" loading="lazy"></iframe>

2. 自分の .eskx を置く（ESKEES Player）

ESKEES の「エクスポート ▾」で出力した .eskx を自分のサーバーに置き、次のように書きます。

<script type="module" src="https://showcase.eskees.com/player/1/eskees-player.js"></script>

<eskees-player src="/games/my-game.eskx" style="width: 800px; aspect-ratio: 16 / 9"></eskees-player>

属性

src作品の URL（.eskx / .emg）。必須
autoplay押さずに始める。音は、最初に画面を押したときから鳴ります（ブラウザの制限）
langボタンなどの文言（ja / en）。省略するとブラウザの言語
savesセーブデータ。local（既定。そのサイトのブラウザに残る）か memory（閉じたら消える）

大きさはページの側で決めます。指定しなければ、横幅いっぱい・16:9 で表示します。作品のキャンバスと同じ縦横比（aspect-ratio）にすると、余白が出ません。

イベント

eskees-ready作品を開けた
eskees-error開けなかった（detail.message に理由）
eskees-scoreスクリプトがスコアを出した（detail に { board, value, lower }）。showcase のランキングには送りません
document.querySelector('eskees-player').addEventListener('eskees-score', (e) => {
  console.log(e.detail.board, e.detail.value);
});

JavaScript から置く

<script type="module">
  import { mount } from 'https://showcase.eskees.com/player/1/eskees-player.js';
  const game = await mount(document.getElementById('game'), '/games/my-game.eskx', { autoplay: true });
  // game.restart() で最初から、game.togglePause() で一時停止、game.destroy() で外す
</script>

3. Studio から Web ページとして書き出す

ESKEES Studio の「エクスポート ▾」→「Web ページとして書き出す（HTML）」で、作品を埋め込んだ HTML 1 ファイルができます。

置けるサイト・置けないサイト

注意