← ドキュメント
機能マトリクス
GameVox 上で Discord ボットの各機能が“動くのか?”を一覧にしたものです。ゲートウェイ URL を切り替える前に、移行範囲を見極めるために使ってください。セルフホスト列は、顧客のセルフホスト GameVox サーバーにボットをインストールした場合に機能が動作するかどうかを示します。転送アーキテクチャについては、セルフホストのドキュメントをご覧ください。
| 領域 | 機能 | クラウド | セルフホスト | 備考 |
|---|---|---|---|---|
| ゲートウェイ | JSON エンコーディング | 対応 | 対応 | 既定。すべてのライブラリが使います |
| zlib-stream 圧縮 | 対応 | 対応 | 主要なライブラリはすべて対応済み | |
| ETF エンコーディング | 未対応 | 未対応 | encoding=etf がない場合、ライブラリは JSON にフォールバックします | |
| Zstandard 圧縮 | 未対応 | 未対応 | zlib-stream が共通の代替手段です | |
| Resume / op:6 | 対応 | 対応 | Resume バッファを Redis にミラーしているため、api タスクの再起動を越えて op:6 が機能します | |
| シャーディング | 対応 | 対応 | 標準の (guild_id >> 22) % num_shards ハッシュ | |
| REST | メッセージの CRUD | 対応 | 対応 | 送信、編集、削除、一括削除、取得、ピン留め、入力中表示、リアクション、添付ファイル、投票 |
| チャンネルの CRUD | 対応 | 対応 | クラウド: 並べ替えと、ロールの上書きの書き込み(PUT と DELETE)に対応。チャンネルオブジェクトにはまだ上書きが含まれません。セルフホスト: 並べ替えに対応、ロールの上書きに対応(メンバーの上書きはなし)、チャンネルオブジェクトに含まれます | |
| チャンネル単位の権限上書き | 一部対応 | 一部対応 | ロール(グループ)の上書きのみで、メンバーの上書きはありません。書き込み(PUT、DELETE)はクラウドとセルフホストの両方で動作します。読み取り(チャンネルオブジェクトと CHANNEL_UPDATE の permission_overwrites)は現時点ではセルフホストのみで、クラウドのチャンネルオブジェクトにはこのフィールドが含まれません。セルフホストでは、allow によってグループ自体に許可された範囲を超える権限が付与されることはありません | |
| メンバー / ロール / BAN | 対応 | 対応 | 完全な CRUD。communication_disabled_until(タイムアウト)は未対応 | |
| Webhook(チャンネル & アプリ) | 対応 | 対応 | 完全な CRUD と実行(埋め込み、添付、multipart)。セルフホストサーバーでは、レコードはクラウド側に保持され、実行されたメッセージはセルフホストのチャンネルに書き込まれます | |
| アプリ所有の絵文字 | ポータルのみ | ポータルのみ | 開発者ポータルで管理します。ボット API の GET は利用可能です。絵文字をご覧ください | |
| 監査ログ | 一部対応 | 一部対応 | ボットに関係するエントリのみ。チャンネル単位の上書き履歴はインデックスしていません | |
| レートリミットのヘッダー | 対応 | 対応 | すべてのレスポンスに X-RateLimit-*、バケット対応 | |
| インタラクション | アプリケーションコマンド(スラッシュ、ユーザー、メッセージ) | 対応 | 対応 | 一括 PUT と個別 CRUD。コマンドはどちらの種類のサーバーでもクラウドに登録され、セルフホストサーバーでの呼び出しはクラウド経由でルーティングされます |
| ボタン、文字列セレクト、モーダル(コンポーネント v1) | 対応 | 対応 | エフェメラル返信にも対応。サーバーのチャンネルのみで、DM では使えません。メッセージコンポーネントを参照 | |
| ユーザー、ロール、メンション可能、チャンネルのセレクト | 一部対応 | 一部対応 | 受け付けて保存されますが、クライアントでは無効の状態で表示されるため、インタラクションは発生しません | |
| コンポーネント v2 | 未対応 | 未対応 | 未対応。v2 のレイアウトコンポーネントは表示されません | |
| HTTP モードのインタラクション(送信先エンドポイント) | 一部対応 | 一部対応 | 設定した interactions_endpoint_url に Ed25519 署名付きで POST し、エンドポイントが失敗した場合はゲートウェイにフォールバックします。接続中のゲートウェイセッションが必要で、レスポンスのボディは無視されます。応答はコールバックエンドポイントで行ってください。OAuth2 を参照 | |
| ボイス | UDP ボイスゲートウェイ | 対応 | 対応 | リージョンごと。ボイスのドキュメントをご覧ください |
| AEAD AES-256-GCM | 対応 | 対応 | 推奨 | |
| AEAD XChaCha20-Poly1305 | 対応 | 対応 | フォールバック | |
| ボットによるボイス状態の変更 | 対応 | 一部対応 | 両方: ミュート / 移動 / 切断には PATCH .../voice-states/{user_id} を使います。セルフホストは deaf にも対応し、移動と自由に組み合わせられます。移動は 1 つではなく 2 つのイベントを発生させます | |
| その他 | サーバーの絵文字(読み取り) | 対応 | 対応 | 一覧と取得。作成/更新/削除はポータルのみ |
| サウンドボード(読み取り) | 対応 | 対応 | 一覧と取得。ボットからの再生は未対応 | |
| バニティ URL | 一部対応 | 未対応 | クラウド: 読み取りと更新(Gold 以上のサーバー)。セルフホスト: PATCH は 501 を返します | |
| スレッド / フォーラム投稿 | 一部対応 | 一部対応 | フォーラム投稿: 作成(POST /channels/{forum}/threads)、閲覧、返信に対応。その他のスレッドのエンドポイント(アーカイブ、スレッドメンバー、アクティブなスレッド)は未対応 | |
| 予定イベント | 対応 | 一部対応 | CRUD と RSVP。GameVox のサーバーイベントに対応付けられます。GUILD_SCHEDULED_EVENT_* のゲートウェイイベントはありません。セルフホスト: 繰り返しイベントは保存されますが、2 回目以降の開催は生成されません | |
| ステージチャンネル、AutoMod | 未対応 | 未対応 | Intent は受け付けますが、イベントはありません | |
| Premium Apps / エンタイトルメント | 未対応 | 未対応 | v1 に収益化レイヤーはありません | |
| ポータル | チーム(複数開発者による所有) | 対応 | Discord と同等。チームをご覧ください | |
| チームへのアプリ移譲 | 対応 | 片方向(Discord と同じ) | ||
| アプリテスター(非公開アプリのインストール許可リスト) | 対応 | 1 アプリ 100 人。チーム → テスターをご覧ください | ||
| OAuth2 インストール URL(ユーザーとサーバーのコンテキスト) | 対応 | なし / GameVox 提供 / カスタム URL。OAuth2 をご覧ください | ||
| クライアントシークレットのローテーション | 対応 | bcrypt でハッシュ化。作成時とローテーション時に一度だけ表示 | ||
| ボットのディレクトリ掲載 | 対応 | gamevox.com/bots に、運営が承認した掲載を表示します | ||
凡例
- 対応: Discord と同じように動きます。コードの変更は不要です。
- 一部対応: ワイヤー互換ですが、一部の意味づけが欠けています。呼び出しても安全ですが、イベントが発生しない場合があります。
- 未対応: ワイヤー上は受け付けます(4014 にはなりません)が、何も起きません。存在しない前提で設計してください。