ChunkDownloader のマニフェストとアセットをホスティングする

ローカルホスト ウェブサイトをセットアップする

Choose your operating system:

Windows

macOS

Linux

前提トピック

このページは以下のトピックへの知識があることを前提にしています。まず以下のトピックの内容についてご確認をお願いします。

Unreal Engine ChunkDownloader パッチ適用ソリューションでは、.pak ファイルをウェブ サーバーへ配布する必要があります。また、 マニフェスト ファイル も作成する必要があります。これは、ユーザーがダウンロードを期待するすべてのファイルと、それぞれの予測されるファイル サイズのリストを含むテキスト ファイルです。

パッチ適用プロセスの開始時に、ChunkDownloader が最初にユーザーのデバイスにダウンロードするものがマニフェストです。マニフェストはこの情報を使用して .pak ファイルを 1 つずつリクエストしてダウンロードします。予測されるファイル サイズにより、システムはファイルごとの進捗度を認識することができます。

1. 必要なセットアップ

このガイドでは、「 チャンク用のアセットを準備する 」で準備したプロジェクトを使用します。これは、Paragon のアセットである Boris、Crunch、Khaimera を使用する空のプロジェクトです。そのガイドに記載されている手順に従ってアセットをダウンロードし、それぞれの Primary Asset Label を設定したら、それらのチャンク化されたデータを含む .pak ファイルをクックします。ただし、アセットが .pak ファイルに分割されている限り、次のセクションの手順に従うことができます。

2. マニフェスト ファイルを作成する

マニフェスト ファイルを作成するには、次の手順に従います。

  1. プロジェクトのベース ディレクトリ内にフォルダを作成し、「 PatchingDemoKey 」という名前を付けます。このサンプルでは、「 PatchingDemo/PatchingDemoKey 」になります。

  2. 新しいファイルを作成して「 BuildManifest-Windows.txt 」という名前を付け、テキスト エディタで開きます。

    ManifestFileWindows.png

  3. 新しく $NUM_ENTRIES フィールドの行を追加し、トラッキングしている pak ファイルの数と等しい値を設定します。このサンプルでは、値は 3 になります。

    BuildManifest-Windows.txt

    $NUM_ENTRIES = 3
  4. 新しく $BUILD_ID フィールドの行を追加し、値を「 PatchingDemoKey 」に設定します。

    BuildManifest-Windows.txt

    $BUILD_ID = PatchingDemoKey
  5. それぞれの .pak ファイルのエントリを、次の情報を使用して追加します。

    • .pak のファイル名

    • T .pak のファイル サイズ (バイト) 。この値は、.pak ファイルを右クリックして プロパティ を表示するとわかります。

      pakproperties.png

      .pak ファイルのファイル サイズを使用するようにしてください。ディスク上のサイズではありません。

      • .pak のバージョン 。これは任意の文字列に設定することができます。

    • The .pak の番号 。これは、Primary Asset Label に使用した チャンク インデックス の値と一致する必要があります。

    • .pak ファイルのパス 、マニフェスト ファイルが配置される場所との相対パスです。

    各フィールドのエントリは、タブ区切りで同じ行にある必要があります。そうでない場合、正しく解析されません。たとえば、pakchunk1001 の行は次のようになります。

    [REGION:codetitlebar]
    BuildManifest-Windows.txt
    [/REGION]
    $pakchunk1001-WindowsNoEditor.pak   922604157   ver 1001    /Windows/pakchunk1001-WindowsNoEditor.pak
  6. .pak ファイルを /WindowsNoEditor/PatchingDemo/Content/Paks/ から「 PatchingDemoKey 」フォルダのマニフェストと一緒に並んでいる「 Windows 」という名前のサブフォルダ内にコピーします。

    PatchingDemoKeyFolder.png

このプロセスは、プロジェクトをパッケージ化するたびに、またはユーザーに提供するファイルの変更が必要となるたびに繰り返す必要があります。このサンプルにおける最終的なマニフェスト ファイルは、次のとおりです。

BuildManifest-Windows.txt

$NUM_ENTRIES = 3
$BUILD_ID = PatchingDemoKey
pakchunk1001-WindowsNoEditor.pak    922604157   ver 1001    /Windows/pakchunk1001-WindowsNoEditor.pak
pakchunk1002-WindowsNoEditor.pak    2024330549  ver 1002    /Windows/pakchunk1002-WindowsNoEditor.pak
pakchunk1003-WindowsNoEditor.pak    1973336776  ver 1003    /Windows/pakchunk1003-WindowsNoEditor.pak

3. ファイルをローカル テスト サーバーでホスティングする

ファイルをパッケージ化したので、ゲームがファイルをダウンロードできるようにサーバー上でホスティングする必要があります。また、ChunkDownloader に、サーバーの場所を指示する必要があります。デモンストレーション用に、簡単なローカル ウェブサイトを設定します。

  1. Windows エクスプローラーで [Start Menu] を開き、 [Turn Windows Features on or off (Windows の機能の有効化または無効化)] を検索して開きます。

    StartMenuWindowsFeatures.png

  2. [Windows Features] メニューで、 [Internet Information Services (インターネット情報サービス)] を有効にして [OK] をクリックします。

    WindowsInternetInformationServices.png

  3. [Internet Information Services Manager (IIS Manager)] を開いて [Directory Browsing (ディレクトリをブラウズ)] を有効にします。

    WindowsDirectoryBrowsing.png

  4. ウィンドウの左側にある [Connections] メニューで、 [Sites] を展開して [Default Web Site] をクリックします。

    ConnectionsDefaultWebSite.png

  5. [Default Web Site Home] メニューで、 [MIME Types] をダブルクリックします。

    IISMimeTypes.png

  6. [MIME Types] メニューで 右クリック して [Add] をクリックします。

    AddMimeType.png

  7. [Add MIME Type] ウィンドウで [File Name extension] [.pak] に設定し、 [MIME type] を「application/octet-stream」に設定します。

    AddMimeType2.png

    これにより、IIS はリクエストされると、ただファイルをダウンロードします。

    AddMimeType3.png

  8. [Default Web Site] フォルダに移動します。デフォルトでは「C:\inetpub\wwwroot」です。フォルダを作成し、「 PatchingDemoCDN 」という名前を付けます。

    DefaultWebSiteFolder.png

  9. PatchingDemoKey 」フォルダを「 PatchingDemoCDN 」にコピーします。

    CopyPatchingDemoKey.png

  10. プロジェクトの DefaultGame.ini ファイルを開き、次の情報を追加して CDN Base URL を定義します。

    DefaultGame.ini

    [/Script/Plugins.ChunkDownloader PatchingDemoLive] +CdnBaseUrls=127.0.0.1/PatchingDemoCDN

    この URL は、ファイルが配置されているウェブサイトを ChunkDownloader に示しています。 PatchingDemoLive 修飾子により、ターゲットのプラットフォームに応じて様々な CDN デプロイ コンフィギュレーションを使用できます。

このサンプルで使用している URL は、前述の手順で設定したローカル ウェブサイトのみを示しています。ローカル エリア ネットワークやリモート CDN を使用してサーバーに接続しようとする場合は、追加のコンフィギュレーションやセキュリティが必要になります。

最終結果

アセットを .pak ファイルに分割し、ローカル ウェブサイトにステージングできたので、Unreal Engine でパッチ適用ソリューションを使用してアクセスすることができるようになりました。

Unreal Engine のドキュメントを改善するために協力をお願いします!どのような改善を望んでいるかご意見をお聞かせください。
調査に参加する
閉じる