メインコンテンツまでスキップ

クックされたゲームバイナリのアップロード/ダウンロード

Last updated on February 4, 2026

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

概要

ゲームはUnrealでビルドされます。クッキングはビルドプロセスの一部で、ゲームアセットをプレイ可能なビルドで使用できるように変換します。内部フォーマットからプラットフォーム固有のフォーマットにコンテンツを変換するプロセスをクッキングと呼びます。

クックされたビルドバイナリには、パッケージ化されたゲームアセットと実行可能なゲームが含まれています。つまり、これはゲームアーカイブディレクトリのコンテンツです。

AccelByte Development Toolkit (ADT)では、ADT Webからアクセスできるように、クックされたビルドバイナリをアップロードする必要があります。

クックされたゲームバイナリのアップロード

クックされたゲームバイナリをADTバックエンドサービスにアップロードして、チームメンバーに配信できます。以下のコマンドを使用してバイナリをアップロードしてください:

インライン設定なし

BlackBoxCLI.exe build upload-binaries --entry-point <entry point path>

インライン設定あり

BlackBoxCLI.exe build upload-binaries --namespace myawesomegame --apikey asdf1234 --game-project D:\path\to\myawesomegame --game-archive D:\path\to\packaged\awesomegame --build-id <your build id> --entry-point <entry point path>

アップロードサブコマンド

この表は、バイナリをアップロードする際に使用できるサブコマンドを示しています。

メインコマンドサブコマンドオプションとパラメータ
名前説明
buildupload-binaries-n, --namespaceNamespace
-a, --apikeyAPI Key
-r, --game-archiveパッケージ化されたゲームパス (デフォルト: 設定されたパッケージ化ゲームパス)
--version-idVersion ID (デフォルト: 設定されたbuild id)
-b, --build-idBuild ID (デフォルト: 設定されたbuild id)
-e, --entry-pointエントリーポイント/実行可能ゲームパス。これは--game-archiveディレクトリからの相対パスであり、必須です
-g, --ignore

無視するファイルへの絶対パス

特定のファイルを無視する場合は、Gitのgit ignoreファイルと同じパターンで無視ファイルを作成し、どこかに保存してください

.ignoreconfigファイルを--game-archiveディレクトリに配置して、このフラグをスキップすることもできます。この場合、ADT CLIは自動的に.ignoreconfigファイルを読み取ります。--ignoreはオプションです。

-m, --multipart-size

マルチパートアップロードサイズ(メガバイト単位) (デフォルト: 1024) ファイルサイズは5 MB以上である必要があります

ファイルのサイズが設定されたサイズより大きい場合、マルチパートアップロードが自動的にアクティブになります。例えば、10 GBのファイルは1 GBのファイルにチャンク化され、それぞれが個別にアップロードされます。アップロード後、サーバーはチャンクを元のファイルに再構成します

-l, --log-level

ログレベル - デフォルトはinfo

オプション:

  • info
  • warn
  • debug
  • error
--show-confirmationアップロードを実行する前に確認プロンプトを表示します

ゲームバイナリをアップロードするための代替コマンド

game-binary uploadコマンドは、ゲームバイナリをアップロードするための代替方法です。

備考

このコマンドには、API Keyに加えて--client-idなどの追加のセキュリティ認証情報が必要です。詳細については、ADT管理者に問い合わせるか、Slackチャンネルでお問い合わせください。

インライン設定なし

BlackBoxCLI.exe game-binary upload --client-id <clientid> --client-secret <clientsecret> --username <username> --password <password> --game-archive <packaged game path> --entry-point <executable path relative to game archive> 

インライン設定あり

BlackBoxCLI.exe game-binary upload --namespace <your namespace> --apikey asdf1234 --client-id <clientid> --client-secret <clientsecret> --username <username> --password <password> --game-archive <packaged game path> --entry-point <executable path relative to game archive>

例:

BlackBoxCLI.exe game-binary upload --client-id asdf1234 --client-secret asdf1234 --username myname --password mypassword --game-archive d:\path\to\packaged\game --entry-point mygame.exe

代替アップロードサブコマンド

次の表には、game-binary uploadを使用してバイナリをアップロードする際に使用できるサブコマンドが含まれています。

メインコマンドサブコマンドオプションとパラメータ
名前説明
buildgame-binary upload--apikey[インライン設定の一部] 使用するAPI Keyを設定します
--namespace[インライン設定の一部] 使用するnamespaceを設定します
--game-project[インライン設定の一部] 使用するゲームプロジェクトのディレクトリを設定します
--game-archiveパッケージ化されたゲームパス
--client-idCLIのclient id (namespaceで使用する実際のidについてはお問い合わせください)
--client-secretCLIのclient secret。namespaceで使用する実際のsecretについてはお問い合わせください。
--username現在のユーザーのusername
--password現在のユーザーのpassword
--show-confirmation(オプション) 確認を表示するかどうか
--build-idこのゲームバイナリをターゲットとするbuild ID。ゲームプロジェクトを既に指定していて、Config/BlackBox.iniファイル内に正しいbuild IDがある場合は不要です。
--entry-pointgame-archiveからの相対的なゲームの実行可能パス
--launch-argumentsゲームの起動引数 (オプション)
--ignore.ignoreconfigファイルの絶対パス、無視パターンは.gitignoreと同様です
--multipart-sizeマルチパートアップロードサイズ(メガバイト単位)、5 MB以上である必要があります (デフォルト: 1024)
--log-levelログレベル (デフォルト: info、オプション: infodebugwarnerror)

ゲームバイナリのダウンロード

バイナリをアップロードする方法と同様に、ADT CLIを使用してバイナリをハードドライブにダウンロードできます。

インライン設定なし

BlackBoxCLI.exe game-binary download --client-id <clientid> --client-secret <clientsecret> --username <username> --password <password> --directory <downloaded game path> 

インライン設定あり

BlackBoxCLI.exe game-binary download --client-id <clientid> --client-secret <clientsecret> --username <username> --password <password> --directory <downloaded game path> --namespace <your namespace>  --apikey asdf1234 --build-id asdf1234

例:

BlackBoxCLI.exe game-binary download --client-id asdf1234 --client-secret asdf1234 --username myusername --password mypassword --directory d:\path\to\downloadedgame --build-id asdf1234

ダウンロードサブコマンド

この表は、game-binary downloadを使用してバイナリをダウンロードする際に使用するサブコマンドを示しています。

メインコマンドサブコマンドオプションとパラメータ
名前説明
buildgame-binary download--apikey[インライン設定の一部] 使用するAPI Keyを設定します
--namespace[インライン設定の一部] 使用するnamespaceを設定します
--game-project[インライン設定の一部] 使用するゲームプロジェクトのディレクトリを設定します
--directoryダウンロードしたゲームを配置するパス
--client-idADT CLIのclient id。namespaceで使用するidについてはお問い合わせください。
--client-secretADT CLIのclient secret。namespaceで使用する実際のsecretについてはお問い合わせください。
--username現在のusername
--password現在のユーザーのpassword
--show-confirmation確認を表示するかどうか (オプション)
--build-idこのゲームバイナリをターゲットとするbuild ID。ゲームプロジェクトを既に指定していて、Config/BlackBox.iniファイル内に正しいbuild IDがある場合は不要です。
--log-level

ログレベル

デフォルト = info

オプション:

  • info
  • debug
  • warn
  • error