次の方法で共有

リモート Windows ゲーム開発ツールの使用方法

Important

Xbox PC ツールボックス アプリはプレビュー段階です。 詳細については、Microsoft の担当者にお問い合わせください。

開発デバイスを設定する

  1. デバイスで、Windows 上の Microsoft Store から Xbox PC ツールボックスをダウンロードしてインストールします。

  2. アプリを開きます。 [開発デバイスとして設定] を選択し、[続行] を選択します。

  3. [ツールのインストール] を選択して、環境に必要なコンポーネントを追加します。

    注意

    [ツールのインストール] を選択すると、[契約条件]に同意します。 条件を確認するには、インストール画面でリンクを選択します。

    Xbox PC ツールボックス アプリのセットアップの前提条件のインストール画面

  4. インストール後、セキュリティで保護されたチャネルのネットワーク アダプターを選択します。 システムに 1 つのアダプターがある場合は、自動的に選択されます。

  5. SSH キーを保護するために、強力なパスフレーズを追加します。 パスフレーズを安全に保存します。

  6. [確認] をクリックして、デバイス構成プロセスを開始します。

  7. 構成が完了すると、デバイス ワークスペース画面が表示されます。

リモート ターゲット デバイスを設定する

注意

両方のデバイスのセットアップ手順は、次を除いて同じです。

  • 手順 2: [代わりにリモート イテレーション デバイスとして設定する] を選択する
  • 手順 5: SSH キーを作成したり、ターゲット デバイスにパスフレーズを追加したりすることはありません。

上記の調整が行われた状態で、手順 6 までの開発デバイスと同じ手順に従います。

デバイスのペアリング

  1. リモート ターゲット デバイス上の操作: ワークスペースで、[このデバイスのペアリング] を選択してペアリングを開始します。

    このデバイスのペアリング

  2. ターゲット デバイス上の操作:[ペアリングの開始] を選択します。 アプリによってピンが生成され、接続の詳細が表示されます。 セットアップと接続のテストについては、次の詳細に注意してください。

    リモート デバイスの接続の詳細

    注意

    開発用 PC にピンを入力できるのは、タイムアウトまでの 2 分間だけです。

  3. 開発デバイス上の操作: [デバイス ワークスペース] 画面で、[デバイスのペアリング] を選択します。 これにより、ペアリング画面が開き、リモート イテレーション デバイスから取得した接続情報が入力されます。 エイリアス、IP アドレス、またはデバイス名、ユーザー名、ピンを入力します。 [確認] を選択します。

    新しいデバイスのペアリング

  4. リモート ターゲット デバイス上の操作: ペアリングが成功したら、[ホームに戻る] を選択してワークスペースに戻ります。 デバイスは、セキュリティで保護されたリモート接続の準備ができました。

    ペアリングに成功しました

  5. 開発デバイス上の操作: セットアップを完了するには、SSH フィンガープリントを受け入れます。 アプリがターミナルを開き、続行するかどうかを確認するメッセージが表示されます。 「yes」と入力して Enter キーを押します。

    SSH フィンガープリントを受け入れる

    注意

    接続後、「exit」と入力し、Enter キーを押してウィンドウを閉じます。 X ボタンで閉じると、既知の問題が発生する可能性があります。

  6. 開発デバイス上 接続テストが完了すると、成功画面でデバイスが安全にペアリングされていることが確認できます。 [戻る] を選択します。

Xbox PC デバイス マネージャー (XDM) の使用

Xbox PC デバイス マネージャー (XDM) は、セットアップ中にインストールされる PowerShell モジュールです。 開発用 PC とリモート デバイスの間で、セキュリティで保護された暗号化された通信を確立します。 XDM は、デバイスの取得、OpenSSH 構成、信頼を管理し、デバイス状態管理を使用してリモート コマンドを実行できるようにします。

対話型セッションを開始する

開発用 PC で、Xbox PC ツールボックスのデバイス ワークスペースに移動します。 接続するデバイスのカードを見つけて、[接続] を選択します。

[デバイス ワークスペースの接続] 画面

これにより、コマンドライン ターミナルでリモート デバイスとの対話型セッションが開始されます。 ここで実行するコマンドは、リモート デバイスで実行されます。

リモート イテレーション ツールのプロビジョニング

wdRemote と wdEndpoint は、Xbox PC ツールボックス アプリケーションとのセキュリティで保護された接続を設定した後、リモート Windows デバイスでゲームを段階的に展開、起動、終了するためのコマンドライン ユーティリティです。 どちらのスタンドアロン実行可能ファイルも、ペアリング中にインストールされます。

  • wdRemote.exe: 開発用 PC で実行され、コマンドが送信されます。
  • wdEndpoint.exe: ターゲット デバイスで実行され、コマンドが実行されます。

wdRemote を使用する

開発用 PC でコマンドライン ターミナルを開き、wdRemote コマンドを実行します。

ゲームを展開する

リモート マシンのパスを指定する場合は、gameroot ディレクトリを基準としたパスを使用します。 ゲーム ルート ディレクトリは、ターゲット デバイスに C:\%ProgramData%\Microsoft GDK\wdEndpoint\gameroot されます。

# Syntax
wdRemote /action:deploy /device:<computername or ip address> /source:<source_directory> /destination:<destination_directory_under_gameroot>

# Example
wdRemote /action:deploy /device:mypc1 /source:c:\game /destination:gamedir

ゲームを起動する

# Syntax  
wdRemote /action:launch /device:<computername or ip address> /path:<remote_path_to_exe_within_gameroot>

# Example
wdRemote /action:launch /device:mypc1 /path:gamedir\game.exe

ゲームを終了する

# Syntax
wdRemote /action:terminate /device:<computername or ip address> /processid:<game_process_id>

# Example
wdRemote /action:terminate /device:mypc1 /processid:1234

フィードバックを送信する

Xbox PC ツールボックスのタイトル バーで、[フィードバックの送信] を選択します。 次に、[問題の報告] を選択します。

代替テキスト

問題を報告する場合は、次の情報を含めてください:

  • オペレーティング システムのバージョン (Windows 10/11 ビルド)
  • Xbox デバイス管理 PowerShell モジュールの PowerShell バージョン ($PSVersionTable) に関する問題
  • ネットワーク構成 (Wi-Fi/イーサネット、企業/ホーム)
  • エラー メッセージ (正確なテキスト)
  • 再現手順
  • 使用されているツール (Xbox PC ツールボックス、Xbox デバイス管理 PowerShell モジュール、wdRemote、または wdEndpoint)
  • 使用しているプレビュー バージョン
  • Last updated on