Windows 장치 포털 사용Using the Windows Device Portal

기능FeatureHoloLens(1세대)HoloLens (1st gen)HoloLens 2HoloLens 2
Windows Device PortalWindows Device Portal ✔️✔️ ✔️✔️

HoloLens용 Windows 장치 포털을 사용하면 Wi-Fi 또는 USB를 통해 원격으로 디바이스를 구성하고 관리할 수 있습니다.The Windows Device Portal for HoloLens lets you configure and manage your device remotely over Wi-Fi or USB. Device Portal은 PC의 웹 브라우저에서 연결 가능한 HoloLens에 있는 웹 서버입니다.The Device Portal is a web server on your HoloLens that you can connect to from a web browser on your PC. 장치 포털에는 HoloLens를 관리하고 앱을 디버깅 및 최적화하는 데 도움이 되는 많은 도구가 포함되어 있습니다.The Device Portal includes many tools that will help you manage your HoloLens and debug and optimize your apps.

이 설명서에서는 HoloLens용 Windows 장치 포털을 중점적으로 설명합니다.This documentation is specifically about the Windows Device Portal for HoloLens. Windows Mixed Reality를 포함한 데스크톱용 Windows 장치 포털을 사용하려면 Windows 장치 포털 개요를 참조하세요.To use the Windows Device portal for desktop (including for Windows Mixed Reality), see Windows Device Portal overview

Windows 장치 포털을 사용하도록 HoloLens 설정Setting up HoloLens to use Windows Device Portal

  1. HoloLens의 전원을 켜고 디바이스에 배치합니다.Power on your HoloLens and put on the device.
  2. 시작 제스처(HoloLens 2) 또는 블룸(HoloLens 1세대)으로 주 메뉴를 실행합니다.Perform the Start gesture for HoloLens2 or Bloom on HoloLens (1st Gen) to launch the main menu.
  3. 설정 타일을 응시하고 HoloLens 1세대에서 에어 탭 제스처를 수행하거나 HoloLens 2에서 터치하거나 손 광선을 사용하여 선택합니다.Gaze at the Settings tile and perform the air-tap gesture on HoloLens (1st Gen) or select it on HoloLens 2 by touching it or using a Hand ray.
  4. 업데이트 메뉴 항목을 선택합니다.Select the Update menu item.
  5. 개발자용 메뉴 항목을 선택합니다.Select the For developers menu item.
  6. 개발자 모드를 사용하도록 설정합니다.Enable Developer Mode.

중요

관리자가 아닌 다중 사용자인 경우 개발자 모드를 시작할 수 있는 기능이 회색으로 표시될 수 있습니다. 디바이스에 대한 관리자 인지 확인하세요.If you're in multi-user and not an admin, the ability to enter Developer Mode may be grayed out. Please ensure that you are an admin on the device.

  1. 아래로 스크롤하여 장치 포털을 사용하도록 설정합니다.Scroll down and enable Device Portal.
  2. USB 또는 Wi-Fi를 통해 이 HoloLens에 앱을 배포할 수 있도록 Windows 장치 포털을 설정하려면 연결을 클릭하여 연결 PIN을 생성합니다.If you are setting up Windows Device Portal so you can deploy apps to this HoloLens over USB or Wi-Fi, click Pair to generate a pairing PIN. 첫 번째 배포 시에는 Visual Studio에 PIN을 입력할 때까지 PIN 팝업에서 설정 앱을 그대로 둡니다.Leave the Settings app at the PIN popup until you enter the PIN into Visual Studio during your first deployment.

Windows Holographic 설정 앱에서 개발자 모드 사용

Wi-Fi를 통한 연결Connecting over Wi-Fi

  1. HoloLens를 Wi-Fi에 연결합니다.Connect your HoloLens to Wi-Fi.
  2. 다음 중 하나를 수행하여 디바이스의 IP 주소를 조회합니다.Look up your device's IP address by either:
    • 설정 > 네트워크 및 인터넷 > Wi-Fi > 고급 옵션으로 차례로 이동합니다.Going to Settings > Network & Internet > Wi-Fi > Advanced Options.
    • 설정 > 네트워크 및 인터넷으로 차례로 이동하고, 하드웨어 속성을 선택합니다.Going to Settings > Network & Internet and selecting Hardware properties.

HoloLens 2 설정

  1. PC의 웹 브라우저에서 https://<YOUR_HOLOLENS_IP_ADDRESS>로 이동합니다.From a web browser on your PC, go to https://<YOUR_HOLOLENS_IP_ADDRESS>
    • 브라우저에 다음 메시지가 표시됩니다. "이 웹 사이트의 보안 인증서에 문제가 있습니다."The browser will display the following message: "There's a problem with this website's security certificate". 이 오류는 디바이스 포털에 발행된 인증서가 테스트 인증서이기 때문에 발생합니다.This happens because the certificate which is issued to the Device Portal is a test certificate. 지금은 이 인증서 오류를 무시하고 계속 진행할 수 있습니다.You can ignore this certificate error for now and proceed.

USB를 통한 연결Connecting over USB

  1. 도구를 설치하여 USB 연결을 사용하도록 설정하기 위해 Windows 10 개발자 도구가 설치된 Visual Studio가 PC에 있는지 확인합니다.Install the tools to make sure you have Visual Studio with the Windows 10 developer tools installed on your PC to enable USB connectivity.

중요

USB 연결과 관련된 문제가 있으면 USB 디바이스 연결 선택적 구성 요소가 Visual Studio 도구 패키지 의 일부로 설치되어 있는지 다시 확인하세요.If you're having issues with USB connectivity double check that the USB Device Connectivity optional component is installed as part of your Visual Studio tool package.

  1. 마이크로 USB 케이블(HoloLens 1세대) 또는 USB-C(HoloLens 2)를 사용하여 HoloLens를 PC에 연결합니다.Connect your HoloLens to your PC with a micro-USB cable for HoloLens (1st Gen) or USB-C for HoloLens 2.
  2. PC의 웹 브라우저에서 https://127.0.0.1:10080으로 이동합니다.From a web browser on your PC, go to https://127.0.0.1:10080.

