起動引数
注釈:本資料はAI技術を用いて翻訳されています。
はじめに
AccelByte Development Toolkit(ADT)Hubの起動引数機能を使用して、ゲーム内のテストを実行し、問題をトラブルシューティングできます。この機能により、変更して実行可能ファイルに渡すことができる特定のパラメータでゲームを実行できます。
ADTでは、ゲームビルドを実行するために3種類の起動引数を使用できます:
- 事前定義された起動引数
- デフォルトの起動引数
- ローカル起動引数
起動引数なしでゲームを実行することもできます。
この記事では、ゲームの起動引数を設定する方法について説明します。
事前定義された起動引数を設定する
ADTでは、独自の事前定義された起動引数を追加して、ビルドに使用できます。
事前定義された起動引数を追加する
事前定義された起動引数をローカルまたはグローバルに追加して、必要なときにいつでも使用できます。
ローカル引数を作成した場合、他のユーザーは作成した事前定義されたローカル引数を表示できません。グローバル起動引数の場合、すべてのユーザーが起動引数を使用できます。
事前定義された起動引数を追加するには、次の手順に従います:
- ADT Hubで、ゲーム名をクリックし、Launch Argumentsを選択します。

- 表示されるLaunch Argumentsウィンドウで、Add newボタンをクリックします。
- New Launch Argumentフォームで、次の操作を行います:
- 起動引数タイプをLocalまたはGlobalに設定します。
- 新しい起動引数の名前を入力します。
- 「Launch Argument」ボックスに新しい起動引数を追加します。
- プラットフォームを指定します。
- Addをクリックして、新しい起動引数を保存します。
トラックに事前定義された起動引数を設定する
ゲームに事前定義された起動引数を使用するには、次の手順に従います:
- ADT Hubで、ゲームの配信チャネルに移動します。
- トラックパネルで、省略記号メニューをクリックして、Track > Set Launch Argumentsを選択します。
- 表示されるポップアップで、Use predefined launch argumentsを選択し、リストから事前定義された起動引数を選択します。
- Saveをクリックします。トラックの起動引数が、選択した事前定義された起動引数を使用して更新されます。
デフォルトの起動引数を設定する
デフォルトの起動引数機能を使用して、ビルド内で指定された引数を設定でき、ゲームをプレイするときにすべてのユーザー(グローバル)に影響します。
ADT HubとADT CLIを介して設定することで、ビルドのデフォルトの起動引数を設定できます。
ADT HubのVersionsタブから
- ADT Hubで、Versionsタブに移動し、ゲームの利用可能なバージョンの1つをクリックします。
- サイドバーメニューで、Manageをクリックします。
- Buildセクションで、カスタム起動引数を追加するビルドを選択します。

- Launch Argumentsセクションで、Editをクリックして起動引数を追加します。
- Saveをクリックします。追加した起動引数は、次回ゲームビルドを実行するときにデフォルトとして使用されます。
ADT Hubのチャネルトラックから
- ADT Hubで、デフォルトの起動引数を追加するトラックを含む配信チャネルに移動します。
- トラックパネルで、省略記号メニューをクリックして、Track > Set Launch Argumentsを選択します。「Set Launch Arguments」ポップアップウィンドウが表示されます。
- ウィンドウで、トラックのデフォルトとして使用される起動引数を追加します。
- Saveをクリックします。追加した起動引数は、次回トラックからゲームビルドを実行するときにデフォルトとして使用されます。
ADT CLIを使用
この方法を使用すると、アップロード後にビルドに起動引数が添付され、削除できません。または、ビルドをプレイする前に、別の利用可能なローカル起動引数を選択するか、新しいものを作成するか、単に起動引数なしでビルドを実行することもできます。詳細については、ゲームビルドを実行するを参照してください。
ADT CLIを使用して起動引数を設定するには、次の手順に従います:
- ADT CLIで、次のコマンドを実行します:
./BlackboxCLI.exe game-binary upload --entry-point <The game application> --game-archive <The game archive dir> --client-id <client game id> --client-secret <client secret id> --username <Your Blackbox email> --password <Your Blackbox email password> --launch-arguments <the build launch argument>` - ビルドがアップロードされたら、ADT Hubを開き、配信チャネルまたはVersionsタブからビルドをダウンロードします。ビルドがダウンロードされると、現在のデフォルト引数がビルドカードに表示されます。

ローカル起動引数を設定する
ローカル起動引数機能を使用して、ビルドまたはビルドチャネルの特定の引数を設定できます。ローカル起動引数は、ゲームに基づいてユーザーのマシン(ローカル)に保存されます。
ビルドまたはビルドチャネルにローカル起動引数を作成して追加するには、次の手順に従います:
-
ADT Hubを開き、配信チャネルまたはVersionsタブからビルドをダウンロードします。
-
ビルドカードで、Playボタンの横にある省略記号メニューをクリックして、Play with my Launch Argumentsを選択します。

-
Play with my launch argumentsウィンドウで、ビルドを実行する好みの方法を選択します:
- デフォルトの起動引数を最初に使用し、その後にローカル引数を使用してゲームビルドを実行します。 これを行うには、「My launch arguments」テキストボックスにローカル起動引数を追加し、Append my launch arguments after track/build launch argumentsオプションを選択します。結果には、トラックまたはビルドのデフォルトの起動引数が表示され、その後にローカル起動引数が続きます。
- ローカル起動引数を最初に使用し、その後にデフォルトの起動引数を使用してゲームビルドを実行します。 これを行うには、「My launch arguments」テキストボックスにローカル起動引数を追加し、Prepend my launch arguments after track/build launch argumentsオプションを選択します。結果ボックスには、ローカル起動引数が表示され、その後にトラックまたはビルドのデフォルトの起動引数が続きます。
- ローカル起動引数なしでゲームビルドを実行します。 「My launch arguments」テキストボックスが空であることを確認します。内容がある場合は削除します。次に、Replace track/build launch arguments with my launch argumentsオプションを選択します。結果ボックスは空です。

-
(オプション)設定を保存して次回の起動で使用するには、Keep for the next launchチェックボックスをオンにします。
-
Launchをクリックします。
Configure Automationメニューで起動引数を設定する
カスタム引数を設定するか、ビルドチャネルにローカルに適用される(設定したユーザーのみ)デフォルトのコマンド起動引数を使用できます。これにより、特定のDevKitまたはマシン(PlayStationおよびXbox series Xプラットフォーム用)に基づいて起動引数を設定できます。起動引数は、ビルドチャネルが更新されると適用されます。詳細については、トラックの自動化設定を有効にするを参照してください。