기술 자료

Unity 엔진

Unity 엔진

Java 및 Kotlin 플러그인 코드에서 C# 코드 호출

Java 및 Kotlin 플러그인 코드에서 C# 스크립트 코드 호출합니다.
읽는 시간 3분최근 업데이트: 9일 전

Java 및 Kotlin 플러그인 코드는 예를 들어 Unity Android 이벤트를 알리거나 플러그인 코드의 결과를 반환하기 위해 C# 스크립트를 호출할 수 있습니다. 다음 두 가지 방법을 사용할 수 있습니다.
  • UnitySendMessage
    가 있는 게임 오브젝트에 메시지를 보냅니다.
  • AndroidJavaProxy를 사용한 콜백 인터페이스를 통해 C# 메서드를 호출합니다.
Java 및 Kotlin에 해당하는 C# 구현은 C# 스크립트에서 Java 및 Kotlin 플러그인 코드 호출을 참조하십시오.
참고
두 방식을 디버깅하려면 AndroidJNIHelper.debug를
true
로 설정하여 Unity가 각 호출에 대해 수행하는 JNI 작업을 기록합니다.

게임 오브젝트에 메시지 전송

UnitySendMessage
를 사용하여 Java 또는 Kotlin 플러그인 코드에서 이름이 지정된 게임 오브젝트의 메서드로 문자열을 전송합니다. C# 메서드가 문자열을 수신하지만 플러그인에 값을 반환하지 않는 단방향 호출입니다. 간단한 알림에 사용합니다.
플러그인은 타겟 게임 오브젝트의 이름, 호출할 메서드의 이름, 문자열 메시지 등 세 가지 인수로
UnitySendMessage
를 호출합니다.
다음 Java 예제는
UnitySendMessage
를 구현합니다.
package com.example.androidplugin;import com.unity3d.player.UnityPlayer;public class MessageSender { public static void sendToUnity(String gameObjectName) { UnityPlayer.UnitySendMessage(gameObjectName, "OnMessageReceived", "Hello from Java"); }}
다음 Kotlin 예제는
UnitySendMessage
를 구현합니다.
package com.example.androidpluginimport com.unity3d.player.UnityPlayer오브젝트 MessageSender { @JvmStatic fun sendToUnity(gameObjectName: 문자열 UnityPlayer.UnitySendMessage(gameObjectName, "OnMessageReceived", "Hello from Kotlin") }}
C# 스크립트에서
UnitySendMessage
가 호출하는 메서드를 추가합니다. 이름이 첫 번째 인수와 일치하는 게임 오브젝트에 스크립트가 연결되었는지 확인합니다.
using UnityEngine;public class MessageReceiver : MonoBehaviour{ void Start() { gameObject.name = "MessageReceiver"; using var sender = new AndroidJavaClass("com.example.androidplugin.MessageSender"); sender.CallStatic("sendToUnity", gameObject.name); } void OnMessageReceived(string message) { Debug.Log("Message from plug-in: " + message); }}
이 예제:
  1. 플러그인이 전송하는 타겟 이름과 일치하도록 게임 오브젝트의 이름을 설정합니다.
  2. 이름이 지정된 게임 오브젝트의
    OnMessageReceived
    메서드로 문자열을 전송하기 위해
    UnitySendMessage
    를 사용하는 플러그인을 호출합니다.
  3. 플러그인이 전송하는 메시지를 기록합니다.
참고
이 예제에서 C#은 플러그인을 직접 호출하여 메시지를 트리거하므로 Android 이벤트 없이 예제를 실행할 수 있습니다. 실제 프로젝트에서 플러그인은 버튼 누르기 또는 라이프사이클 콜백과 같은 Android 이벤트에 대한 응답으로
UnitySendMessage
를 호출합니다.
UnitySendMessage
에는 다음과 같은 제한 사항이 있습니다.
  • 서명
    void MethodName(string message)
    만으로 C# 메서드를 호출할 수 있습니다.
  • 호출은 비동기적이며 한 프레임 지연이 있습니다.
  • 이름이 동일한 여러 개의 GameObjects 오브젝트가 충돌을 일으킬 수 있습니다.
문자열이 아닌 데이터를 전송하려면 JSON 문자열로 직렬화합니다. 자세한 내용은 Java/Kotlin 및 C# 코드 지원 데이터 유형을 참조하십시오.

콜백 인터페이스를 통해 C# 메서드 호출

C#에서 Java 또는 Kotlin 인터페이스를 구현하려면 AndroidJavaProxy를 사용합니다. 플러그인이 인터페이스에서 메서드를 호출하면 Unity C# 구현을 실행합니다. 이 방식을 입력된 콜백이나 구조화된 데이터를 전달하거나 값을 반환할 때 사용합니다.
플러그인에서 인터페이스와 이를 호출하는 클래스를 정의합니다. 다음 플러그인 코드는 인터페이스 메서드를 호출하여 메시지를 C#으로 다시 전달합니다.

Java 플러그인 코드

package com.example.androidplugin;public class Greeter { public interface GreetingCallback { void onGreeting(String message); } public void requestGreeting(GreetingCallback callback) { callback.onGreeting("Hello from Java"); }}
### Kotlin plug-in code
package com.example.androidpluginGreeter { 클래스 인터페이스 GreetingCallback { fun onGreeting(메시지: 문자열 } fun requestGreeting(callback: GreetingCallback) { callback.onGreeting("Hello from Kotlin") }}
C# 스크립트에서
AndroidJavaProxy
에서 파생되고 인터페이스를 구현하는 클래스를 생성합니다. 이 클래스의 인스턴스를 플러그인에 전달합니다.
using UnityEngine;public class GreetingExample : MonoBehaviour{ GreetingCallback 클래스: AndroidJavaProxy { public GreetingCallback() : base("com.example.androidplugin.Greeter$GreetingCallback") { } void onGreeting(string message) { Debug.Log("Greeting from plug-in: " + message); } } void Start() { using var greeter = new AndroidJavaObject("com.example.androidplugin.Greeter"); greeter.Call("requestGreeting", new GreetingCallback()); }}
이 예제:
  1. AndroidJavaProxy
    에서 파생된 C#
    GreetingCallback
    클래스를 생성하고 인터페이스 이름을 기본 생성자에 전달합니다.
    GreetingCallback
    가
    Greeter
    클래스에 중첩되므로 이름은
    $
    구분자를 사용합니다.
    com.example.androidplugin.Greeter$GreetingCallback
    .
  2. 인터페이스 메서드와 일치하는 서명을 사용하여
    onGreeting
    를 구현합니다. Unity 인터페이스의 호출을 이 C# 구현으로 자동으로 라우팅합니다.
  3. Greeter
    플러그인 클래스에 대한
    AndroidJavaObject
    를 생성하고 프록시를 전달하여
    requestGreeting
    를 호출합니다. 그런 다음 플러그인은
    onGreeting
    를 호출하여 C# 구현을 실행합니다.
참고
이 예제에서 플러그인은 Unity 메인 스레드 인터페이스 메서드를 호출합니다. 플러그인이 백그라운드 스레드에서 메서드를 호출하는 경우 C# 구현도 백그라운드 스레드에서 실행됩니다. 이 경우 AndroidApplication.InvokeOnUnityMainThread를 사용하여 메인 스레드에서 Unity API 호출을 실행합니다.
플러그인 코드 작성에 대한 자세한 내용은 Java 및 Kotlin 소스 플러그인을 참고하십시오.

추가 리소스