기술 자료

Unity 엔진

Unity 엔진

Android 플레이어 커맨드 라인 인자를 지정합니다.

Unity 전달할 시작 커맨드 라인 인자를 지정합니다.
읽는 시간 2분최근 업데이트: 10일 전

Android 플레이어를 시작할 때 커맨드 라인 인자를 전달하도록 커스텀 Unity 활동을 확장할 수 있습니다. 사용 가능한 커맨드 라인 인자에 대한 자세한 내용은 커맨드 라인 인자를 참조하십시오.
커스텀 활동에서 시작 커맨드 라인 인자를 지정하려면 다음 단계를 따르십시오.
  1. 커스텀 활동을 생성하고 애플리케이션 엔트리 포인트로 설정합니다.
  2. 커스텀 활동에서
    String UnityPlayerActivity.updateUnityCommandLineArguments(String cmdLine)
    메서드를 오버라이드합니다.
  3. 메서드에서
    cmdLine
    인수를 자체 시작 인수와 연결한 다음 결과를 반환합니다.
    중요
    cmdLine
    인수는 빈 문자열 또는 null일 수 있습니다. 코드가 가능한 값을 처리하는지 확인합니다.
다음 예시는 현재 디바이스에 따라 시작 인자를 지정하여 그래픽스 API 선택하는 방법을 보여 줍니다.
package com.company.product;import com.unity3d.player.UnityPlayerActivity;import android.os.Bundle;import android.os.Build;public class OverrideExample extends UnityPlayerActivity { private boolean preferVulkan() { // Use Vulkan on Google Pixel devices if (Build.MANUFACTURER.equals("Google") && Build.MODEL.startsWith("Pixel")) return true; else return false; } private String appendCommandLineArgument(String cmdLine, String arg) { if (arg == null || arg.isEmpty()) return cmdLine; else if (cmdLine == null || cmdLine.isEmpty()) return arg; else return cmdLine + " " + arg; } @Override 보호 문자열 업데이트UnityCommandLineArguments(String cmdLine) { if (preferVulkan()) return appendCommandLineArgument(cmdLine, "-force-vulkan"); else return cmdLine; // Unity PlayerSettings에 따라 그래픽스 API 선택하도록 합니다. } @Override protected void onCreate(번들로 저장된 인스턴스 상태) { super.onCreate(savedInstanceState); }}
다음 예제는 네이티브 Android 앱에서 Unity 앱으로 커스텀 시작 파라미터를 전달하는 방법을 보여 줍니다.
package com.company.product;import com.unity3d.player.UnityPlayerActivity;import android.os.Bundle;import android.content.Intent;public class CustomParameterExample extends UnityPlayerActivity { private String appendCommandLineArgument(String cmdLine, String arg) { if (arg == null || arg.isEmpty()) return cmdLine; else if (cmdLine == null || cmdLine.isEmpty()) return arg; else return cmdLine + " " + arg; } @Override 보호 문자열 업데이트UnityCommandLineArguments(String cmdLine) { // Get custom parameters passed from the native Android application Intent intent = getIntent(); Bundle extras = intent.getExtras(); if (extras != null && extras.containsKey("startLevel")) { int level = extras.getInt("startLevel"); cmdLine = appendCommandLineArgument(cmdLine, "-level " + level); } return cmdLine; } @Override protected void onCreate(번들로 저장된 인스턴스 상태) { super.onCreate(savedInstanceState); }}

커맨드 라인 인자를 지정하는 추가 방법

커스텀 활동 외에 다음과 같은 방법으로 커맨드 라인 인자를 지정할 수 있습니다.
  • In Android Studio: Android Studio에서 프로젝트를 열면 시작 커맨드 라인 인자를 실행/디버그 구성 다이얼로그의 실행 플래그를 통해 Unity에 전달할 수 있습니다.
  • Android 디버그 브리지(adb)를 통해: 다음 코드를 사용하여 adb를 통해 Android 애플리케이션을 실행하여 커맨드 라인 인자를 전달할 수 있습니다.
adb shell am start -n "<package_name>/<activity_name>" -e Unity \""<command_line_arguments>\"
다음 코드 예제를 사용하여
-systemallocator
커맨드 라인 인자를 애플리케이션에 전달합니다.
adb shell am start -n "com.Company.MyGame/com.unity3d.player.UnityPlayerActivity" -e Unity \"-systemallocator\"
다음 코드 예시를 사용하여 값
little
로
-platform-android-jobworker-affinity
커맨드 라인 인자를 전달하여 작은 코어에서 Unity 잡 워커 스레드를 실행합니다. 자세한 내용은 Android 스레드 구성을 참고하십시오.
adb shell am start -a Android.intent.action.MAIN -n "com.Company.MyGame/com.unity3d.player.UnityPlayerActivity" -e Unity \"-platform-Android-jobworker-affinity little\"