USB를 통해 파일 이동Moving files over USB

추가 설정 없이 파일을 PC에서 HoloLens로 이동할 수 있습니다.You can move files from your PC to your HoloLens without any additional setup.

  1. USB 코드를 사용하여 PC를 HoloLens에 연결합니다.Connect your PC to your HoloLens with a USB cord
  2. 데스크톱에서 파일을 PC\[Your_HoloLens_Device_Name]\Internal Storage로 끕니다.Drag your files into PC\[Your_HoloLens_Device_Name]\Internal Storage on your desktop
  3. 시작 메뉴를 열고, HoloLens에서 모든 앱 > 파일 탐색기를 차례로 선택합니다.Open the Start Menu and select All apps > File Explorer on your HoloLens

참고

"최근에 사용한 파일"에서 벗어나서 파일을 찾으려면 패널 왼쪽에서 이 디바이스를 선택해야 할 수 있습니다.You may need to select This device on the left side of the panel to navigate away from "Recently used" to locate your files.

에뮬레이터에 연결Connecting to an emulator

에뮬레이터로 디바이스 포털을 사용할 수도 있습니다.You can also use the Device Portal with your emulator. 장치 포털에 연결하려면 도구 모음을 사용합니다.To connect to the Device Portal, use the toolbar. 다음 아이콘을 클릭합니다. 장치 포털 열기 아이콘 장치 포털 열기: 에뮬레이터에서 HoloLens OS용 Windows 디바이스 포털을 엽니다.Click on this icon: Open Device Portal icon Open Device Portal: Open the Windows Device Portal for the HoloLens OS in the emulator.

사용자 이름 및 암호 만들기Creating a Username and Password

Windows 장치 포털에 대한 액세스 설정Set up access to Windows Device Portal
Windows 장치 포털에 대한 액세스 설정Set up access to Windows Device Portal

HoloLens에서 디바이스 포털에 처음 연결하면 사용자 이름 및 암호를 만들어야 합니다.The first time you connect to the Device Portal on your HoloLens, you will need to create a username and password.

  1. PC의 웹 브라우저에서 HoloLens의 IP 주소를 입력합니다.In a web browser on your PC, enter the IP address of the HoloLens. 액세스 설정 페이지가 열립니다.The Set up access page opens.
  2. PIN 요청을 클릭 또는 탭하고 HoloLens 디스플레이를 확인하여 생성된 PIN을 가져옵니다.Click or tap Request pin and look at the HoloLens display to get the generated PIN.
  3. 디바이스에 표시된 PIN 텍스트 상자에 PIN을 입력합니다.Enter the PIN in the PIN displayed on your device textbox.
  4. 디바이스 포털 연결에 사용할 사용자 이름을 입력합니다.Enter the user name you will use to connect to the Device Portal. MSA(Microsoft 계정) 이름 또는 도메인 이름일 필요는 없습니다.It doesn't need to be a Microsoft Account (MSA) name or a domain name.
  5. 암호를 입력하고 확인합니다.Enter a password and confirm it. 암호는 7자 이상이어야 합니다.The password must be at least seven characters in length. MSA 또는 도메인 암호일 필요는 없습니다.It doesn't need to be an MSA or domain password.
  6. 연결을 클릭하여 HoloLens의 Windows 장치 포털에 연결합니다.Click Pair to connect to Windows Device Portal on the HoloLens.

이 사용자 이름 또는 암호를 변경하려는 경우 언제든지 https://<YOUR_HOLOLENS_IP_ADDRESS>/devicepair.htm으로 이동하여 디바이스 보안 페이지를 방문하면 이 프로세스를 반복할 수 있습니다.If you wish to change this username or password at any time, you can repeat this process by visiting the device security page by navigating to: https://<YOUR_HOLOLENS_IP_ADDRESS>/devicepair.htm.

보안 인증서Security certificate

브라우저에 "인증서 오류"가 표시되는 경우 디바이스와 트러스트 관계를 만들어 수정할 수 있습니다.If you see a "certificate error" in your browser, you can fix it by creating a trust relationship with the device.

각 HoloLens는 해당 SSL 연결에 대한 고유의 자체 서명된 인증서를 생성합니다.Each HoloLens generates a unique self-signed certificate for its SSL connection. 기본적으로 이 인증서는 PC의 웹 브라우저에서 신뢰하지 않아 "인증서 오류"가 발생할 수 있습니다.By default, this certificate is not trusted by your PC's web browser and you may get a "certificate error". 신뢰하는 Wi-Fi 네트워크 또는 USB를 통해 HoloLens에서 이 인증서를 다운로드하고 PC에서 신뢰할 수 있도록 만들어 안전하게 디바이스에 연결할 수 있습니다.By downloading this certificate from your HoloLens (over USB or a Wi-Fi network you trust) and trusting it on your PC, you can securely connect to your device.

  1. 보안된 네트워크(신뢰하는 Wi-Fi 네트워크 또는 USB)에 있는지 확인합니다.Make sure you are on a secure network (USB or a Wi-Fi network you trust).
  2. 장치 포털의 "보안" 페이지에서 이 디바이스의 인증서를 다운로드합니다.Download this device's certificate from the "Security" page on the Device Portal.
    • https://<YOUR_HOLOLENS_IP_ADDRESS>/devicepair.htm으로 이동합니다.Navigate to: https://<YOUR_HOLOLENS_IP_ADDRESS>/devicepair.htm
    • 시스템 > 기본 설정에 대한 노드를 엽니다.Open the node for System > Preferences.
    • "디바이스 보안"이 나올 때까지 아래로 스크롤하고 "이 디바이스의 인증서 다운로드" 단추를 클릭합니다.Scroll down to Device Security, click the "Download this device's certificate" button.
  3. PC의 "신뢰할 수 있는 루트 인증 기관" 저장소에 인증서를 설치합니다.Install the certificate in the "Trusted Root Certification Authorities" store on your PC.
    • Windows 메뉴에서 컴퓨터 인증서 관리를 입력하고 애플릿을 시작합니다.From the Windows menu, type: Manage Computer Certificates and start the applet.
    • 신뢰할 수 있는 루트 인증 기관 폴더를 확장합니다.Expand the Trusted Root Certification Authority folder.
    • 인증서 폴더를 클릭합니다.Click the Certificates folder.
    • 작업 메뉴에서 모든 작업 > 가져오기...를 선택합니다.From the Action menu, select: All Tasks > Import...
    • 디바이스 포털에서 다운로드한 인증서 파일을 사용하여 인증서 가져오기 마법사를 완료합니다.Complete the Certificate Import Wizard, using the certificate file you downloaded from the Device Portal.
  4. 브라우저를 다시 시작합니다.Restart the browser.

