기술 자료

Unity 엔진

Unity 엔진

Android 애플리케이션에 Unity 통합

Unity 런타임 라이브러리를 Android 애플리케이션에 통합하는 방법을 설명합니다.
읽는 시간 2분최근 업데이트: 9일 전

이 페이지에서는 Unity as a Library 기능을 사용하여 Unity 런타임 라이브러리를 Android 애플리케이션에 통합하는 방법을 설명합니다.
이 기능을 사용하여 3D/2D 실시간 렌더링, AR 경험, 3D 모델 상호 작용 또는 2D 미니 게임과 같은 Unity 기반 기능을 애플리케이션에 포함할 수 있습니다. Unity 런타임 라이브러리는 애플리케이션 내에서 콘텐츠를 로드, 활성화 및 언로드할 시기와 방법을 관리하는 컨트롤을 공개합니다.
중요
프로젝트에 Unity as a Library를 도입하려면 네이티브 및 관리되는 플러그인을 Android에서 올바르게 작동하도록 조정해야 할 수 있습니다. Gradle 매니페스트를 변경하는 플러그인은 네이티브 iOS/Android 앱에서 Unity를 라이브러리로 사용에 설명된 Gradle 변경 사항을 사용해야 합니다.

자세히 알아보기

Unity Gradle 프로젝트를 빌드할 때는 다른 작업을 수행할 필요가 없습니다.
Unity가 생성하는 모든 Android Gradle 프로젝트의 구조는 다음과 같습니다.
  • 다른 Gradle 프로젝트에 통합할 수 있는 unityLibrary 모듈의 라이브러리 파트입니다. 여기에는 Unity 런타임 및 플레이어 데이터가 포함되어 있습니다.
  • 애플리케이션 이름과 해당 아이콘이 포함된 런처 모듈의 가상 런처 부분입니다. Unity 실행하는 간단한 Android 애플리케이션입니다. 이 모듈을 자체 애플리케이션으로 교체할 수 있습니다.
Unity를 다른 Android Gradle 프로젝트에 통합하려면 생성된 Android Gradle 프로젝트의 unityLibrary 모듈을 settings. Gradle 파일을 통해 Android Unity 프로젝트에 포함해야 합니다.
이 저장소에는 Unity를 Android 앱에 통합하는 방법을 보여주는 프로젝트 및 플러그인 예시와 추가 문서가 포함되어 있습니다.
플레이어를 제어하려면 Intent를 Relay Unity 활동을 실행하고 필요한 경우 이를 확장합니다. 자세한 내용은 Intents and Intent Filters에 대한 Android 개발자 문서를 참조하십시오. UnityPlayer Java API 사용할 수도 있습니다.

IUnityPlayerLifecycleEvents

IUnityPlayerLifecycleEvents는 Unity 플레이어 두 가지 중요한 라이프사이클 이벤트와 상호 작용할 수 있는 방법을 제공합니다.
  • 언로드 -
    Application.Unload
    또는
    UnityPlayer.unload()
    가 Unity 플레이어를 언로드할 때 애플리케이션이
    IUnityPlayerLifecycleEvents.onUnityPlayerUnloaded
    를 호출합니다. 이렇게 하면 Unity 플레이어 모든 씬을 언로드하지만 나머지는 메모리에 로드된 상태로 유지되는 일시 정지 상태가 됩니다.
  • 종료 - Unity 플레이어가 종료되면 애플리케이션이
    IUnityPlayerLifecycleEvents.onUnityPlayerQuitted
    를 호출합니다. Unity 실행 중인 프로세스는 호출 후 종료됩니다.
IUnityPlayerLifecycleEvents
의 인스턴스를 UnityPlayer 생성자로 전달하거나,
UnityPlayer
및
UnityPlayerActivity
의 서브 클래스에서 메서드를 오버라이드할 수 있습니다.

제한

Unity 런타임 라이프사이클을 제어하지 않으므로 Unity as a Library는 가능한 모든 사용 사례에서 작동하지 않을 수 있습니다. 알려진 제한 사항은 다음과 같습니다.
  • Unity as a Library는 전체 화면 렌더링만 지원합니다. 하지만 Unity Industry 고객이라면 제한 사항과 기능이 다를 수 있습니다.
  • Unity 런타임의 인스턴스를 둘 이상 로드하거나 통합할 수 없습니다.
  • Unity Runtime과 함께 작동하려면 타사 플러그인(네이티브 및 관리형 모두)을 조정해야 할 수 있습니다.
  • Unity as a Library는 Xamarin 앱 플랫폼과 호환되지 않습니다.
  • Unity 런타임 라이브러리를 동적 모듈로 플레이 기능 제공과 통합할 수 없습니다.

추가 리소스