ブラウザゲームをDiscordで遊べるように|Activitiesの手順と条件
Activities は Discord の中で iframe で動く Web アプリで、Embedded App SDK で Discord のクライアントと通信します。デスクトップ・モバイル・Web で動きます。
Activities の仕組みと条件
Activities の仕組みと条件
| 項目 | 内容 |
|---|---|
| 形 | Activities は Discord の中で iframe で動く Web アプリ。SDK は単一ページのアプリ向け。単一ページのアプリに合わない仕組みをその中に入れる形の例は、公式のサンプル(Nested Messages App)で見られる。 |
| 起動のしかた | App Launcher の Entry Point コマンド(有効にすると既定の「Launch」ができる)か、操作への応答の LAUNCH_ACTIVITY(型 12)。 |
| 通信 | postMessage。SDK が代行する。 |
| 流れ | 読み込み→ready の握手→認可と認証→コマンドとイベント。 |
| エラー | CLOSE の通知。CLOSE_NORMAL 以外はメッセージが利用者に出る。 |
公開の範囲と審査
開発中・インストール先・公開・収益化の範囲と審査
| 段階 | 内容 |
|---|---|
| 開発中 | 配布前の Activities を起動できるのは、自分か開発チームのメンバーだけ。 |
| インストール先 | サーバーかユーザーか両方。サーバーへの導入は MANAGE_GUILD の権限を持つメンバーの承認が要る。 |
| 公開して探してもらう | チームのオーナーの本人確認とアプリの確認(App Verification)を出し、Developer Portal で Discovery を有効にする。反映まで最長24時間。 |
| 収益化 | 確認が済んだアプリで使える。このページでは扱わない。 |
公開前の注意
公開前の注意
| 項目 | 内容 |
|---|---|
| キャッシュ | text/html 以外の資産はキャッシュのヘッダーが守られる。Discord のプロキシは text/html のキャッシュのヘッダーを外す。 |
| レート制限 | Discord の API の制限と retry_after に従う。 |
| 静的 IP | クラウド関数のように IP が割り当て直される場合、ほかの人の禁止された IP を引き継ぐと最長1時間、Discord の API への通信が止まる。 |
| 古い Discord への対応 | 古い版の Discord は、対応していない新しいコマンドに INVALID_COMMAND の誤りを返す。アプリの側は try で受けて扱うことができる。 |
部品のつながりを図で見る
ゲームが Discord の iframe に出るまで
作って Discord の中で開く手順
- Node.js(最新の版)・Express・Vite・cloudflared などを用意します。
- Discord のユーザー設定の「詳細設定」で開発者モードを入れる。
- 公式のサンプル(getting-started-activity)を取り込み、client で npm install と npm run dev を動かす。
- Developer Portal でアプリを作り、開発チームを選ぶ。
- インストール先(サーバー・ユーザー)を選び、OAuth2 の Redirect URI に仮の値(https://127.0.0.1)を入れる。
- クライアント ID とクライアント シークレットを .env に写す(シークレットは共有せず、バージョン管理に入れない)。
- cloudflared でローカルを公開し、Activities の URL Mappings のページにその URL を入れる。
- Activities の Settings で Enable Activities の欄を入れ、Discord の中で起動して確かめる。
- 公開するなら、本人確認とアプリの確認を出し、Discovery を有効にします。
失敗を避ける注意
- 開発中は自分と開発チームしか起動できない。
- クライアント シークレットは共有せず、バージョン管理に入れない。
- 古い Discord の版では新しいコマンドが使えない。
次に読む
情報源
- Activities Overview(Discord の公式ドキュメント)https://docs.discord.com/developers/activities/overview確認日 2026-11-06
- Building Your First Activity in Discord(Discord の公式ドキュメント)https://docs.discord.com/developers/activities/building-an-activity確認日 2026-11-06
- How Activities Work(Discord の公式ドキュメント)https://docs.discord.com/developers/activities/how-activities-work確認日 2026-11-06
- Production Readiness(Discord の公式ドキュメント)https://docs.discord.com/developers/activities/development-guides/production-readiness確認日 2026-11-06
- Enabling Discovery(Discord の公式ドキュメント)https://docs.discord.com/developers/discovery/enabling-discovery確認日 2026-11-06
- Local Development(Discord の公式ドキュメント)https://docs.discord.com/developers/activities/development-guides/local-development確認日 2026-11-06