Version: 2023.2
言語: 日本語
Create a custom activity
The GameActivity application entry point

Specify Android Player command-line arguments

A use-case for extending the custom Unity activity is to pass command-line arguments when you launch the Android Player. For information on the available command-line arguments, refer to Command-line arguments.

To specify startup command-line arguments in custom activity:

  1. Create a custom activity and set it as the application entry point.
  2. In the custom activity, override the String UnityPlayerActivity.updateUnityCommandLineArguments(String cmdLine) method.
  3. In the method, concatenate the cmdLine argument with your own startup arguments then return the result. Important: The cmdLine argument can be an empty string or null so make sure your code handles these possible values.

The following example shows how to specify startup arguments to select the graphics API based on the current device:

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 protected String updateUnityCommandLineArguments(String cmdLine)
    {
        if (preferVulkan())
            return appendCommandLineArgument(cmdLine, "-force-vulkan");
        else
            return cmdLine; // let Unity pick the Graphics API based on PlayerSettings
    }

    @Override protected void onCreate(Bundle savedInstanceState)
    {
        super.onCreate(savedInstanceState);
    }
}

Additional ways to specify command-line arguments

Apart from the custom activity, you can specify command-line arguments in the following ways:

  • In Android Studio: If you open your project in Android Studio, you can pass startup command-line arguments to Unity through Launch Flags in Run/Debug Configurations dialog.
  • Via Android Debug Bridge (adb): You can pass command-line arguments by launching an Android application via adb using the following code.
adb shell am start -n "<package_name>/<activity_name>" -e unity <command_line_arguments>

The following example shows how to pass -systemallocator command-line argument to your application.

adb shell am start -n "com.Company.MyGame/com.unity3d.player.UnityPlayerActivity" -e unity -systemallocator

Create a custom activity
The GameActivity application entry point
Copyright © 2023 Unity Technologies
优美缔软件(上海)有限公司 版权所有
"Unity"、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属机构在美国及其他地区的商标或注册商标。其他名称或品牌是其各自所有者的商标。
公安部备案号:
31010902002961