将Unity3D游戏移植到Android平台上

将Unity3D游戏移植到Android平台是一件很容易的事情，只需要在File->Build Settings中选择Android平台，然后点击Switch Platform并Build出apk即可。通常，我们的工作不仅限于此，一般还需要给手机游戏加入计费、广告等功能。这些功能一般没有提供Unity3D插件，我们需要将游戏导出为Android工程，然后添加这些功能；或者，我们根据这些计费sdk来做自己想要的Unity3D插件，然后直接在Unity3D中使用。

1.从Unity3D到Android工程

为了实现交互，我们采用的是简单的函数相互调用。如果我们在Unity3D中想调用Android代码，那么可以在脚本文件C#中这样写：

AndroidJavaClass jc = new AndroidJavaClass("com.unity3d.player.UnityPlayer");
AndroidJavaObject activity = jc.GetStatic<AndroidJavaObject>("currentActivity");
activity.Call("UnlockGame")

第一行代码构造了"com.unity3d.player.UnityPlayer"类的一个对象，然后获取了本类的静态成员"currentActivity"，取得了activity就可以调用Android代码了（如果你在Unity导出的Eclipse工程中查看unity-class.jar这个文件中的类，你会发现com.unity3d.player这个package下就有UnityPlayer.class这个类，这个类中有个currentActivity）。这个UnlockGame函数是简单的成员方法，一般直接写在MainActivity中，也就是说Android代码中必须要有UnlockGame这个函数，然后才能调用；而"com.unity3d.player.UnityPlayer"和"currentActivity"都是默认的参数。

如果要在Android工程中调用Unity3D中的方法，我们需要新建一个Android工程。可以这样写java代码：

UnityPlayer.UnitySendMessage("AndroidManager", "AndroidCallBackUnlockGame", "");

这里调用了Unity3D中"AndroidCallBackUnlockGame"这个方法，最终激活了游戏。第一个参数表示Unity3D中某个gameObject，第二个参数是这个gameObject上的脚本中的某个方法，第三个参数是这个方法的参数。

上面只是讲述了交互的基本原理，下面是详细步骤。

（1）在Unity3D中创建脚本，如上面第一段代码所示，加入调用Android函数的代码；如果Android要调用C#代码，也要写下被Android代码回调的C#函数。然后，把Unity项目导出为Android工程即可。这里需要注意下图红色部分，其中Bundle Identifier就是导出的Android工程的包名。

（2）打开Eclipse，导入工程，选择import->Existing Android Code Into Workspace，最好把Copy Into WorkSpace选项也选上，这个工程通常叫做“UnityPlayerProxyActivity”。导入工程后，我们可以直接运行这个工程了。但这里是为了与Android代码交互，所以还不能这样做。通常的方法是，我们新建一个Android Application Project，包名必须与导入的工程包名相同；然后把导入的工程作为新工程的Library Project，在工程的Properties里设置，如下图所示。

（3）将导入的Unity工程assets目录里的bin和libs目录（新版的没有lib目录）拖放到新工程的assets目录里，即移动资源位置而已。说明一点，新建的Android工程作为了主工程，导入的Unity工程作为了Library Project，它们的Assets和Res资源将会最终合并在一起，但主工程必须要添加Library工程中所有需要的配置信息，也就是AndroidManifest.xml中的内容。这里还可能遇到资源ID冲突的现象，优先级高的主工程将覆盖优先级低的工程。

（4）好了，现在我们有两个工程，一个是新建的，一个是从Unity3D中导入的。这里必须学点Android开发的基础知识，onCreate函数是入口函数，其它的自学吧。想在Android里调用Unity3D代码，就用本文开头的第二段代码即可。通常，我们在新工程里创建一个Activity，在AndroidManifest.xml里进行设置要启动的Activity。假设要启动的是MainActivity，那么对于MainActivity这个类，我们要让它继承UnityPlayerActivity这个类，然后在Oncreate里调用super.onCreate即可。然后，运行新工程，我们的Unity3D游戏也跟着启动了。我们的主工程是新建的，没有设置任何视图，之所以启动了游戏，是因为继承了UnityPlayerActivity这个类，然后调用super.onCreate通过父类启动了游戏。

public class MainActivity extends UnityPlayerActivity {

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

既然是基础，我在说的详细点。首先创建新的Android Application Project，注意包名与导入的工程一致，并且不要创建Activity， 我们手动创建。然后新建一个类，类名暂且为MainActivity，package name必须与前面说的一致。然后写上上图中的代码。如果有错误提示，按下ctrl + shift + O可以导入所需类库。如果还有红色错误，请检查你是否引用了Unity工程。我们要手动创建Activity，还要在AndroidManifest.xml这个文件里做设置，如下所示。

    <application
        android:allowBackup="true"
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:theme="@style/AppTheme" >
        <activity
            android:name=".MainActivity"
            android:label="@string/app_name"
            android:configChanges="orientation|keyboard"
            android:screenOrientation="landscape"
            >
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

其中的android:name=".MainActivity"表示这个Activity关联的类是前面创建的MainActivity类，这里省略了前面的包名。已经设置完了，现在可以run了。有一点要记住，如果你在Unity的C#代码里调用了某个Android函数，MainActivity类中一定要添加这个函数。另外，如果你不添加android:screenOrientation可能会导致程序启动崩溃。

2.从Android工程到Unity3D

（1）新建一个Android工程，不要创建Activity，在properties属性里把工程设置为library.

（2）到安装目录C:\Program Files (x86)\Unity\Editor\Data\PlaybackEngines\androidplayer\bin下面复制classes.jar这个文件到Android工程的libs目录下面。

（3）新建一个类，这里是MainActivity，写法如下，我们会在Unity3D中调用TextToast这个函数。这里同样要注意包名，要与Unity3D中Bundle Identifier相同。注意这里必须使用runOnUiThread处理UI线程。

public class MainActivity extends UnityPlayerActivity{

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

    protected void TextToast(final String msg){
        runOnUiThread(new Runnable(){
            public void run(){
                Text(msg);
            }
        });
    }

    public void Text(String msg){
        Toast.makeText(this, msg, Toast.LENGTH_SHORT).show();
    }
}

（4）在菜单里选择Project->Clean，然后在工程目录的bin下面找到刚生成的jar文件，我们可以直接把这个jar文件导入Unity3D中作为插件使用，即放到目录Assets/Plugins/Android下面即可。在Unity3D的安装目录C:\Program Files (x86)\Unity\Editor\Data\PlaybackEngines\androidplayer下面找到AndroidManifest.xml这个文件，也复制到Assets/Plugins/Android这个目录下。打开这个xml文件，修改Activity名称与eclipse工程中的Activity一致，即把com.unity3d.player.UnityPlayerProxyActivity修改为包名.MainActivity，我这里是com.activ8.ppt.MainActivity。设置完成，我们现在可以在Unity3D中使用该插件了，使用方法见本文开头第一段代码。Unity4.3以后，配置文件修改方法已经改变，还要修改package为你的包名，建议查看Unity Manual文档，查找”Building Plugins for Android"，然后查找”AndroidManifest.xml“文件即可看到相关设置代码。