네이티브 iOS 애플리케이션에 Unity 통합
Unity 런타임 라이브러리를 iOS 애플리케이션에 통합합니다.
읽는 시간 3분최근 업데이트: 9일 전
이 페이지에서는 Unity as a Library 기능을 사용하여 Unity 런타임 라이브러리를 iOS 네이티브 애플리케이션에 통합하는 방법을 설명합니다.
이 기능을 사용하여 기본 애플리케이션에 3D/2D 실시간 렌더링, AR 경험, 3D 모델 상호작용 또는 2D 미니 게임과 같은 Unity 지원 기능을 포함할 수 있습니다. Unity 런타임 라이브러리는 컨트롤을 노출하여 기본 애플리케이션 콘텐츠를 로드, 활성화, 언로드할 시기와 방법을 관리합니다.
자세히 알아보기
Unity iOS용 라이브러리로 사용하려면 먼저 일반적으로 Unity Xcode 프로젝트를 빌드해야 합니다. 자세한 내용은 iOS 애플리케이션 빌드를 참고하십시오.
모든 Unity iOS Xcode 프로젝트의 구조는 다음과 같습니다.
- 소스(포함), 플러그인, 종속 프레임워크를 포함하는 UnityFramework 타겟의 라이브러리 부분입니다. Xcode에서 이 타겟을 만들면
UnityFramework/UnityFramework.h번들이 생성됩니다. Unity는 익스포트 폴더에 미리 빌드된UnityFramework.framework를 저장하지 않습니다..framework - 앱 표현 데이터를 포함하고 라이브러리를 실행하는 Unity iPhone 타겟의 씬 런처 파트입니다. Unity iPhone 타겟에는 UnityFramework 타겟에 대한 단일 종속성이 있습니다.
Unity를 다른 Xcode 프로젝트에 통합하려면 Xcode 프로젝트(네이티브 프로젝트와 Unity가 생성하는 프로젝트)를 하나의 Xcode 작업 공간에 결합하고 기본 애플리케이션의 타겟에 대해 빌드된 을 프레임워크, 라이브러리, 임베디드 콘텐츠(또는 내장 바이너리)에 추가합니다. 이렇게 하면 클래스를 사용하여 Unity 런타임을 제어할 수 있습니다.
UnityFramework.frameworkUnityFramework이 저장소에는 Unity를 Xcode 프로젝트에 통합하는 방법을 보여주는 프로젝트 및 플러그인 예시와 추가 문서가 포함되어 있습니다.
UnityFramework 클래스
호스트 앱에서 를 로드한 후에는 Objective-C 클래스를 통해 Unity 런타임을 제어합니다. 클래스는 로 선언되며 다음과 같이 프레임워크 번들의 주요 클래스입니다.
UnityFramework.frameworkUnityFrameworkUnityFramework/UnityFramework.h메서드 | 설명 |
|---|---|
| 인스턴스를 |
| |
| Unity 런타임이 Data 폴더를 찾아야 하는 번들을 설정합니다. 자세한 내용은 데이터 폴더의 문서를 참조하십시오. |
| 다른 뷰가 없는 메인 메서드에서 Unity 실행하는 기본 방법입니다. |
| 다른 뷰가 있을 때 Unity 실행해야 할 때 이 메서드를 호출합니다. |
| 이 옵션을 호출하여 Unity를 언로드하고 언로드가 완료된 후에 |
| UnityFramework 라이프사이클 관련 이벤트의 콜백을 수신하는 listener 오브젝트를 등록합니다. |
| listener 오브젝트를 등록 취소합니다. |
| 비 Unity 뷰가 표시되는 동안 이 메서드를 호출하여 이미 실행 중인 Unity 뷰도 표시합니다. |
| Unity 일시 정지 |
| CrashReporter가 제대로 작동하려면 Unity 실행하기 전에 호출해야 합니다. |
| 이 메서드는 UnitySendMessage의 프록시입니다. 이름으로 게임 오브젝트를 찾아 단일 문자열 메시지 파라미터로 functionName을 호출합니다. |
| 이 옵션을 호출하여 Unity를 완전히 언로드하고 Unity가 종료되면 참고: 이 호출 후 동일한 프로세스에서 Unity 다시 실행할 수 없습니다. 기본 프로세스 죽음을 오버라이드하도록 |
제한
Unity 런타임 라이프사이클을 제어하지 않으므로 Unity as a Library는 가능한 모든 사용 사례에서 작동하지 않을 수 있습니다. 알려진 제한 사항은 다음과 같습니다.
-
Unity as a Library는 전체 화면 렌더링만 지원하며 화면 일부의 렌더링은 지원하지 않습니다.
-
Unity 런타임의 인스턴스를 둘 이상 로드할 수 없습니다.
-
네이티브 iOS 애플리케이션에서 Unity as a Library를 사용할 때 iOS 플레이어 설정을 통해 기기의 상태 표시줄을 조정할 수 없습니다. 이를 위해 다음 옵션 중 하나를 사용하는 것이 좋습니다.
- 프로젝트의 info.plist 파일에서 또는
UIStatusBarHidden키를 설정합니다.UIViewControllerBasedStatusBarAppearance - 뷰 컨트롤러 속성 및 호출
prefersStatusBarHidden방법을 설정합니다.setNeedsStatusBarAppearanceUpdate - 뷰 컨트롤러 속성 를 설정합니다.
childViewControllerForStatusBarHidden
- 프로젝트의 info.plist 파일에서