Xboxコンソールクラッシュレポーター統合ガイド

Last updated on February 4, 2026

注釈：本資料はAI技術を用いて翻訳されています。

概要​

このドキュメントでは、Xbox Series X (XSX)およびXbox OneコンソールのXbox Crash Reporterを有効にするための手順を説明します。有効にすると、クラッシュレポートは自動的にADT Webダッシュボードに送信され、分析されます。

前提条件​

続行する前に、以下を確認してください：

  1. BlackBoxSDK統合

    BlackBoxSDKのWindowsバージョンが既に統合されていることを確認してください。詳細なガイダンスについては、ADT SDK統合ドキュメントを参照してください。

  2. Unreal Engineソースコード

    Unreal Engineがソースコードからフォークされていることを確認してください（Epic Games Storeからダウンロードされたものではありません）。後者はコンソール開発をサポートしていません。

  3. ADT SDKとCLIのセットアップ

    a. Game Settings → Game Integrationに移動します

    b. Target Platformセクションで、Xbox One (GDK)またはXbox Series Xを選択します

    c. ADT Downloadページから必要なアドオンをダウンロードします

Xboxアドオン統合​

  1. ダウンロードしたアドオンを解凍します。これにより、BlackBox-UE4SDK-x64-XSX-(SDKVersion)という名前のフォルダが生成されます。

  2. フォルダを開き、BlackBoxSDKディレクトリをコピーします。

  3. BlackBoxSDKディレクトリをゲームプロジェクトのプラグインフォルダに貼り付けます

Xbox Crash Reporterを有効にする手順​

バージョンの作成に成功した後（Create versions and register buildsドキュメントを参照）、次の手順に従う必要があります：

  1. Xboxビルドを登録する

    適切なターゲットプラットフォームを選択します：

    a. Xbox Oneビルドの場合はxboxonegdk。

    b. Xbox Series Xビルドの場合はxsx。

    c. 次のコマンドを実行して、新しいビルドIDを追加します：

.\BlackBoxCLI.exe build register --smartbuild --platform-name xsx --platform-arch x64 --apikey <your_api_key> --game-project <game_project_path> --game-engine <game_engine_path>

  1. Unreal EngineでCrash URLを設定する

    次のコマンドを実行して、クラッシュURLを登録します：

.\BlackBoxCLI.exe crash-url set

  1. Unreal Engineを変更する（制限付き）

    この手順は、MicrosoftとのNDAコンプライアンスのため、ADTカスタマーに制限されています。詳細な手順については、サポートチームにお問い合わせください。

パッケージ化とアップロード​

  1. ゲームをパッケージ化する

    a. .uprojectファイルを開きます。

    b. Unreal Engine Editorを使用し、Platform -> XSX -> Package Projectを選択します。

  2. PDBファイルをアップロードする

    クックが完了したら、次のコマンドを使用してPDBをアップロードします：

.\Blackboxcli.exe upload --game-archive <game-archive-path> --platform-name XSX --platform-arch x64 --apikey <your_api_key> --game-project <game_project_path> --game-engine <game_engine_path>

  1. バイナリファイルをアップロードする

    次のコマンドを実行して、バイナリファイルをADTシステムにアップロードします：

.\BlackBoxCLI.exe build upload-binaries --game-archive <the path for the game archive> --entry-point <the .xvc file for the game> --apikey <your_api_key> --game-project <game_project_path> --game-engine <game_engine_path>

Xbox Crash Reporterをテストする​

ビルドをADTにアップロードした後、次の手順に従ってクラッシュ機能をテストします：

  1. ビルドをダウンロードしてデプロイする

    a. Accelbyte Development Toolkit Hubにログインします（インストールされていない場合はADT Webサイトからダウンロード）。

    b. ChannelsまたはVersionsページに移動して、アップロードしたビルドを見つけます。

    c. Downloadをクリックし、完了するとボタンがDeployに変わります。

    d. devkitを選択してビルドをデプロイします（手順についてはConnect Devkitsを参照）。

  2. クラッシュをトリガーする a. devkitでゲームを起動し、完全に起動したら意図的にクラッシュさせます。

    b. Systemフォルダに移動し、devkitのSystem Scratchフォルダを開き、クラッシュレポートを見つけます。ファイル名は次のようになります：xboxgdk_crash_<iso8601_time>。

  3. クラッシュレポートのアップロードを確認する a. ゲームを再起動して、クラッシュレポートのADTバックエンドへのアップロードをトリガーします。

    b. ADT Webダッシュボードでクラッシュの詳細を確認します。

備考

Xboxクラッシュレポートは、クラッシュ発生後の次回ゲーム起動時にアップロードされます。

に最終更新
On this page