원격 Windows 게임 개발 FAQ

자주 묻는 질문

알려진 문제, 종속성 및 제한 사항은 무엇인가요?

알려진 문제

1. 필수 도구(Xbox PC 장치 관리자, Microsoft.PowerShell.*또는 Microsoft.Windows.Developer)를 설치하는 동안 오류가 발생했습니다.

   • 해결 방법: 에서 모듈 디렉터리를 삭제하고 다시 시도합니다 %onedrive%/Documents/PowerShell/Modules/ .
   • 원인: OneDrive가 PowerShell 모듈 설치를 방해할 수 있습니다. 팀은 모듈 설치 디렉터리에 대한 대안을 모색하고 있습니다.

2. OpenSSH 오류: kex_exchange_identification: read: Connection reset

   • 수정 사항:
     • 대상 디바이스를 다시 시작합니다.
     • 디바이스가 프라이빗 네트워크 프로필에 있는지 확인합니다. 그렇지 않으면 방화벽이 연결을 차단할 수 있습니다.
     • 로컬 디바이스에서 손상된 known_hosts 파일을 확인합니다.
   • 참고: 코드와 관련이 없는 OpenSSH 관련 문제입니다.

3. winget Microsoft PowerShell 7.5 installation fails (0x8A150049):

   • 해결 방법: PowerShell 7.6 제거(Visual Studio 2026에 포함)
   • 원인: 최신 버전으로 인해 설치 충돌이 발생합니다. 이 문제는 공개 릴리스에서 수정됩니다.

4. 도메인에 가입된 대상 디바이스: OpenSSH 연결에는 암호 기반 인증만 지원됩니다(키 기반 인증은 선호되지만 사용할 수 없음).

   • 참고: 도메인에 가입된 Windows Pro 디바이스에 영향을 줍니다. 팀은 향후 개선을 위해 OpenSSH 및 AAD 팀과 협력하고 있습니다.

5. WinGet 명령 오류(예: 'winget search'가 실패함)

   • 해결 방법: 대상 디바이스를 다시 부팅합니다. 이 문제는 조사 중입니다.

종속성 및 제한 사항

• 두 장치 모두 설치하는 동안 인터넷에 액세스해야 합니다.
• 디바이스는 동일한 로컬 네트워크에 있어야 하며 서로 ping할 수 있어야 합니다.
• Xbox PC 도구 상자 앱은 RETAIL 샌드박스에서만 사용할 수 있습니다. 디바이스가 MICROSOFT Store에서 다운로드할 RETAIL 모드인지 확인합니다.
• 지원되는 디바이스: Windows 10 또는 Windows 11, Home 또는 Pro 버전.
• 설치하는 동안 두 디바이스에 대한 물리적 액세스가 필요합니다.
• 설치를 위해 두 디바이스에서 관리자 액세스가 필요합니다.
• Azure AAD(Active Directory)-조인된 대상 디바이스는 지원되지 않습니다.

디바이스 연결 정보를 찾을 어떻게 할까요? 있나요?

대상 디바이스를 Xbox PC 도구 상자와 페어링하면 연결 세부 정보가 테스트 디바이스 화면에 표시됩니다.

또는 대상 디바이스에서 PowerShell을 사용합니다.

# Open a PowerShell 7 terminal
$env:ComputerName  # Device name
$env:Username      # Username  
ipconfig           # IP address

디바이스에서 구성 변경 내용을 확인할 어떻게 할까요? 있나요?

DSC(디바이스 State Configuration) 및 PowerShell을 사용하여 구성을 테스트합니다.

# Open a PowerShell 7 terminal on the DevPC
dsc config test -f "$env:LOCALAPPDATA\XboxPCDeviceManager\config\devPC.dsc.yaml"

# Network (usable on either device)  
dsc config test -f "$env:LOCALAPPDATA\XboxPCDeviceManager\config\network.dsc.yaml"

