Version: 2023.2
언어: 한국어
기본 Unity 활동 확장
Android 플레이어 커맨드 라인 인자 지정

커스텀 활동 생성

기본 Unity 활동을 확장하려면 자신만의 커스텀 활동을 만들고 이를 애플리케이션의 엔트리 포인트로 설정합니다.이를 위한 절차는 다음과 같습니다.

  1. UnityPlayerActivity 클래스를 확장하는 새 활동을 생성합니다.
  2. 플러그인을 생성하여 새 활동을 최종 Unity Android 애플리케이션에 전달합니다.
  3. Android 앱 매니페스트를 오버라이드하여 새 activity를 애플리케이션의 엔트리 포인트로 설정합니다.

그 다음에는 활동에서 커스텀 활동을 구현하여 Unity와 Android 간의 상호 작용을 제어할 수 있습니다.

새 활동 생성

새 활동을 생성하려면:

  1. Assets 폴더에서 새 Java (.java) 또는 Kotlin (.kt) 파일을 생성합니다.
  2. 새 파일에서 UnityPlayerActivity를 연장하는 클래스를 생성합니다.
  3. 새 클래스에서 다양한 기본 활동 메서드를 오버라이드하여 활동에 원하는 커스텀 활동을 구현합니다.자세한 내용은 Android의 활동 문서를 참조하십시오.

예제 활동

다음 코드 샘플은 여러 함수를 오버라이드하는 활동의 예를 보여줍니다.

package com.company.product;
import com.unity3d.player.UnityPlayerActivity;
import android.os.Bundle;
import android.util.Log;

public class OverrideExample extends UnityPlayerActivity {
  protected void onCreate(Bundle savedInstanceState) {
    // Calls UnityPlayerActivity.onCreate()
    super.onCreate(savedInstanceState);
    // Prints debug message to Logcat
    Log.d("OverrideActivity", "onCreate called!");
  }
  public void onBackPressed()
  {
    // Instead of calling UnityPlayerActivity.onBackPressed(), this example ignores the back button event
    // super.onBackPressed();
  }
}

활동을 위한 플러그인 생성

Unity Android 애플리케이션에 커스텀 활동을 사용하려면 해당 활동을 포함할 플러그인을 만들어야 합니다.활동은 Java 또는 Kotlin으로 작성되므로 다음 타입의 플러그인 중 하나를 사용해야 합니다.

단일 프로젝트에 대한 커스텀 활동을 만들려면 Java 및 Kotlin 소스 플러그인을 사용하십시오.소스 플러그인을 만들려면 소스 파일을 프로젝트의 Assets 폴더에 직접 배치하십시오.

여러 프로젝트에서 활동을 재사용하거나 다른 사람에게 배포하려면 Android 아카이브(AAR) 또는 JAR 플러그인을 사용하십시오.하나의 AAR 또는 JAR 플러그인 파일을 관리하면 여러 프로젝트에서 기능을 더 쉽게 제공할 수 있습니다.

플러그인을 개발하는 동안에는 Android 라이브러리 프로젝트를 사용하고 구현을 완료하거나 여러 프로젝트에서 사용하거나 다른 사람에게 배포하려는 경우 Android 아카이브 플러그인으로 컴파일하십시오.

플러그인을 만든 후 활동 파일을 추가합니다.

새 활동을 애플리케이션 엔트리 포인트로 설정

활동을 생성하고 플러그인에 추가하면 이를 애플리케이션 엔트리 포인트로 설정할 수 있습니다. 이렇게 하려면 Android 매니페스트를 수정하고 활동 요소name 속성을 커스텀 활동의 클래스 이름으로 설정합니다.

다음 Android 매니페스트 예제가 이 방법을 보여줍니다.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.company.product">
  <application android:icon="@drawable/app_icon" android:label="@string/app_name">
    <activity android:name="com.YourPackage.name.OverrideExample"
             android:theme="@style/UnityThemeSelector"
             android:label="@string/app_name"
             android:configChanges="fontScale|keyboard|keyboardHidden|locale|mnc|mcc|navigation|orientation|screenLayout|screenSize|smallestScreenSize|uiMode|touchscreen">
        <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
        </intent-filter>
    </activity>
  </application>
</manifest>
기본 Unity 활동 확장
Android 플레이어 커맨드 라인 인자 지정