기술 자료

Unity 엔진

Unity 엔진

네이티브 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/UnityFramework.h
    포함), 플러그인, 종속 프레임워크를 포함하는 UnityFramework 타겟의 라이브러리 부분입니다. Xcode에서 이 타겟을 만들면
    UnityFramework.framework
    번들이 생성됩니다. Unity는 익스포트 폴더에 미리 빌드된
    .framework
    를 저장하지 않습니다.
  • 앱 표현 데이터를 포함하고 라이브러리를 실행하는 Unity iPhone 타겟의 씬 런처 파트입니다. Unity iPhone 타겟에는 UnityFramework 타겟에 대한 단일 종속성이 있습니다.
Unity를 다른 Xcode 프로젝트에 통합하려면 Xcode 프로젝트(네이티브 프로젝트와 Unity가 생성하는 프로젝트)를 하나의 Xcode 작업 공간에 결합하고 기본 애플리케이션의 타겟에 대해 빌드된
UnityFramework.framework
을 프레임워크, 라이브러리, 임베디드 콘텐츠(또는 내장 바이너리)에 추가합니다. 이렇게 하면
UnityFramework
클래스를 사용하여 Unity 런타임을 제어할 수 있습니다.
이 저장소에는 Unity를 Xcode 프로젝트에 통합하는 방법을 보여주는 프로젝트 및 플러그인 예시와 추가 문서가 포함되어 있습니다.

UnityFramework 클래스

호스트 앱에서
UnityFramework.framework
를 로드한 후에는
UnityFramework
Objective-C 클래스를 통해 Unity 런타임을 제어합니다. 클래스는
UnityFramework/UnityFramework.h
로 선언되며 다음과 같이 프레임워크 번들의 주요 클래스입니다.

메서드

설명

+ (UnityFramework*)getInstance;
인스턴스를
UnityFramework
에 반환하는 싱글톤 클래스 메서드입니다.
- (UnityAppController*)appController;
UIApplicationDelegate
의
UnityAppController
서브 클래스를 반환합니다. 네이티브 쪽의 루트 Unity 클래스이며, 앱의 보기 관련 오브젝트(예:
UIView
,
UIViewControllers
,
CADisplayLink
또는
DisplayConnection
)에 액세스할 수 있습니다.
- (void)setDataBundleId:(const char*)bundleId;
Unity 런타임이 Data 폴더를 찾아야 하는 번들을 설정합니다. 자세한 내용은 데이터 폴더의 문서를 참조하십시오.
runUIApplicationMainWithArgc
또는
runEmbeddedWithArgc
를 호출하기 전에 이 메서드를 호출합니다.
- (void)runUIApplicationMainWithArgc:(int)argc argv:(char*[])argv;
다른 뷰가 없는 메인 메서드에서 Unity 실행하는 기본 방법입니다.
- (void)runEmbeddedWithArgc:(int)argc argv:(char*[])argv appLaunchOpts:(NSDictionary*)appLaunchOpts;
다른 뷰가 있을 때 Unity 실행해야 할 때 이 메서드를 호출합니다.
- (void)unloadApplication;
이 옵션을 호출하여 Unity를 언로드하고 언로드가 완료된 후에
UnityFrameworkListener
에 대한 콜백을 수신합니다. Unity 차지하는 메모리의 대부분을 해제하지만 전부는 해제하지 않습니다. Unity 다시 실행할 수 있습니다.
- (void)registerFrameworkListener:(id<UnityFrameworkListener>)obj;
UnityFramework 라이프사이클 관련 이벤트의 콜백을 수신하는 listener 오브젝트를 등록합니다.
- (void)unregisterFrameworkListener:(id<UnityFrameworkListener>)obj;
listener 오브젝트를 등록 취소합니다.
- (void)showUnityWindow;
비 Unity 뷰가 표시되는 동안 이 메서드를 호출하여 이미 실행 중인 Unity 뷰도 표시합니다.
- (void)pause:(bool)pause;
Unity 일시 정지
- (void)setExecuteHeader:(const MachHeader*)header;
CrashReporter가 제대로 작동하려면 Unity 실행하기 전에 호출해야 합니다.
- (void)sendMessageToGOWithName:(const char*)goName functionName:(const char*)name message:(const char*)msg;
이 메서드는 UnitySendMessage의 프록시입니다. 이름으로 게임 오브젝트를 찾아 단일 문자열 메시지 파라미터로 functionName을 호출합니다.
(void)quitApplication:(int)exitCode;
이 옵션을 호출하여 Unity를 완전히 언로드하고 Unity가 종료되면
UnityFrameworkListener
에 대한 콜백을 수신합니다. Unity 모든 메모리를 해제합니다.

참고: 이 호출 후 동일한 프로세스에서 Unity 다시 실행할 수 없습니다. 기본 프로세스 죽음을 오버라이드하도록
AppController
의
quitHandler
를 설정할 수 있습니다.

제한

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