Skip to main content
ゲームを最新の状態に保つことが重要な場合、タイトルは更新プログラムをチェックして適用できます。この条件は、ゲームを実行するすべてのプレーヤーが同じ機能を持つことが極めて重要なマルチプレイヤー機能を含むゲームでよく重要になります。 タイトルは、次のサンプル コードに示すように、XStoreQueryGameAndDlcPackageUpdatesAsync を使用して更新プログラムを確認できます。
更新チェックを必要としない DLC 項目がタイトルに多数含まれる場合 (たとえば、ライセンス供与のためだけに使用される空の DLC パッケージなど)、上記のコードでは各項目をチェックすることで不必要なオーバーヘッドが発生する可能性があります。 代わりに、XPackageGetCurrentProcessPackageIdentifier を使用して取得した現在のゲームのパッケージ ID でフィルターするか、XPackageEnumeratePackages から返されるパッケージ ID をフィルターして、XStoreQueryPackageUpdatesAsync を使用してください。

更新プログラムのダウンロードとインストール

更新プログラムのセットを特定した後、XStoreDownloadAndInstallPackageUpdatesAsync を使用してすべての更新プログラムをキューに入れてダウンロードします。
この時点で、ゲームは更新プログラムを適用するために終了します。このプロセスは警告なしに発生するため、この関数を呼び出す前にユーザーに十分な通知または確認を提供してください。

ダウンロードの進行状況の監視

ダウンロードが進行中のときは、XPackageCreateInstallationMonitor を使用してダウンロードの進行状況を監視します。

更新プログラムのテスト

開発中は、ローカル パッケージを使用してのみ、更新プログラムの可用性をテストできます。
  1. 更新チェックとダウンロード コードを含む V1 パッケージを作成します。
  2. 同じ ID でバージョン番号を増加させた V2 パッケージを作成します。
  3. xbapp/wdapp install V1 を実行します。
  4. xbapp/wdapp update V2 /a を実行します。
  5. V1 を起動します。
パッケージ間でコンテンツ ID が一致していることを確認してください。 このプロセスの結果、V1 の XStoreQueryGameAndDlcPackageUpdatesAsync または XStoreQueryPackageUpdatesAsync の呼び出しで利用可能な更新プログラムが見つかり、XStoreDownloadAndInstallPackageUpdatesAsync は通知された V2 パッケージを使用して V1 を更新します。V2 の「ダウンロード」が進行中の場合、この状態は XBOX のダウンロード キュー、XBOX アプリ、または Microsoft Store アプリのキューに項目として表示されます。インストールが完了すると、V2 がインストールされます。xbapp/wdapp list[dlc] を使用してインストールを確認できます。 /a の代わりに /m を使用すると、更新プログラムが「必須」になります。これは、単に XStorePackageUpdate.isMandatory フィールドに影響します。 署名の違いにより、開発ビルドから Store からダウンロードするパッケージに更新することはできません。 効率的な更新プログラムの作成方法とテスト方法の詳細については、次のセクションで参照されているコンテンツ更新ページをご覧ください。

リファレンス API ドキュメント

関連項目

コマースの概要 XStore 開発とテストの有効化 コンテンツ更新のベスト プラクティス コンテンツ更新の作成、確認、テスト XStore API リファレンス
最終更新日 2026年8月24日