# Open a PowerShell 7 terminal on TargetDevice
dsc config test -f "$env:LOCALAPPDATA\XboxPCDeviceManager\config\targetDevice.dsc.yaml"

또한 각 디바이스에 대한 Windows 설정에서 구성 변경 내용을 검사 수 있습니다.

샌드박스를 확인하고 변경할 어떻게 할까요? 있나요?

도구 기능을 위해 샌드박스를 RETAIL 로 설정합니다. 현재 구성을 검사 다음을 실행합니다.xblpcsandbox /get

RETAIL로 설정하지 않은 경우 다음으로 전환합니다.

XblPCSandbox.exe RETAIL

보안 채널 설정을 위해 특정 네트워크 어댑터를 선택할 어떻게 할까요? 있나요?

설치하는 동안 Xbox PC 도구 상자를 사용하면 네트워크 어댑터를 선택할 수 있습니다.

문제를 어떻게 보고할 수 있습니까?

Xbox PC 도구 상자 제목 표시줄에서 피드백 보내기를 선택합니다. 그런 다음 문제 보고를 선택합니다.

다음 세부 정보를 포함합니다.

• 운영 체제 버전(Windows 10/11 빌드)
• Xbox 장치 관리 PowerShell 모듈 문제용 PowerShell 버전($PSVersionTable)
• 네트워크 구성 (Wi-Fi/이더넷, 회사/홈)
• 오류 메시지 (정확한 텍스트)
• 재현 단계
• 사용 중인 도구(Xbox PC 도구 상자, Xbox 장치 관리 PowerShell 모듈 wdRemote또는 wdEndpoint)
• 미리 보기 버전

Xbox 장치 관리 XDM(PowerShell 모듈)과 wdRemote/wdEndpoint의 차이점은 무엇인가요?

• XDM: 보안 통신 채널을 설정합니다.
• wdRemote/wdEndpoint: 해당 채널을 통해 게임을 배포하고 시작합니다.

XDM 및 wdRemote/wdEndpoint가 모두 필요합니까?

네. XDM을 사용하여 연결을 설정한 다음 wdRemote/wdEndpoint , 게임 배포 및 실행에 사용합니다.

관리자 권한으로 처음 실행하는 wdEndpoint 이유는 무엇인가요?

인증서를 만들고 저장하고 HTTPS URL을 바인딩하려면 관리자 액세스가 필요합니다. 후속 실행에는 상승이 필요하지 않습니다.

동일한 대상 디바이스에 여러 게임을 배포할 수 있나요?

네. 필요에 따라 다른 디렉터리에 게임을 배포하고 시작합니다.

배포하는 동안 네트워크 연결이 끊어지면 어떻게 되나요?

wdRemote 오류가 표시됩니다. 연결을 복원한 후 배포 명령을 다시 시도합니다.

모든 통신이 암호화되었나요?

네. 개발 PC와 대상 디바이스 간의 모든 통신이 암호화됩니다.

각 작업에 어떤 도구를 사용해야 하나요?

• Xbox PC 도구 상자: 디바이스를 원격으로 프로비전 및 획득하고, 보안 채널을 설정하고, 종속성을 설치하고, 디바이스를 구성합니다.
• 연결 테스트: 게임을 배포하기 전에 Xbox PC 도구 상자를 사용합니다.
• 원격 세션: XDM 사용 원격 세션 및 PowerShell 원격을 사용하여 대상 디바이스에서 명령을 실행합니다.
• wdRemote/wdEndpoint: 게임을 배포, 테스트 및 종료합니다.

Windows 게임에서 이러한 도구를 사용할 수 있나요?

네. 이러한 도구는 GDK 게임뿐만 아니라 모든 Windows 실행 파일에서 작동합니다.

이러한 도구는 어떤 네트워크 포트를 사용합니까?

• XDM: SSH(포트 22)
• wdEndpoint: HTTPS(포트 4275)