참고

이 인증서는 디바이스에서만 신뢰할 수 있으며, 디바이스가 플래시되면 사용자가 프로세스를 다시 진행해야 합니다.This certificate will only be trusted for the device and the user will have to go through the process again if the device is flashed.

디바이스 포털 페이지Device Portal Pages

Home

Microsoft HoloLens에 대한 Windows 장치 포털의 홈 페이지Windows Device Portal home page on Microsoft HoloLens
Microsoft HoloLens에 대한 Windows 장치 포털의 홈 페이지Windows Device Portal home page on Microsoft HoloLens

홈페이지에서 디바이스 포털 세션을 시작합니다.Your Device Portal session starts at the Home page. 홈페이지의 왼쪽 탐색 모음에서 다른 페이지에 액세스합니다.Access other pages from the navigation bar along the left side of the home page.

페이지 맨 위에 있는 도구 모음에서 자주 사용하는 상태 및 기능에 대한 액세스를 제공합니다.The toolbar at the top of the page provides access to commonly used status and features.

  • 온라인: 디바이스가 Wi-Fi에 연결되어 있는지 여부를 나타냅니다.Online: Indicates whether the device is connected to Wi-Fi.
  • 종료: 디바이스를 끕니다.Shutdown: Turns off the device.
  • 다시 시작: 디바이스를 하드 부팅합니다.Restart: Cycles power on the device.
  • 보안: 디바이스 보안 페이지를 엽니다.Security: Opens the Device Security page.
  • 냉각: 디바이스의 온도를 나타냅니다.Cool: Indicates the temperature of the device.
  • A/C: 디바이스가 연결되어 있고 충전 중인지 여부를 나타냅니다.A/C: Indicates whether the device is plugged in and charging.
  • 도움말: REST 인터페이스 설명서 페이지를 엽니다.Help: Opens the REST interface documentation page.

홈페이지에는 다음 정보가 표시됩니다.The home page shows the following info:

  • 디바이스 상태: 디바이스의 상태를 모니터링하고 중요한 오류를 보고합니다.Device Status: monitors the health of your device and reports critical errors.
  • Windows 정보: HoloLens 이름과 현재 설치된 Windows 버전을 보여줍니다.Windows information: shows the name of the HoloLens and the currently installed version of Windows.
  • 기본 설정 섹션에는 다음 설정이 포함되어 있습니다.Preferences section contains the following settings:
    • IPD: 앞을 똑바로 바라볼 때 사용자의 동공 중심 사이의 거리인 IPD(동공 간 거리)를 밀리미터 단위로 설정합니다.IPD: Sets the interpupillary distance (IPD), which is the distance, in millimeters, between the center of the user's pupils when looking straight ahead. 설정은 즉시 적용됩니다.The setting takes effect immediately. 기본값은 디바이스를 설정할 때 자동으로 계산되었습니다.The default value was calculated automatically when you set up your device.
    • 디바이스 이름: HoloLens에 이름을 할당합니다.Device name: Assign a name to the HoloLens. 이 값을 변경 후에는 디바이스를 다시 부팅해야 적용됩니다.You must reboot the device after changing this value for it to take effect. 저장을 클릭한 후 디바이스를 즉시 다시 부팅할 것인지 또는 나중에 다시 부팅할 것인지를 묻는 대화 상자가 나타납니다.After clicking Save, a dialog will ask if you want to reboot the device immediately or reboot later.
    • 절전 설정: 디바이스가 전원에 연결된 경우 및 배터리에 연결된 경우에 각각 절전 모드로 전환되기 전에 대기할 시간을 설정합니다.Sleep settings: Sets the length of time to wait before the device goes to sleep when it's plugged in and when it's on battery.

3D 뷰3D View

Microsoft HoloLens에 대한 Windows 장치 포털의 3D 뷰 페이지3D View page in Windows Device Portal on Microsoft HoloLens
Microsoft HoloLens에 대한 Windows 장치 포털의 3D 뷰 페이지3D View page in Windows Device Portal on Microsoft HoloLens

