Version: 2022.3
언어: 한국어
UWP 요구 사항 및 호환성
유니버설 Windows 플랫폼 시작하기

UWP 애플리케이션에 Unity 통합

Unity를 라이브러리로 사용하여 UWP(유니버설 Windows 플랫폼) 애플리케이션에 Unity 런타임 라이브러리를 통합할 수 있습니다.Unity 런타임 라이브러리는 API 컨트롤을 노출하여 다른 UWP 애플리케이션 안에 콘텐츠를 로드하고, 활성화하고, 언로드하는 시기와 방법을 관리합니다.

이러한 통합을 사용하면 다음과 같은 Unity 기반 기능을 UWP 애플리케이션에 포함할 수 있습니다.

  • 3D/2D 실시간 렌더링
  • AR 경험
  • 3D 모델 인터랙션
  • 2D 미니 게임

Unity 런타임 라이브러리를 UWP 애플리케이션에 통합하려면 다음 단계를 완료하십시오.

  1. File > Build Settings를 엽니다.
  2. Universal Windows Platform 탭에서 Build Type > XAML을 선택합니다.
  3. 프로젝트를 빌드합니다.

그 결과 Unity는 Unity 런타임 라이브러리를 다른 UWP 애플리케이션에 임베드하는 데 사용할 수 있는 Visual Studio 프로젝트를 생성합니다.이 프로젝트는 Unity 프로젝트를 로드하기 위한 SwapChainPanel 설정이 포함된 MainPage.xaml 파일 형식의 일반 XAML UWP 프로젝트입니다.이 프로젝트를 Unity가 아닌 다른 애플리케이션 비즈니스 로직으로 확장하거나 바꿀 수 있습니다.

참고:MainPage.xaml 파일은 Unity 에디터에서 XAML 빌드 타입을 사용하여 UWP 앱을 빌드하는 경우에만 존재합니다.

SwapchainPanel을 사용할 경우 Unity는 다른 요소 위에 렌더링합니다.이를 통해 Unity가 아닌 다른 애플리케이션 콘텐츠 위에 투명한 배경을 가진 작은 오브젝트를 렌더링할 수 있습니다.이렇게 하려면 PlayerSettings.WSA-transparentSwapchain 옵션을 활성화합니다.Unity가 Application.Unload를 사용하여 로드할 때 Unity 엔진을 언로드하여 리소스를 회수할 수 있습니다.

제한 사항

다른 애플리케이션을 사용하여 Unity 빌드를 호스팅하는 경우, Unity가 런타임 수명 주기를 컨트롤하지 않으므로 빌드가 작동하지 않을 수 있습니다.또한 다음 제한 사항에 대해서도 알고 있어야 합니다.

  • Unity 런타임의 인스턴스를 두 개 이상 로드하거나 통합할 수 없습니다.
  • 올바른 동작을 위해 네이티브관리되는 플러그인을 조정해야 할 수 있습니다.

추가 리소스

UWP 요구 사항 및 호환성
유니버설 Windows 플랫폼 시작하기