Aperçu

Si vous souhaitez rendre le SDK développé pour Android compatible avec les applications Unity, vous devez créer un plug-in pour relier les applications SDK et Unity. Il existe plusieurs façons d'implémenter des plugins natifs pour Android, mais cet article présentera une méthode qui hérite de UnityPlayerActivity. Veuillez vous référer à Common Edition pour l'implémentation des parties communes avec le plug-in pour iOS.

Côté plug-in

BaseNativeActivity BaseNativeActivity est une classe qui hérite de UnityPlayerActivity. Il agit comme un wrapper en appelant en son nom les méthodes des classes définies dans le SDK, telles que Sample et SampleLifecycle.

`BaseNativeActivity`


public class BaseNativeActivity extends UnityPlayerActivity {
    public static final void setCallbackGameObjectName(String name) {
        SampleUnityListener.getInstance().setCallbackGameObjectName(name);
    }

    @Override
    protected void onStart() {
        super.onStart();
        SampleLifecycle.onStart(this);
    }

    @Override
    protected void onResume() {
        super.onResume();
        SampleLifecycle.onResume(this);
    }

    @Override
    protected void onPause() {
        super.onPause();
        SampleLifecycle.onPause(this);
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        SampleLifecycle.onDestroy();
    }

    @Override
    public boolean onPrepareOptionsMenu(Menu menu) {
        return super.onPrepareOptionsMenu(menu);
    }

    public void start(String sampleCode) {
        Sample.getInstance().start(this);
    }

    public void doSomething() {
        runOnUiThread(new Runnable() {
            @Override
            public void run() {
                Sample.getInstance().doSomething()
            }
        });
    }

    public int getScore() {
        return Sample.getInstance().getScore();
    }

    public String getSomeText() {
        return Sample.getInstance().getSomeText();
    }

    public boolean isAvailable() {
        return Sample.getInstance().isAvailable();
    }
}

SampleUnityListener SampleUnityListener est une classe pour transmettre le rappel du côté SDK vers le côté Unity. Il implémente SampleListener, une classe d'écouteur définie du côté du SDK.

`SampleUnityListener`


public class SampleUnityListener implements SampleListener {
    private static final Sample sample = Sample.getInstance();
    private static SampleUnityListener instance;
    private String callbackGameObjectName;

    public synchronized static SampleUnityListener getInstance() {
        if (instance == null) {
            instance = new SampleUnityListener();
            sample.setListener(instance);
        }

        return instance;
    }

    public final void setCallbackGameObjectName(String name) {
        callbackGameObjectName = name;
    }

    @Override
    public void onStatusChanged(SampleStatus status) {
        if (callbackGameObjectName != null) {
            String statusIndex = String.valueOf(status.ordinal());
            UnityPlayer.UnitySendMessage(callbackGameObjectName, "_Sample_didStatusChange", statusIndex);
        }
    }
}

build.grade Ceci est un exemple de build.gradle. En plus du SDK lui-même (SampleSDK- *. Jar), classes.jar est inclus dans le répertoire libs pour importer des classes telles que UnityPlayerActivity, mais il est exclu car il n'est pas nécessaire au moment de la construction. De plus, comme il est nécessaire de résoudre le nom du côté Unity, minify est également défini sur false.

`build.gradle`


apply plugin: 'com.android.library'