3D 뷰 페이지를 사용하여 HoloLens가 사용자의 주변을 해석하는 방법을 확인합니다.Use the 3D View page to see how HoloLens interprets your surroundings. 마우스를 사용하여 뷰를 탐색합니다.Navigate the view by using the mouse:

  • 회전: 왼쪽 단추 클릭 + 마우스Rotate: left click + mouse;
  • 이동: 오른쪽 단추 클릭 + 마우스Pan: right click + mouse;
  • 확대/축소: 마우스 스크롤Zoom: mouse scroll.
  • 추적 옵션Tracking options
    • 강제 시각적 추적을 선택하여 연속 시각적 추적을 켭니다.Turn on continuous visual tracking by checking Force visual tracking.
    • 일시 중지는 시각적 추적을 중지합니다.Pause stops visual tracking.
  • 보기 옵션: 3D 뷰의 옵션을 설정합니다.View options: Set options on the 3D view:
    • 추적: 시각적 추적이 활성 상태인지 여부를 나타냅니다.Tracking: Indicates whether visual tracking is active.
    • 바닥 표시: 체크무늬 바닥 평면을 표시합니다.Show floor: Displays a checkered floor plane.
    • 절두체 표시: 절두체 보기를 표시합니다.Show frustum: Displays the view frustum.
    • 보정 평면 표시: HoloLens가 동작을 안정화하는 데 사용하는 평면을 표시합니다.Show stabilization plane: Displays the plane that HoloLens uses for stabilizing motion.
    • 메시 표시: 사용자의 주변을 나타내는 공간 매핑 메시를 표시합니다.Show mesh: Displays the spatial mapping mesh that represents your surroundings.
    • 공간 앵커 표시: 활성 앱의 공간 앵커를 표시합니다.Show spatial anchors: Displays spatial anchors for the active app. 업데이트 단추를 클릭하여 앵커를 가져오고 새로 고쳐야 합니다.You must click the Update button to get and refresh the anchors.
    • 자세한 정보 표시: 실시간으로 바뀌는 손 위치, 머리 회전 사원수 및 디바이스 원점 벡터를 표시합니다.Show details: Displays hand positions, head rotation quaternions, and the device origin vector as they change in real time.
    • 전체 화면 단추: 3D 뷰를 전체 화면 모드로 표시합니다.Full screen button: Shows the 3D View in full screen mode. 전체 화면 보기를 종료하려면 ESC 키를 누릅니다.Press ESC to exit full screen view.
  • 표면 재구성: 업데이트를 클릭 또는 탭하여 디바이스에서 최신 공간 매핑 메시를 표시합니다.Surface reconstruction: Click or tap Update to display the latest spatial mapping mesh from the device. 전체 단계를 완료하는 데 시간이 최대 몇 초 걸릴 수 있습니다.A full pass may take some time to complete (up to a few seconds). 메시는 3D 뷰에서 자동으로 업데이트되지 않으며, 디바이스에서 수동으로 업데이트를 클릭해야만 최신 메시를 얻을 수 있습니다.The mesh does not update automatically in the 3D view, and you must manually click Update to get the latest mesh from the device. 저장을 클릭하여 현재 공간 매핑 메시를 PC에서 obj 파일로 저장합니다.Click Save to save the current spatial mapping mesh as an obj file on your PC.
  • 공간 앵커: 업데이트를 클릭하여 활성 앱의 공간 앵커를 표시하거나 업데이트합니다.Spatial anchors: Click Update to display or update the spatial anchors for the active app.

맵 관리자Map Manager

맵 관리자를 사용하면 디바이스 간에 맵을 공유할 수 있으며, 위치 기반 엔터테인먼트 고객에 대한 공유 환경을 설정하는 데 사용할 수 있습니다.Map Manager allows you to share maps across devices, which can be used to setup shared experiences for Location Based Entertainment customers. 이 도구를 사용하여 시스템 맵 및 앵커를 가져오고 내보낼 수 있습니다.The tool allows you to import and export system maps and anchors.

맵 관리자에 액세스하려면 장치 포털에 로그인하고, Mixed Reality -> 맵 관리자를 차례로 선택합니다.To access the Map Manager, log into the Device Portal and select Mixed Reality -> Map Manager:

Windows 장치 포털의 맵 관리자 페이지 Microsoft HoloLens에 있는 Windows 장치 포털의 맵 관리자 페이지Map manager page in Windows Device Portal Map Manager page in Windows Device Portal on Microsoft HoloLens

맵 내보내기 및 가져오기Exporting and importing maps

맵을 내보내려면 시스템 맵 및 앵커 내보내기를 클릭합니다.To export maps, click Export System Map & Anchors. 이 경우 시간이 좀 걸릴 수 있으므로 맵을 내보내는 동안 30~60초 동안 기다리도록 준비합니다.This could take a while so be prepared to wait for 30-60 seconds while the map is exported. 완료되면 브라우저에서 파일이 다운로드됩니다.Once it’s complete, the file will be downloaded in your browser.

맵과 앵커를 가져오려면 맵 파일 업로드앵커 파일 업로드를 각각 클릭하고, 이미 내보낸 맵 또는 앵커 파일을 선택합니다.To import maps and anchors, click Upload a map file and Upload an anchor file respectively and select a map or anchor file that you've already exported. 업로드된 맵 또는 앵커 파일은 사용자 또는 다른 HoloLens 디바이스에서 가져올 수 있습니다.The uploaded map or anchor file can come from your or any other HoloLens device.

참고

HoloLens에서는 공간 매핑 데이터베이스를 가져오고 내보낼 수도 있습니다.On HoloLens, it's also possible to import and export the spatial mapping data base. 그러나 이 데이터베이스는 HoloLens 이외의 디바이스에서 작동하지 않습니다.However, this doesn't work on non-HoloLens devices.

혼합 현실 캡처Mixed Reality Capture

Microsoft HoloLens에 대한 Windows 장치 포털의 혼합 현실 캡처 페이지Mixed Reality Capture page in Windows Device Portal on Microsoft HoloLens
Microsoft HoloLens에 대한 Windows 장치 포털의 혼합 현실 캡처 페이지Mixed Reality Capture page in Windows Device Portal on Microsoft HoloLens

