クックされたゲームバイナリのアップロード/ダウンロード
注釈：本資料は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 | ネームスペース |
-a, --apikey | API キー | ||
-r, --game-archive | パッケージ化されたゲームのパス（デフォルト: 設定されたパッケージ化されたゲームのパス） | ||
--version-id | バージョン ID（デフォルト: 設定されたビルド ID） | ||
-b, --build-id | ビルド ID（デフォルト: 設定されたビルド 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 キーに加えて --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 キーを設定します |
--namespace | [インライン設定の一部] 使用するネームスペースを設定します | ||
--game-project | [インライン設定の一部] 使用するゲームプロジェクトのディレクトリを設定します | ||
--game-archive | パッケージ化されたゲームのパス | ||
--client-id | CLI のクライアント ID（ネームスペースで使用する実際の ID については、お問い合わせください） | ||
--client-secret | CLI のクライアントシークレット。ネームスペースで使用する実際のシークレットについては、お問い合わせください。 | ||
--username | 現在のユーザー名 | ||
--password | 現在のユーザーのパスワード | ||
--show-confirmation | （オプション）確認を表示するかどうか | ||
--build-id | このゲームバイナリのターゲットとなるビルド ID。ゲームプロジェクトを既に指定していて、Config/BlackBox.ini ファイル内に正しいビルド 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 キーを設定します |
--namespace | [インライン設定の一部] 使用するネームスペースを設定します | ||
--game-project | [インライン設定の一部] 使用するゲームプロジェクトのディレクトリを設定します | ||
--directory | ダウンロードされたゲームを配置するパス | ||
--client-id | ADT CLI のクライアント ID。ネームスペースで使用する ID については、お問い合わせください。 | ||
--client-secret | ADT CLI のクライアントシークレット。ネームスペースで使用する実際のシークレットについては、お問い合わせください。 | ||
--username | 現在のユーザー名 | ||
--password | 現在のユーザーのパスワード | ||
--show-confirmation | 確認を表示するかどうか（オプション） | ||
--build-id | このゲームバイナリのターゲットとなるビルド ID。ゲームプロジェクトを既に指定していて、Config/BlackBox.ini ファイル内に正しいビルド ID がある場合は不要です。 | ||
--log-level | ログレベル デフォルト = オプション:
| ||