クックされたゲームバイナリのアップロード/ダウンロード
注釈:本資料は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>
アップロードサブコマンド
この表は、バイナリをアップロードする際に使用できるサブコマンドを示しています。
| メインコマンド | サブコマンド | オプションとパラメータ | |
|---|---|---|---|
| 名前 | 説明 | ||
build | upload-binaries | -n, --namespace | Namespace |
-a, --apikey | API Key | ||
-r, --game-archive | パッケージ化されたゲームパス (デフォルト: 設定されたパッケージ化ゲームパス) | ||
--version-id | Version ID (デフォルト: 設定されたbuild id) | ||
-b, --build-id | Build 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 | ログレベル - デフォルトは オプション:
| ||
--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を使用してバイナリをアップロードする際に使用できるサブコマンドが含まれています。
| メインコマンド | サブコマンド | オプションとパラメータ | |
|---|---|---|---|
| 名前 | 説明 | ||
build | game-binary upload | --apikey | [インライン設定の一部] 使用するAPI Keyを設定します |
--namespace | [インライン設定の一部] 使用するnamespaceを設定します | ||
--game-project | [インライン設定の一部] 使用するゲームプロジェクトのディレクトリを設定します | ||
--game-archive | パッケージ化されたゲームパス | ||
--client-id | CLIのclient id (namespaceで使用する実際のidについてはお問い合わせください) | ||
--client-secret | CLIのclient secret。namespaceで使用する実際のsecretについてはお問い合わせください。 | ||
--username | 現在のユーザーのusername | ||
--password | 現在のユーザーのpassword | ||
--show-confirmation | (オプション) 確認を表示するかどうか | ||
--build-id | このゲームバイナリをターゲットとするbuild ID。ゲームプロジェクトを既に指定していて、Config/BlackBox.iniファイル内に正しいbuild IDがある場合は不要です。 | ||
--entry-point | game-archiveからの相対的なゲームの実行可能パス | ||
--launch-arguments | ゲームの起動引数 (オプション) | ||
--ignore | .ignoreconfigファイルの絶対パス、無視パターンは.gitignoreと同様です | ||
--multipart-size | マルチパートアップロードサイズ(メガバイト単位)、5 MB以上である必要があります (デフォルト: 1024) | ||
--log-level | ログレベル (デフォルト: info、オプション: info、debug、warn、error) | ||
ゲームバイナリのダウンロード
バイナリをアップロードする方法と同様に、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を使用してバイナリをダウンロードする際に使用するサブコマンドを示しています。
| メインコマンド | サブコマンド | オプションとパラメータ | |
|---|---|---|---|
| 名前 | 説明 | ||
build | game-binary download | --apikey | [インライン設定の一部] 使用するAPI Keyを設定します |
--namespace | [インライン設定の一部] 使用するnamespaceを設定します | ||
--game-project | [インライン設定の一部] 使用するゲームプロジェクトのディレクトリを設定します | ||
--directory | ダウンロードしたゲームを配置するパス | ||
--client-id | ADT CLIのclient id。namespaceで使用するidについてはお問い合わせください。 | ||
--client-secret | ADT CLIのclient secret。namespaceで使用する実際のsecretについてはお問い合わせください。 | ||
--username | 現在のusername | ||
--password | 現在のユーザーのpassword | ||
--show-confirmation | 確認を表示するかどうか (オプション) | ||
--build-id | このゲームバイナリをターゲットとするbuild ID。ゲームプロジェクトを既に指定していて、Config/BlackBox.iniファイル内に正しいbuild IDがある場合は不要です。 | ||
--log-level | ログレベル デフォルト = オプション:
| ||