혼합 현실 캡처 페이지를 사용하여 HoloLens에서 미디어 스트림을 저장합니다.Use the Mixed Reality Capture page to save media streams from the HoloLens.

  • 캡처 설정: 다음 설정을 확인하여 캡처할 미디어 스트림을 제어합니다.Capture Settings: Control the media streams that are captured by checking the following settings:
    • 홀로그램: 비디오 스트림에서 홀로그램 콘텐츠를 캡처합니다.Holograms: Captures the holographic content in the video stream. 홀로그램은 스테레오가 아닌 모노로 렌더링됩니다.Holograms are rendered in mono, not stereo.
    • PV 카메라: 사진/비디오 카메라에서 비디오 스트림을 캡처합니다.PV camera: Captures the video stream from the photo/video camera.
    • 마이크 오디오: 마이크 배열에서 오디오를 캡처합니다.Mic Audio: Captures audio from the microphone array.
    • 앱 오디오: 현재 실행 중인 앱에서 오디오를 캡처합니다.App Audio: Captures audio from the currently running app.
    • 카메라에서 렌더링: 실행 중인 앱에서 지원할 경우 캡처본을 사진/비디오 카메라 관점이 되도록 조정합니다(HoloLens 2만 해당).Render from Camera: Aligns the capture to be from the perspective of the photo/video camera, if supported by the running app (HoloLens 2 only).
    • 실시간 미리 보기 품질: 실시간 미리 보기의 화면 해상도, 프레임 속도 및 스트리밍 속도를 선택합니다.Live preview quality: Select the screen resolution, frame rate, and streaming rate for the live preview.
  • 오디오 설정(HoloLens 2만 해당):Audio Settings (HoloLens 2 only):
    • 오디오 미디어 범주: 마이크를 처리할 때 사용되는 범주를 선택합니다.Audio Media Category: Select the category is used when processing the microphone. 기본에는 일부 환경이 포함되지만 통신은 백그라운드 노이즈 취소를 적용합니다.Default will include some of the environment whereas Communications applies background noise cancellation.
    • 앱 오디오 게인: 앱 오디오의 볼륨에 적용되는 게인입니다.App Audio Gain: The gain applied to app audio's volume.
    • 마이크 오디오 게인: 마이크 오디오의 볼륨에 적용되는 게인입니다.Mic Audio Gain: The gain applied to mic audio's volume.
  • 사진 및 비디오 설정(HoloLens 2, 버전 2004 이상):Photo and Video Settings (HoloLens 2, version 2004 or later):
    • 캡처 프로필: 사진과 비디오를 촬영할 때 사용할 프로필을 선택합니다.Capture Profile: Select the profile used when taking photos and videos. 프로필은 사용할 수 있는 해상도와 프레임 비율을 결정합니다.The profile determines which resolutions and frame-rates are available.
    • 사진 해상도: 사진을 촬영하는 해상도입니다.Photo Resolution: The resolution the photo will be taken with.
    • 비디오 해상도 및 프레임 비율: 촬영하는 비디오의 해상도와 프레임 비율입니다.Video Resolution and Frame-rate: The resolution and frame-rate the video will be taken with.
    • 비디오 안정화 버퍼: 비디오를 촬영할 때 사용되는 버퍼 크기입니다.Video Stabilization Buffer: The buffer size used when taking a video. 값이 클수록 빠른 움직임에 맞게 보정할 수 있습니다.The higher the value, the better it can compensate for quick movements.
  • 실시간 미리 보기 단추를 클릭 또는 탭하여 캡처 스트림을 표시합니다.Click or tap the Live preview button to show the capture stream. 실시간 미리 보기 중지는 캡처 스트림을 중지합니다.Stop live preview stops the capture stream.
  • 녹화를 클릭 또는 탭하여 지정된 설정을 사용해 혼합 현실 스트림의 녹화를 시작합니다.Click or tap Record to start recording the mixed-reality stream, using the specified settings. 녹화 정지는 녹화를 끝내고 저장합니다.Stop recording ends the recording and saves it.
  • 사진 촬영을 클릭 또는 탭하여 캡처 스트림에서 정지 이미지를 촬영합니다.Click or tap Take photo to take a still image from the capture stream.
  • 기본 설정 복원을 클릭하거나 탭하여 오디오, 사진 및 비디오 설정에 기본 설정을 복원합니다.Click or tap Restore Default Settings to restore the default settings for audio, photo, and video settings.
  • 비디오 및 사진: 디바이스에서 촬영한 비디오 및 사진 캡처 목록을 표시합니다.Videos and photos: Shows a list of video and photo captures taken on the device.

이 페이지의 모든 설정은 Windows 장치 포털을 사용하는 캡처에 적용되지만 일부는 추가적으로 시스템 MRC(시작 메뉴, 하드웨어 단추, 글로벌 음성 명령, Miracast) 및 사용자 지정 MRC 레코더에 적용됩니다.All settings on this page apply to captures taken using Windows Device Portal, but some additionally apply to System MRC (start menu, hardware buttons, global voice commands, Miracast) and to custom MRC Recorders.

설정Setting 시스템 MRC에 적용Applies to System MRC 사용자 지정 MRC 레코더에 적용Applies to Custom MRC Recorders
홀로그램Holograms 아니요No 아니요No
PV 카메라PV camera 아니요No 아니요No
마이크 오디오Mic Audio 아니요No 아니요No
앱 오디오App Audio 아니요No 아니요No
카메라에서 렌더링Render from Camera Yes 예(재정의할 수 있음)Yes (can be overridden)
실시간 미리 보기 품질Live preview quality 아니요No 아니요No
오디오 미디어 범주Audio Media Category Yes 아니요No
앱 오디오 게인App Audio Gain Yes 예(재정의할 수 있음)Yes (can be overridden)
마이크 오디오 게인Mic Audio Gain Yes 예(재정의할 수 있음)Yes (can be overridden)
캡처 프로필Capture Profile Yes 아니요No
사진 해상도Photo Resolution Yes 아니요No
비디오 해상도 및 프레임 비율Video Resolution and Frame-rate Yes 아니요No
비디오 안정화 버퍼Video Stabilization Buffer Yes 예(재정의할 수 있음)Yes (can be overridden)

참고

동시 MRC에 대한 제한 사항이 있습니다.There are limitations to simultaneous MRC:

  • Windows 장치 포털이 비디오를 녹화하는 동안 앱에서 사진/비디오 카메라에 액세스하려고 하면 비디오 녹화가 중지됩니다.If an app tries to access the photo/video camera while Windows Device Portal is recording a video, the video recording will stop.
    • 앱이 SharedReadOnly 모드를 사용하여 사진/비디오 카메라에 액세스하는 경우 HoloLens 2는 비디오 녹화를 중지하지 않습니다.HoloLens 2 will not stop recording video if the app accesses the photo/video camera with SharedReadOnly mode.
  • 앱이 현재 사진/비디오 카메라를 사용하는 경우 Windows 장치 포털에서 사진을 촬영하거나 비디오를 녹화할 수 있습니다.If an app is actively using the photo/video camera, Windows Device Portal is able to take a photo or record a video.
  • 라이브 스트리밍:Live streaming:
    • HoloLens(1세대)는 Windows 장치 포털에서 라이브 스트리밍 중에 앱이 사진/비디오 카메라에 액세스하지 못하도록 합니다.HoloLens (1st gen) prevents an app from accessing the photo/video camera while live streaming from Windows Device Portal.
    • HoloLens(1세대)는 앱이 현재 사진/비디오 카메라를 사용하는 경우 라이브 스트리밍에 실패합니다.HoloLens (1st gen) will fail to live stream if an app is actively using the photo/video camera.
    • HoloLens 2는 앱이 ExclusiveControl 모드에서 사진/비디오 카메라에 액세스하려고 하면 라이브 스트리밍을 자동으로 중지합니다.HoloLens 2 automatically stops live streaming when an app tries to access the photo/video camera in ExclusiveControl mode.
    • HoloLens 2는 앱이 현재 PV 카메라를 사용 중인 경우 라이브 스트림을 시작할 수 있습니다.HoloLens 2 is able to start a live stream while an app is actively using the PV camera.

