다음을 통해 공유

원격 Windows 게임 개발 도구를 사용하는 방법

Important

Xbox PC 도구 상자 앱은 미리 보기 상태입니다. 자세한 내용은 Microsoft 담당자에게 문의하세요.

개발 디바이스 설정

  1. 장치에서 Windows의 Microsoft Store에서 Xbox PC 도구 상자를 다운로드하여 설치합니다.

  2. 앱을 엽니다. 개발 디바이스로 설정을 선택한 다음, 계속을 선택합니다.

  3. 도구 설치를 선택하여 사용자 환경에 필요한 구성 요소를 추가합니다.

    참고 항목

    도구 설치를 선택하면 계약 조건에 동의합니다. 사용 약관을 검토하려면 설치 화면에서 링크를 선택합니다.

    Xbox PC 도구 상자 앱 설정 필수 구성 요소 설치 화면

  4. 설치 후 보안 채널의 네트워크 어댑터를 선택합니다. 시스템에 어댑터가 하나 있는 경우 자동으로 선택됩니다.

  5. 강력한 암호를 추가하여 SSH 키를 보호합니다. 암호를 안전하게 저장합니다.

  6. 확인을 선택하여 디바이스 구성 프로세스를 시작합니다.

  7. 구성이 완료되면 디바이스 작업 영역 화면이 표시됩니다.

원격 대상 디바이스 설정

참고 항목

다음을 제외하고 두 디바이스에 대한 설정 단계는 동일합니다.

  • 2단계: 원격 반복 디바이스로 설정 대신 선택
  • 5단계: SSH 키를 만들거나 대상 디바이스에 암호를 추가하지 않습니다.

위의 조정을 사용하여 6단계까지의 개발 디바이스와 동일한 단계를 수행합니다.

디바이스 페어링

  1. 원격 대상 디바이스에서 다음을 수행합니다. 작업 영역에서 이 디바이스 페어링 을 선택하여 페어링을 시작합니다.

    이 디바이스 페어링

  2. 대상 디바이스에서 다음을 수행합니다. 페어링 시작을 선택합니다. 앱은 핀을 생성하고 연결 세부 정보를 표시합니다. 연결 설정 및 테스트에 대한 이러한 세부 정보를 확인합니다.

    원격 디바이스 연결 세부 정보

    참고 항목

    만료되기 전에 개발 PC에서 핀을 입력하는 데 2분이 걸립니다.

  3. 개발 디바이스에서 다음을 수행합니다 . 디바이스 작업 영역 화면에서 디바이스 페어링을 선택합니다. 그러면 원격 반복 디바이스에서 가져온 연결 정보를 입력하는 페어링 화면이 열립니다. 별칭, IP 주소 또는 디바이스 이름, 사용자 이름 및 고정을 입력합니다. 확인을 선택합니다.

    새 디바이스 페어링

  4. 원격 대상 디바이스에서 다음을 수행합니다. 페어링에 성공하면 홈 반환 을 선택하여 작업 영역으로 돌아갑니다. 디바이스는 보안 원격 연결에 사용할 준비가 된 것입니다.

    페어링 성공

  5. 개발 디바이스에서 다음을 수행합니다 . 설정을 완료하려면 SSH 지문을 적용합니다. 앱이 터미널을 열고 계속할지 묻습니다. yes를 입력하고 Enter 키를 누릅니다.

    SSH 지문 허용

    참고 항목

    연결한 후 Enter 키를 눌러 exit 창을 닫습니다. X 단추를 사용하여 닫으면 알려진 문제가 발생할 수 있습니다.

  6. 개발 디바이스에서 연결 테스트가 완료되면 성공 화면에서 디바이스가 안전하게 페어링되었음을 확인합니다. 반환을 선택합니다.

Xbox PC 장치 관리자(XDM) 사용

XDM(Xbox PC 장치 관리자)은 설치 중에 설치된 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