android {
    compileSdkVersion 26
    buildToolsVersion "25.0.3"
    defaultConfig {
        minSdkVersion 14
        targetSdkVersion 26
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    compile 'com.android.support:appcompat-v7:26.+'
}

android.libraryVariants.all { variant ->
    variant.outputs.each { output ->
        output.packageLibrary.exclude('libs/classes.jar')
        output.packageLibrary.exclude('libs/SampleSDK-*.jar')
    }
}

À propos de build

Pour Android Studio, vous pouvez créer un aar à partir de Build-> Make Module. L'aar construit doit être placé sous Assets / Plugins / Android dans le projet Unity. Aussi, veuillez vous référer à ici pour la méthode d'acquisition de classes.jar utilisée au moment de la compilation.

Côté unité

Sample_Android.cs Sample_Android.cs est une classe qui implémente ISample, et en accédant à la classe (BaseNativeActivity) implémentée côté plug-in, application Unity et SDK Nous allons faire le pont.

`Sample_Android.cs`


using System;
using System.Collections;
using System.Collections.Generic;
using System.Runtime.InteropServices;
using UnityEngine;

public class Sample_Android : ISample {
    private Sample sampleGameObject;
    private SampleEventListener listener;
    private static AndroidJavaObject androidInstance;

    public Sample_Android(Sample sampleParent) {
        sampleGameObject = sampleParent;

        InitAndroidInstance();
        CreateListenerObject();

        if (sampleParent.androidSampleCode != null) {
            Start(null);
        }
    }

    private void CreateListenerObject() {
        listener = sampleGameObject.gameObject.AddComponent<SampleEventListener>();

        using (AndroidJavaObject activityObject = GetCurrentActivity()) {
            activityObject.CallStatic("setCallbackGameObjectName", sampleGameObject.gameObject.name);
        }

        listener.SetNativeParent(this);
    }

    public void Start(string sampleCode) {
        using (AndroidJavaObject activityObject = GetCurrentActivity()) {
            if (sampleGameObject.androidSampleCode != null) {
                activityObject.Call("start", sampleGameObject.androidSampleCode);
            } else if (sampleCode != null) {
                activityObject.Call("start", sampleCode);
            }
        }
    }

    public void DoSomething() {
        using (AndroidJavaObject activityObject = GetCurrentActivity()) {
            activityObject.Call("doSomething");
        }
    }

    public int GetScore() {
        using (AndroidJavaObject activityObject = GetCurrentActivity()) {
            return activityObject.Call<int>("getScore");
        }
    }

    public SampleStatus GetStatus() {
        SampleStatus status = SampleStatus.Unavailable;

        using (AndroidJavaObject statusObject = androidInstance.Call<AndroidJavaObject>("getStatus")) {
            string statusName = statusObject.Call<string>("name");

            if (statusName.Equals("Unavailable")) {
                status = SampleStatus.Unavailable;
            } else if(statusName.Equals("Available")) {
                status = SampleStatus.Available;
            }
        }

        return status;
    }

    public string GetSomeText() {
        return androidInstance.Call<string>("getSomeText");
    }

    public bool IsAvailable() {
        using (AndroidJavaObject activityObject = GetCurrentActivity()) {
            return activityObject.Call<bool>("isAvailable");
        }
    }

    public AndroidJavaObject GetCurrentActivity() {
        using (AndroidJavaClass playerClass = new AndroidJavaClass("com.unity3d.player.UnityPlayer")) {
            return playerClass.GetStatic<AndroidJavaObject>("currentActivity");
        }
    }

    protected static void InitAndroidInstance() {
        using (AndroidJavaClass sampleClass = new AndroidJavaClass("com.sdk.Sample")) {
            androidInstance = sampleClass.CallStatic<AndroidJavaObject>("getInstance"); 
        }
    }
}

AndroidManifest.xml Ceci est un exemple d'Android Manifest placé sous le projet Assets / Plugins / Android of Unity. L'activité native de base mentionnée ci-dessus est décrite.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.unity3d.player"
	  android:installLocation="preferExternal"
	  android:theme="@android:style/Theme.NoTitleBar"
	  android:versionCode="1" android:versionName="1.0">
  <supports-screens android:smallScreens="true"
		    android:normalScreens="true"
		    android:largeScreens="true"
		    android:xlargeScreens="true"
		    android:anyDensity="true" />
  <application android:label="@string/app_name" android:debuggable="false">
    <activity android:name="com.sample.plugin.BaseNativeActivity">
      <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
      </intent-filter>
      <meta-data android:name="unityplayer.ForwardNativeEventsToDalvik" android:value="true" />
    </activity>
  </application>
  <uses-permission android:name="android.permission.INTERNET" />
  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
</manifest>

Proguard Si vous souhaitez définir des paramètres tels que le fait d'éviter Minify pour certaines classes, créez proguard-user.txt et placez-le sous Assets / Plugins / Android of Unity project, et il sera automatiquement exporté en tant que projet Android. Cela sera reflété.

`proguard-user.txt (exemple)`


-keepattributes *Annotation*
-keepattributes Signature
-keep class com.sample.sdk.** {
  public <fields>;
  public <methods>;
}

-keep class com.sample.plugin.** {
    public <fields>;
    public <methods>;
}

-dontwarn com.sample.sdk.**

Structure du répertoire

Placez les éléments suivants sous Assets / Plugins / Android du projet Unity selon vos besoins. -Corps SDK (pot / aar)

Plug-in (pot / aar)
AndroidManifest.xml
proguard-user.txt

référence

https://docs.unity3d.com/ja/540/Manual/PluginsForAndroid.html

[JAVA] Comment créer un plug-in natif Unity (version Android)

Aperçu

Côté plug-in

BaseNativeActivity

SampleUnityListener

build.gradle