INDIE INDEX

レベル:実践

ブラウザゲームをDiscordで遊べるように|Activitiesの手順と条件

公開 2026-11-06更新 2026-11-06

Activities は Discord の中で iframe で動く Web アプリで、Embedded App SDK で Discord のクライアントと通信します。デスクトップ・モバイル・Web で動きます。

このページの目次
  1. Activities の仕組みと条件
  2. 公開の範囲と審査
  3. 公開前の注意
  4. 部品のつながりを図で見る
  5. 作って Discord の中で開く手順
  6. 失敗を避ける注意
  7. 次に読む
  8. 情報源

Activities の仕組みと条件

Activities の仕組みと条件

項目内容
形Activities は Discord の中で iframe で動く Web アプリ。SDK は単一ページのアプリ向け。単一ページのアプリに合わない仕組みをその中に入れる形の例は、公式のサンプル(Nested Messages App)で見られる。
起動のしかたApp Launcher の Entry Point コマンド(有効にすると既定の「Launch」ができる)か、操作への応答の LAUNCH_ACTIVITY(型 12)。
通信postMessage。SDK が代行する。
流れ読み込み→ready の握手→認可と認証→コマンドとイベント。
エラーCLOSE の通知。CLOSE_NORMAL 以外はメッセージが利用者に出る。
表1

公開の範囲と審査

開発中・インストール先・公開・収益化の範囲と審査

段階内容
開発中配布前の Activities を起動できるのは、自分か開発チームのメンバーだけ。
インストール先サーバーかユーザーか両方。サーバーへの導入は MANAGE_GUILD の権限を持つメンバーの承認が要る。
公開して探してもらうチームのオーナーの本人確認とアプリの確認(App Verification)を出し、Developer Portal で Discovery を有効にする。反映まで最長24時間。
収益化確認が済んだアプリで使える。このページでは扱わない。
表2

公開前の注意

公開前の注意

項目内容
キャッシュtext/html 以外の資産はキャッシュのヘッダーが守られる。Discord のプロキシは text/html のキャッシュのヘッダーを外す。
レート制限Discord の API の制限と retry_after に従う。
静的 IPクラウド関数のように IP が割り当て直される場合、ほかの人の禁止された IP を引き継ぐと最長1時間、Discord の API への通信が止まる。
古い Discord への対応古い版の Discord は、対応していない新しいコマンドに INVALID_COMMAND の誤りを返す。アプリの側は try で受けて扱うことができる。
表3

部品のつながりを図で見る

ゲームが Discord の iframe に出るまで

ゲームが Discord の iframe に出るまで1ゲーム(Web アプリ)2Vite の開発サーバー3cloudflared4Developer Portal の URL マッピング5Discord の iframe6開発中:自分と開発チーム/公開:確認と Discovery
図1

作って Discord の中で開く手順

  1. Node.js(最新の版)・Express・Vite・cloudflared などを用意します。
  2. Discord のユーザー設定の「詳細設定」で開発者モードを入れる。
  3. 公式のサンプル(getting-started-activity)を取り込み、client で npm install と npm run dev を動かす。
  4. Developer Portal でアプリを作り、開発チームを選ぶ。
  5. インストール先(サーバー・ユーザー)を選び、OAuth2 の Redirect URI に仮の値(https://127.0.0.1)を入れる。
  6. クライアント ID とクライアント シークレットを .env に写す(シークレットは共有せず、バージョン管理に入れない)。
  7. cloudflared でローカルを公開し、Activities の URL Mappings のページにその URL を入れる。
  8. Activities の Settings で Enable Activities の欄を入れ、Discord の中で起動して確かめる。
  9. 公開するなら、本人確認とアプリの確認を出し、Discovery を有効にします。

失敗を避ける注意

  • 開発中は自分と開発チームしか起動できない。
  • クライアント シークレットは共有せず、バージョン管理に入れない。
  • 古い Discord の版では新しいコマンドが使えない。

次に読む

ブラウザゲームのローカルサーバーと Vite

情報源

このページに出た言葉

このページの内容の誤りは、問い合わせの窓口で受け付けています。