Version: 2021.3
언어: 한국어
Java 또는 Kotlin 소스 파일을 플러그인으로 사용
Android에서 딥 링크

Unity를 Android 애플리케이션에 통합

이 페이지에서는 Unity as a Library 기능을 사용하여 Unity 런타임 라이브러리를 Android 애플리케이션에 통합하는 방법을 설명합니다.

이 기능을 통해 3D/2D 실시간 렌더링, AR 경험, 3D 모델 상호작용, 2D 미니 게임 등과 같은 Unity 지원 기능을 애플리케이션에 포함할 수 있습니다. Unity 런타임 라이브러리는 애플리케이션 내에서 콘텐츠를 로드, 활성화 및 언로드하는 시기와 방법을 관리하는 컨트롤을 제공합니다.

중요: 프로젝트를 Unity 2019.4 이상으로 업그레이드하는 경우 Unity as a Library 도입 시 Android에서 올바르게 동작하도록 네이티브관리되는 플러그인을 조정해야 할 수 있습니다. Gradle 매니페스트를 변경하는 플러그인은 네이티브 iOS/Android 앱에서 Unity as a Library 사용에 설명된 Gradle 변경 사항을 사용해야 합니다.

작동 방식

Unity에서 Gradle 프로젝트를 빌드하는 경우 다르게 작업할 필요가 없습니다.

Unity가 생성하는 모든 Android Gradle 프로젝트의 구조는 다음과 같습니다.

  • 다른 Gradle 프로젝트에 통합할 수 있는 unityLibrary 모듈의 라이브러리 파트입니다. 여기에는 Unity 런타임과 플레이어 데이터가 포함됩니다.
  • 애플리케이션 이름과 해당 아이콘이 들어 있는 launcher 모듈의 씬 런처 파트입니다. Unity를 시작하는 간단한 Android 애플리케이션이며, 자체 애플리케이션으로 이 모듈을 대체할 수 있습니다.

Unity를 다른 Android Gradle 프로젝트에 통합하려면 생성된 Android Gradle 프로젝트의 unityLibrary 모듈을 settings.gradle 파일을 통해 Android Unity 프로젝트에 포함해야 합니다.

저장소는 Unity를 Android 앱에 통합하는 방법을 설명하는 예제 프로젝트와 플러그인을 상세한 문서와 함께 제공합니다.

플레이어를 제어하려면 Unity 활동의 시작 목적을 릴레이하고 필요한 경우 확장하십시오. 자세한 내용은 목적 및 목적 필터에 대한 Android 개발자 문서를 참조하십시오. 또한 UnityPlayer Java API를 사용할 수도 있습니다.

IUnityPlayerLifecycleEvents

IUnityPlayerLifecycleEvents는 Unity 플레이어의 두 가지 중요한 라이프사이클 이벤트와 상호작용하기 위한 수단을 제공합니다.

  • Unload - Application.Unload 또는 UnityPlayer.unload()가 Unity 플레이어를 언로드하면 애플리케이션이 IUnityPlayerLifecycleEvents.onUnityPlayerUnloaded를 호출합니다. 그러면 Unity 플레이어가 일시정지 상태가 되어 모든 씬을 언로드하지만, 다른 모든 요소는 메모리에 그대로 로드됩니다.
  • Quit - Unity 플레이어를 종료하면 애플리케이션이 IUnityPlayerLifecycleEvents.onUnityPlayerQuitted를 호출합니다. Unity를 실행 중이던 프로세스는 이 호출 후에 종료됩니다.

IUnityPlayerLifecycleEvents의 인스턴스를 UnityPlayer 생성자에 전달하거나, UnityPlayerUnityPlayerActivity의 서브 클래스에 있는 메서드를 오버라이드할 수 있습니다.

제한 사항

Unity는 런타임 라이프사이클을 제어하지 않으므로 Unity as a Library 기능이 일부 사례에서 동작하지 않을 수 있습니다. 알려진 제한 사항은 다음과 같습니다.

  • Unity as a Library는 전체화면 렌더링만 지원하며, 화면 일부의 렌더링은 지원하지 않습니다.
  • 두 개 이상의 Unity 런타임 인스턴스를 로드하거나 통합할 수 없습니다.
  • Unity 런타임에서 동작하도록 만들기 위해 타사 플러그인(네이티브관리되는 플러그인 모두)을 조정해야 할 수 있습니다.

  • 2019.3에서 Android용 ‘Unity as a Library’ 기능 추가됨NewIn20193
Java 또는 Kotlin 소스 파일을 플러그인으로 사용
Android에서 딥 링크