← ドキュメント
機能マトリクス
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 は 501 を返します | |
| メンバー / ロール / BAN | 対応 | 対応 | 完全な CRUD。communication_disabled_until（タイムアウト）は未対応 | |
| Webhook（チャンネルとアプリ） | 対応 | 対応 | 完全な CRUD と実行（埋め込み、添付、multipart）。レコードはクラウド側に保持され、実行時はボットの転送経路でセルフホストのチャンネルに書き込みます | |
| アプリ所有の絵文字 | ポータルのみ | ポータルのみ | 開発者ポータルで管理します。ボット API の GET は利用可能です。絵文字をご覧ください | |
| 監査ログ | 一部対応 | 一部対応 | ボットに関係するエントリのみ。チャンネル単位の上書き履歴はインデックスしていません | |
| レートリミットのヘッダー | 対応 | 対応 | すべてのレスポンスに X-RateLimit-*、バケット対応 | |
| インタラクション | アプリケーションコマンド（スラッシュ、ユーザー、メッセージ） | 対応 | 未対応 | クラウド: 一括 PUT と個別 CRUD。セルフホスト: 登録と呼び出しはまだルーティングされていません |
| コンポーネント v1（ボタン、セレクト、モーダル） | 対応 | 未対応 | GameVox クライアント側で描画されます。セルフホストにはイベントのブリッジが必要です | |
| コンポーネント v2 | 未対応 | 未対応 | v1 の後に予定 | |
| HTTP モードのインタラクション（送信先エンドポイント） | 対応 | 未対応 | クラウドは設定した interactions_endpoint_url に Ed25519 署名付きで送信し、エンドポイントが落ちている場合はゲートウェイにフォールバックします。セルフホストからの呼び出しはまだ転送されません | |
| ボイス | UDP ボイスゲートウェイ | 対応 | 対応 | リージョンごと。ボイスのドキュメントをご覧ください |
| AEAD AES-256-GCM | 対応 | 対応 | 推奨 | |
| AEAD XChaCha20-Poly1305 | 対応 | 対応 | フォールバック | |
| ボットによるボイス状態の変更 | 対応 | 一部対応 | 両方: ミュート / 移動 / 切断には PATCH .../voice-states/{user_id} を使います。セルフホスト: deaf は 501（SFU に該当機能がないため）。移動は 1 つではなく 2 つのイベントを発生させます | |
| その他 | サーバーの絵文字（読み取り） | 対応 | 対応 | 一覧と取得。作成／更新／削除はポータルのみ |
| サウンドボード（読み取り） | 対応 | 対応 | 一覧と取得。ボットからの再生は未対応 | |
| バニティ URL | 一部対応 | 未対応 | クラウド: 読み取りと更新（Gold 以上のサーバー）。セルフホスト: PATCH は 501 を返します | |
| スレッド / フォーラム投稿 | スタブ | スタブ | フォーラムチャンネルは存在しますが、スレッドの CRUD は空か 400 を返します | |
| ステージチャンネル、AutoMod、予定イベント | 未対応 | 未対応 | Intent は受け付けますが、イベントはありません | |
| Premium Apps / エンタイトルメント | 未対応 | 未対応 | v1 に収益化レイヤーはありません | |
| ポータル | チーム（複数開発者による所有） | 対応 | Discord と同等。チームをご覧ください | |
| チームへのアプリ移譲 | 対応 | 片方向（Discord と同じ） | ||
| アプリテスター（非公開アプリのインストール許可リスト） | 対応 | 1 アプリ 100 人。チーム → テスターをご覧ください | ||
| OAuth2 インストール URL（ユーザーとサーバーのコンテキスト） | 対応 | なし / GameVox 提供 / カスタム URL。OAuth2 をご覧ください | ||
| クライアントシークレットのローテーション | 対応 | bcrypt でハッシュ化。作成時とローテーション時に一度だけ表示 | ||
| ボットのディレクトリ掲載 | 対応 | gamevox.com/bots に、運営が承認した掲載を表示します | ||
凡例
- 対応: Discord と同じように動きます。コードの変更は不要です。
- 一部対応: ワイヤー互換ですが、一部の意味づけが欠けています。呼び出しても安全ですが、イベントが発生しない場合があります。
- 未対応: ワイヤー上は受け付けます（4014 にはなりません）が、何も起きません。存在しない前提で設計してください。