성능 추적Performance Tracing

Microsoft HoloLens에 대한 Windows 장치 포털의 성능 추적 페이지Performance Tracing page in Windows Device Portal on Microsoft HoloLens
Microsoft HoloLens에 대한 Windows 장치 포털의 성능 추적 페이지Performance Tracing page in Windows Device Portal on Microsoft HoloLens

HoloLens에서 WPR(Windows Performance Recorder) 추적을 캡처합니다.Capture Windows Performance Recorder (WPR) traces from your HoloLens.

  • 사용 가능한 프로필: 드롭다운 목록에서 WPR 프로필을 선택하고 시작을 클릭 또는 탭하여 추적을 시작합니다.Available profiles: Select the WPR profile from the dropdown, and click or tap Start to start tracing.
  • 사용자 지정 프로필: PC에서 WPR 프로필을 선택하려면 찾아보기를 클릭 또는 탭합니다.Custom profiles: Click or tap Browse to choose a WPR profile from your PC. 추적을 시작하려면 업로드 및 시작을 클릭 또는 탭합니다.Click or tap Upload and start to start tracing.

추적을 중지하려면 중지 링크를 클릭합니다.To stop the trace, click the stop link. 추적 파일이 다운로드를 완료할 때까지 이 페이지에 계속 있습니다.Stay on this page until the trace file has completed downloading.

캡처된 ETL 파일은 Windows Performance Analyzer에서 분석을 위해 열 수 있습니다.Captured ETL files can be opened for analysis in Windows Performance Analyzer.

프로세스Processes

Microsoft HoloLens에 대한 Windows 장치 포털의 프로세스 페이지Processes page in Windows Device Portal on Microsoft HoloLens
Microsoft HoloLens에 대한 Windows 장치 포털의 프로세스 페이지Processes page in Windows Device Portal on Microsoft HoloLens

현재 실행 중인 프로세스에 대한 세부 정보를 보여 줍니다.Shows details about currently running processes. 앱 및 시스템 프로세스 모두 포함합니다.This includes both apps and system processes.

시스템 성능System Performance

Microsoft HoloLens에 대한 Windows 장치 포털의 시스템 성능 페이지System Performance page in Windows Device Portal on Microsoft HoloLens
Microsoft HoloLens에 대한 Windows 장치 포털의 시스템 성능 페이지System Performance page in Windows Device Portal on Microsoft HoloLens

전력 사용량, 프레임 속도 및 CPU 로드와 같은 시스템 진단 정보를 실시간 그래프로 보여 줍니다.Shows real-time graphs of system diagnostic info, like power usage, frame rate, and CPU load.

사용 가능한 메트릭은 다음과 같습니다.These are the available metrics:

  • SoC 전원: 1분 평균 순간 시스템 온칩 전력 사용률SoC power: Instantaneous system-on-chip power utilization, averaged over one minute
  • 시스템 전원: 1분 평균 순간 시스템 전력 사용률System power: Instantaneous system power utilization, averaged over one minute
  • 프레임 속도: 초당 프레임, 초당 누락 VBlank 및 연속 누락 VBlankFrame rate: Frames per second, missed VBlanks per second, and consecutive missed VBlanks
  • GPU: GPU 엔진 사용률(사용 가능한 총 전원 대비 백분율)GPU: GPU engine utilization, percent of total available
  • CPU: 사용 가능한 총 전원 대비 백분율CPU: percent of total available
  • I/O: 읽기 및 쓰기I/O: Reads and writes
  • 네트워크: 수신 및 전송Network: Received and sent
  • 메모리: 전체, 사용 중, 약정, 페이징 및 비페이징 메모리Memory: Total, in use, committed, paged, and non-paged

Apps

Microsoft HoloLens에 대한 Windows 장치 포털의 앱 페이지Apps page in Windows Device Portal on Microsoft HoloLens
Microsoft HoloLens에 대한 Windows 장치 포털의 앱 페이지Apps page in Windows Device Portal on Microsoft HoloLens

HoloLens에 설치된 앱을 관리합니다.Manages the apps that are installed on the HoloLens.

  • 설치된 앱: 앱을 제거하고 시작합니다.Installed apps: Remove and start apps.
  • 실행 중인 앱: 현재 실행 중인 앱을 나열합니다.Running apps: Lists apps that are running currently.
  • 앱 설치: 컴퓨터/네트워크 폴더에서 설치할 앱 패키지를 선택합니다.Install app: Select app packages for installation from a folder on your computer/network.
  • 종속성: 설치하려는 앱에 대한 종속성을 추가합니다.Dependency: Add dependencies for the app you are going to install.
  • 배포: 선택한 앱 + 종속성을 HoloLens에 배포합니다.Deploy: Deploy the selected app + dependencies to the HoloLens.

앱 크래시 덤프App Crash Dumps

Microsoft HoloLens에 대한 Windows 장치 포털의 앱 크래시 덤프 페이지App Crash Dumps page in Windows Device Portal on Microsoft HoloLens
Microsoft HoloLens에 대한 Windows 장치 포털의 앱 크래시 덤프 페이지App Crash Dumps page in Windows Device Portal on Microsoft HoloLens

이 페이지에서는 테스트용으로 로드된 앱에 대한 크래시 덤프를 수집할 수 있습니다.This page allows you to collect crash dumps for your side-loaded apps. 크래시 덤프를 수집하려는 각 앱에 대해 크래시 덤프 사용 확인란을 선택합니다.Check the Crash Dumps Enabled checkbox for each app for which you want to collect crash dumps. 이 페이지로 돌아와서 크래시 덤프를 수집합니다.Return to this page to collect crash dumps. 덤프 파일은 디버깅을 위해 Visual Studio에서 열릴 수 있습니다.Dump files can be opened in Visual Studio for debugging.

