Version: 2022.1
언어: 한국어
네이티브 플러그인
로우레벨 네이티브 플러그인 인터페이스

데스크톱 플랫폼용 플러그인 빌드

데스크톱 플랫폼용 플러그인은 C, C++, Objective C에서 작성할 수 있는 네이티브 코드 라이브러리입니다. 이 페이지에서는 macOS, Windows, Linux용 플러그인에 대해 설명합니다. 자세한 내용은 네이티브 플러그인을 참조하십시오.

macOS 플러그인

macOS 플러그인을 번들로 배포하거나 IL2CPP 스크립팅 백엔드를 사용하고 있는 경우 [DllImport("__Internal")] 구문으로 호출할 수 있는 느슨한 C++파일을 배포할 수 있습니다. 느슨한 C++ 플러그인에 대한 자세한 내용은 IL2CPP를 위한 C++ 소스 코드 플러그인을 참조하십시오.

XCode를 사용하여 번들 프로젝트를 생성하려면 다음 단계를 따르십시오.

  1. XCode를 엽니다.
  2. File > New > Project > macOS > Framework & Library > Bundle을 선택합니다.

XCode를 사용하여 작업하는 데 대한 자세한 내용은 Apple의 Xcode에 대한 문서를 참조하십시오.

요구 사항

  • 플러그인을 64비트 아키텍처와 호환되는 유니버설 바이너리로 빌드할 수 있습니다. 또는 별도 dylib 파일을 제공할 수도 있습니다.
  • C++ (.cpp) 또는 Objective-C (.mm)를 사용하여 플러그인을 구현하는 경우 네임 맹글링(name mangling) 문제를 피하기 위해 C링크에 함수를 선언합니다.
extern "C"
{
  float ExamplePluginFunction ();
}

Windows 플러그인

IL2CPP를 사용하고 있는 경우 Windows의 플러그인은 익스포트된 함수를 가진 .dll 파일이나 느슨한 C++ 파일입니다. .dll 파일을 만들어 플러그인을 생성할 수 있는 대부분의 언어와 개발 환경을 사용할 수 있습니다. 네임 맹글링 문제를 피하기 위해 반드시 C링크에 모든 C++ 함수를 선언해야 합니다.

Linux 플러그인

Linux의 플러그인은 익스포트된 함수를 가진 .so 파일입니다. 이러한 라이브러리는 보통 C 또는 C++에 있지만 모든 언어를 사용할 수 있습니다. 네임 맹글링 문제를 피하기 위해 반드시 C링크에 모든 C++ 함수를 선언해야 합니다.

Unity 내 플러그인 관리

Unity에서 플러그인 인스펙터는 플러그인을 관리합니다. 플러그인 인스펙터에 액세스하려면 프로젝트 창에서 플러그인 파일을 선택합니다. 스탠드얼론 플랫폼의 경우 해당 라이브러리와 호환될 수 있는 CPU 아키텍처를 선택할 수 있습니다. 크로스 플랫폼 플러그인의 경우 반드시 .bundle 파일(macOS용), .dll 파일(Windows용), .so 파일(Linux용)을 포함해야 합니다. Unity는 타겟 플랫폼에 알맞은 플러그인을 자동으로 선택하고 플레이어에 포함합니다. 자세한 내용은 플러그인 임포트와 설정을 참조하십시오.

플러그인 인스펙터
플러그인 인스펙터

C# 스크립트에서 플러그인 호출

빌드된 플러그인을 Assets 폴더 또는 Unity 프로젝트에 있는 적절한 아키텍처별 하위 디렉토리에 배치합니다. 그러면 Unity는 C# 스크립트에서 호출할 때 이름으로 플러그인을 찾습니다. 예: [DllImport ("PluginName")] private static extern float ExamplePluginFunction ();

참고: PluginName은 라이브러리 접두사 또는 파일 확장자를 포함해서는 안 됩니다. 예를 들어 플러그인 파일의 실제 이름은 Windows의 경우 PluginName.dll이고 Linux의 경우 libPluginName.so입니다.

예제 플러그인

이러한 프로젝트를 다운로드하고 사용하여 Unity에서 플러그인을 구현하는 방법을 배울 수 있습니다.

  • 가장 간단한 플러그인 예시: 이 프로젝트는 기본 작업을 구현합니다(예: 숫자 출력, 문자열 출력, 두 개의 플로트 추가, 두 개의 정수 추가). 이 프로젝트는 Windows, macOS, Linux 프로젝트 파일을 포함합니다.
  • 네이티브 렌더러 플러그인: 이 플러그인은 모든 정규 렌더링이 완료되어 C++ 코드에서 절차적 텍스처를 채운 후 액세스하기 위해 Texture.GetNativeTexturePtr를 사용하여 C++ 코드에서 회전하는 삼각형을 렌더링하는 로우레벨 렌더링 플러그인입니다. 이 프로젝트는 Windows, UWP, macOS, WebGL, Android 파일을 포함합니다.
네이티브 플러그인
로우레벨 네이티브 플러그인 인터페이스