파일 탐색기File Explorer

Microsoft HoloLens에 대한 Windows 장치 포털의 파일 탐색기 페이지File Explorer page in Windows Device Portal on Microsoft HoloLens
Microsoft HoloLens에 대한 Windows 장치 포털의 파일 탐색기 페이지File Explorer page in Windows Device Portal on Microsoft HoloLens

파일 탐색기를 사용하여 파일을 찾아보고, 업로드하고, 다운로드합니다.Use the file explorer to browse, upload, and download files. 문서 폴더, 그림 폴더 및 Visual Studio 또는 장치 포털에서 배포한 앱에 대한 로컬 스토리지 폴더의 파일을 사용할 수 있습니다.You can work with files in the Documents folder, Pictures folder, and in the local storage folders for apps that you deployed from Visual Studio or the Device Portal.

키오스크 모드Kiosk Mode

참고

키오스크 모드는 Microsoft HoloLens Commercial Suite에서만 사용할 수 있습니다.Kiosk mode is only available with the Microsoft HoloLens Commercial Suite.

Microsoft HoloLens에 있는 Windows 장치 포털의 키오스크 모드 페이지

Windows 장치 포털을 통해 키오스크 모드를 사용하도록 설정하는 방법에 대한 최신 지침은 Windows IT 전문가 센터의 키오스크 모드로 HoloLens 설정 문서를 확인하세요.Check the Set up HoloLens in kiosk mode article in Windows IT Pro Center for up-to-date instructions on enabling kiosk mode via Windows Device Portal.

로깅Logging

Microsoft HoloLens에 대한 Windows 장치 포털의 로깅 페이지Logging page in Windows Device Portal on Microsoft HoloLens
Microsoft HoloLens에 대한 Windows 장치 포털의 로깅 페이지Logging page in Windows Device Portal on Microsoft HoloLens

HoloLens에서 실시간 ETW(Windows용 이벤트 추적)를 관리합니다.Manages realtime Event Tracing for Windows (ETW) on the HoloLens.

이벤트 목록만 표시하려면 공급자 숨기기를 선택합니다.Check Hide providers to show the Events list only.

  • 등록된 공급자: ETW 공급자와 추적 수준을 선택합니다.Registered providers: Select the ETW provider and the tracing level. 추적 수준은 다음 값 중 하나입니다.Tracing level is one of these values:
    1. 비정상적인 끝내기 또는 종료Abnormal exit or termination
    2. 심각한 오류Severe errors
    3. 경고Warnings
    4. 오류가 아닌 경고Non-error warnings

추적을 시작하려면 사용을 클릭 또는 탭합니다.Click or tap Enable to start tracing. 공급자가 활성화된 공급자 드롭다운에 추가됩니다.The provider is added to the Enabled Providers dropdown.

  • 사용자 지정 공급자: 사용자 지정 ETW 공급자와 추적 수준을 선택합니다.Custom providers: Select a custom ETW provider and the tracing level. 공급자를 GUID로 식별합니다.Identify the provider by its GUID. GUID에 대괄호를 포함하지 마세요.Don't include brackets in the GUID.
  • 활성화된 공급자: 활성화된 공급자를 나열합니다.Enabled providers: Lists the enabled providers. 추적을 중지하려면 드롭다운에서 공급자를 선택하고 사용 안 함을 클릭 또는 탭합니다.Select a provider from the dropdown and click or tap Disable to stop tracing. 모든 추적을 일시 중단하려면 모두 중지를 클릭 또는 탭합니다.Click or tap Stop all to suspend all tracing.
  • 공급자 기록: 현재 세션 중 활성화된 ETW 공급자를 보여줍니다.Providers history: Shows the ETW providers that were enabled during the current session. 비활성화된 공급자를 활성화하려면 사용을 클릭 또는 탭합니다.Click or tap Enable to activate a provider that was disabled. 기록을 지우려면 지우기를 클릭 또는 탭합니다.Click or tap Clear to clear the history.
  • 이벤트: 선택된 공급자의 ETW 이벤트를 표 형식으로 나열합니다.Events: Lists ETW events from the selected providers in table format. 이 표는 실시간으로 업데이트됩니다.This table is updated in real time. 모든 ETW 이벤트를 표에서 삭제하려면 표 아래에 있는 지우기 단추를 클릭합니다.Beneath the table, click the Clear button to delete all ETW events from the table. 이렇게 해도 공급자는 비활성화되지 않습니다.This does not disable any providers. 파일로 저장을 클릭하여 현재 수집된 ETW 이벤트를 CSV 파일에 로컬로 내보낼 수 있습니다.You can click Save to file to export the currently collected ETW events to a CSV file locally.
  • 필터: 수집된 ETW 이벤트를 ID, 키워드, 수준, 공급자 이름, 작업 이름 또는 텍스트로 필터링할 수 있습니다.Filters: Allow you to filter the ETW events collected by ID, Keyword, Level, Provider Name, Task Name, or Text. 여러 조건을 함께 결합할 수 있습니다.You can combine several criteria together:
    1. 동일한 속성에 적용되는 조건의 경우 이러한 조건 중 하나라도 만족하는 이벤트가 표시됩니다.For criteria applying to the same property, events that can satisfy any one of these criteria are shown.
    2. 다른 속성에 적용되는 조건의 경우 이벤트가 모든 조건을 충족해야 합니다.For criteria applying to a different property, events must satisfy all of the criteria

예를 들어 (Task Name contains 'Foo' or 'Bar') AND (Text contains 'error' or 'warning') 기준을 지정할 수 있습니다.For example, you can specify the criteria (Task Name contains 'Foo' or 'Bar') AND (Text contains 'error' or 'warning')

SimulationSimulation

Microsoft HoloLens에 대한 Windows 장치 포털의 시뮬레이션 페이지Simulation page in Windows Device Portal on Microsoft HoloLens
Microsoft HoloLens에 대한 Windows 장치 포털의 시뮬레이션 페이지Simulation page in Windows Device Portal on Microsoft HoloLens

테스트를 위해 입력 데이터를 기록 및 재생할 수 있습니다.Allows you to record and play back input data for testing.

  • 공간 캡처: 사용자의 주변에 대한 공간 매핑 메시를 포함하는 시뮬레이트된 공간 파일을 다운로드하는 데 사용됩니다.Capture room: Used to download a simulated room file that contains the spatial mapping mesh for the user's surroundings. 공간의 이름을 지정한 다음, 캡처를 클릭하여 PC에 .xef 파일로 데이터를 저장합니다.Name the room and then click Capture to save the data as a .xef file on your PC. 이 공간 파일을 HoloLens 에뮬레이터에 로드할 수 있습니다.This room file can be loaded into the HoloLens emulator.
  • 녹화: 녹화할 스트림을 선택하고 녹화본의 이름을 지정하고 녹화를 클릭 또는 탭하여 녹화를 시작합니다.Recording: Check the streams to record, name the recording, and click or tap Record to start recoding. HoloLens를 사용하여 작업을 수행한 다음, 중지를 클릭하여 PC에 .xef 파일로 데이터를 저장합니다.Perform actions with your HoloLens and then click Stop to save the data as a .xef file on your PC. 이 파일을 HoloLens 에뮬레이터 또는 디바이스에 로드할 수 있습니다.This file can be loaded on the HoloLens emulator or device.
  • 재생: 녹화본 업로드를 클릭 또는 탭하여 PC에서 xef 파일을 선택하고 HoloLens에 데이터를 보냅니다.Playback: Click or tap Upload recording to select a xef file from your PC and send the data to the HoloLens.
  • 제어 모드: 드롭다운 목록에서 기본 또는 시뮬레이션을 선택하고 설정 단추를 클릭 또는 탭하여 HoloLens의 모드를 선택합니다.Control mode: Select Default or Simulation from the dropdown, and click or tap the Set button to select the mode on the HoloLens. "시뮬레이션"을 선택하면 HoloLens의 실제 센서를 사용할 수 없고 대신 업로드한 시뮬레이트된 데이터를 사용합니다.Choosing "Simulation" disables the real sensors on your HoloLens and uses uploaded simulated data instead. "시뮬레이션"으로 전환하면 HoloLens가 "기본"으로 다시 전환될 때까지 실제 사용자에게 응답하지 않습니다.If you switch to "Simulation", your HoloLens will not respond to the real user until you switch back to "Default".

네트워킹Networking

Microsoft HoloLens에 대한 Windows 장치 포털의 네트워킹 페이지Networking page in Windows Device Portal on Microsoft HoloLens
Microsoft HoloLens에 대한 Windows 장치 포털의 네트워킹 페이지Networking page in Windows Device Portal on Microsoft HoloLens

HoloLens에서 Wi-Fi 연결을 관리합니다.Manages Wi-Fi connections on the HoloLens.

  • WiFi 어댑터: 드롭다운 컨트롤을 사용하여 Wi-Fi 어댑터 및 프로필을 선택합니다.WiFi adapters: Select a Wi-Fi adapter and profile by using the dropdown controls. 연결을 클릭하거나 탭하여 선택한 어댑터를 사용합니다.Click or tap Connect to use the selected adapter.
  • 사용 가능한 네트워크: HoloLens가 연결할 수 있는 Wi-Fi 네트워크를 나열합니다.Available networks: Lists the Wi-Fi networks that the HoloLens can connect to. 목록을 업데이트하려면 새로 고침을 클릭하거나 탭합니다.Click or tap Refresh to update the list.
  • IP 구성: 네트워크 연결의 IP 주소 및 기타 세부 정보를 표시합니다.IP configuration: Shows the IP address and other details of the network connection.

가상 입력Virtual Input

Microsoft HoloLens에 대한 Windows 장치 포털의 가상 입력 페이지Virtual Input page in Windows Device Portal on Microsoft HoloLens
Microsoft HoloLens에 대한 Windows 장치 포털의 가상 입력 페이지Virtual Input page in Windows Device Portal on Microsoft HoloLens

원격 컴퓨터에서 HoloLens에 키보드 입력을 보냅니다.Sends keyboard input from the remote machine to the HoloLens.

가상 키보드 아래 영역을 클릭 또는 탭하여 HoloLens에 키 입력 전송을 사용합니다.Click or tap the region under Virtual keyboard to enable sending keystrokes to the HoloLens. 입력 텍스트 텍스트 상자에 입력하고 보내기를 클릭 또는 탭하여 활성 앱에 키 입력을 보냅니다.Type in the Input text textbox and click or tap Send to send the keystrokes to the active app.

장치 포털 REST APIDevice Portal REST API's

장치 포털의 모든 작업은 데이터에 액세스하고 디바이스를 프로그래밍 방식으로 제어할 때 선택적으로 사용할 수 있는 REST API를 기반으로 합니다.Everything in the device portal is built on top of REST API's that you can optionally use to access the data and control your device programmatically.

문제 해결Troubleshooting

"It's lonely here(비어 있습니다)" 메시지를 수정하는 방법How to fix the "It's lonely here" message

참고

HoloLens 2에서 HoloLens(1세대)로 이동하면 HoloLens(1세대)에서 사용하기 전에 HoloLens 2에서 사용할 경우 페이지가 비어질 수 있습니다.Going from a HoloLens 2 to HoloLens (1st gen) may cause the pages to become lonely if used on the HoloLens 2 prior to use on the HoloLens (1st gen).

장치 포털 페이지의 It's lonely here(비어 있습니다)

  1. 왼쪽 위 메뉴에서 레이아웃 다시 설정을 선택합니다.Select Reset layout from the top-left Menu:

장치 포털 메뉴에서 레이아웃 다시 설정 선택

  1. 작업 영역 다시 설정 머리글 아래에서 레이아웃 다시 설정을 클릭합니다.Click Reset layout under the Reset workspace heading. 포털 페이지는 자동으로 콘텐츠를 새로 고치고 표시합니다.The portal page will automatically refresh and display your content.

작업 영역 다시 설정 페이지에서 레이아웃 다시 설정 선택