<h2 id="%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB">
<a class="header-anchor-link" href="#%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" aria-hidden="true"></a> はじめに</h2>
<p>この記事は Unity ・・・ではなく <a href="https://qiita.com/advent-calendar/2020/xamarin" target="_blank" rel="nofollow noopener noreferrer">Xamarin Advent Calendar 2020</a> の 6 日目の記事です。</p>
<p>表題の通り、 Xamarin.Android で Unity as a Library をやろうとしたのですが、うまくいく目途が立たなかったので経過報告的な記事でお茶を濁してしまおうかと・・・　すいません。</p>
<h3 id="%E8%BF%BD%E8%A8%98-(12%2F8)%3A">
<a class="header-anchor-link" href="#%E8%BF%BD%E8%A8%98-(12%2F8)%3A" aria-hidden="true"></a> 追記 (12/8):</h3>
<p>この記事の内容を試していただいてうまくいったとのことです！</p>
<ul>
<li><a href="https://qiita.com/f-miyu/items/5b4d281ab47b1049f02b" target="_blank" rel="nofollow noopener noreferrer">Xamarin.Android で Unity as a Library (うまくいった話)</a></li>
</ul>
<p>ありがとうございました。</p>
<h2 id="unity-as-a-library-%E3%81%A8%E3%81%AF">
<a class="header-anchor-link" href="#unity-as-a-library-%E3%81%A8%E3%81%AF" aria-hidden="true"></a> Unity as a Library とは</h2>
<ul>
<li><a href="https://unity.com/ja/features/unity-as-a-library" target="_blank" rel="nofollow noopener noreferrer">Unity as a Library を使用する</a></li>
<li><a href="https://blogs.unity3d.com/jp/2019/06/17/add-features-powered-by-unity-to-native-mobile-apps/" target="_blank" rel="nofollow noopener noreferrer">ネイティブモバイルアプリケーションに Unity で作成した機能を追加できる「Unity as a Library」のご紹介</a></li>
<li><a href="https://qiita.com/mizoguche/items/09719bb1ea3c3265dcdc" target="_blank" rel="nofollow noopener noreferrer">Unity as a LibraryによるUIネイティブ化</a></li>
</ul>
<p>"Unity as a Library" は他のアプリから Unity で実装したコードを「ライブラリ」として実行できるようにする仕組みです。<br>
当初は Andorid/iOS のみのサポートでしたが、後に Windows でも対応しています。 Windows については以前記事を書きました。</p>
<ul>
<li><a href="https://tan-y.hatenablog.com/entry/2020/06/25/083000" target="_blank" rel="nofollow noopener noreferrer">Windows で Unity as a Library</a></li>
</ul>
<p>今回の環境は次の通りです。</p>
<ul>
<li>Windows 10</li>
<li>Unity 2019.4.15f1</li>
<li>Android Studio 4.1.1</li>
<li>Visual Studio 2019 16.8.1</li>
</ul>
<h2 id="unity-as-a-library-%E3%82%92%E8%A9%A6%E3%81%99">
<a class="header-anchor-link" href="#unity-as-a-library-%E3%82%92%E8%A9%A6%E3%81%99" aria-hidden="true"></a> Unity as a Library を試す</h2>
<ul>
<li><a href="https://github.com/Unity-Technologies/uaal-example" target="_blank" rel="nofollow noopener noreferrer">Unity as a Library integration example to iOS and Android</a></li>
</ul>
<p>とりあえず試すには公式のサンプルがよいです。手順は <a href="https://github.com/Unity-Technologies/uaal-example/blob/master/docs/android.md" target="_blank" rel="nofollow noopener noreferrer">こちら (Android 版)</a> に書かれています。</p>
<p>この手順には書かかれていませんが、 Unity 上で "Project Settings - Player - Configuration" で "Scripting Backend" を "IL2CPP" に設定しないと最終的なバイナリは動作しませんでした (合わせて Target Architectures の ARM64 もチェック) 。<br>
<img src="https://storage.googleapis.com/zenn-user-upload/gybks4ia8jvcmkxsns4mgdr21cv0" alt loading="lazy" class="md-img"></p>
<p>Build Settings で "Export Project" にチェックを入れることで Android Project が出力されます。後段の Android Studio での作業で、 Unity での出力先を "UnityProject\androidBuild" にしている事を前提として組まれているのでそこも注意です (私は読み飛ばしていて最初ひっかかりました) 。<br>
<img src="https://storage.googleapis.com/zenn-user-upload/by3wx2ej2knzrxc4jabnaxpg87du" alt loading="lazy" class="md-img"></p>
<h2 id="xamarin.android-%E3%81%AB%E7%A7%BB%E6%A4%8D%E3%81%99%E3%82%8B">
<a class="header-anchor-link" href="#xamarin.android-%E3%81%AB%E7%A7%BB%E6%A4%8D%E3%81%99%E3%82%8B" aria-hidden="true"></a> Xamarin.Android に移植する</h2>
<p>今回は上記の公式サンプルを Xamarin.Android 化してみます。</p>
<ul>
<li><a href="https://github.com/EgorBo/XamarinWithUnityApp" target="_blank" rel="nofollow noopener noreferrer">EgorBo / XamarinWithUnityApp</a></li>
</ul>
<p>同じことをやられている先人様です。</p>
<h3 id="unity-%E3%81%AE%E3%83%A9%E3%82%A4%E3%83%96%E3%83%A9%E3%83%AA%E3%82%92-aar-%E5%8C%96%E3%81%99%E3%82%8B">
<a class="header-anchor-link" href="#unity-%E3%81%AE%E3%83%A9%E3%82%A4%E3%83%96%E3%83%A9%E3%83%AA%E3%82%92-aar-%E5%8C%96%E3%81%99%E3%82%8B" aria-hidden="true"></a> Unity のライブラリを AAR 化する</h3>
<ul>
<li><a href="https://docs.microsoft.com/ja-jp/xamarin/android/platform/binding-java-library/binding-an-aar" target="_blank" rel="nofollow noopener noreferrer">.AAR のバインド</a></li>
</ul>
<p>Xamarin.Android で Android の Java コードをインポートするには jar か aar にしたものを利用しますが、今回はネイティブコードを含んでいるので aar にする必要があります。</p>
<ol>
<li>コンソールを開く</li>
<li>前項で Unity でビルドした Android プロジェクト (UnityProject\androidBuild) に移動</li>
<li>"gradlew assembleRelease" を実行</li>
</ol>
<p>で "unityLibrary\build\outputs\aar\unityLibrary-release.aar" に出力されます。</p>
<h3 id="visual-studio-%E3%81%A7%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%81%A8-aar-binding-library-%E3%81%AE%E4%BD%9C%E6%88%90%E3%82%92%E3%81%99%E3%82%8B">
<a class="header-anchor-link" href="#visual-studio-%E3%81%A7%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%81%A8-aar-binding-library-%E3%81%AE%E4%BD%9C%E6%88%90%E3%82%92%E3%81%99%E3%82%8B" aria-hidden="true"></a> Visual Studio でプロジェクトと AAR Binding Library の作成をする</h3>
<ol>
<li>VS2019 を起動し、 "Android アプリ (Xamarin)" - "単一ビューアプリ" でプロジェクトを作成します。</li>
<li>ソリューション右クリック → "追加 - 新しいプロジェクト" で "Android バインドライブラリ" を追加します。</li>
<li>バインドライブラリの Jars フォルダに先ほど出力した unityLibrary-release.aar を D&amp;D して追加します。<br>
<img src="https://storage.googleapis.com/zenn-user-upload/7wzulfxz5wh6jn76y87r882mfo51" alt loading="lazy" class="md-img">
</li>
<li>unityLibrary-release.aar を選択し、プロパティの "ビルドアクション" で "LibraryProjectZip" を選択します。<br>
<img src="https://storage.googleapis.com/zenn-user-upload/hme1p6ihy7po09ygkh0a8cuky9k1" alt loading="lazy" class="md-img">
</li>
<li>アプリ側の参照にバインドライブラリを追加します。</li>
</ol>
<p>これで UaaL のコードを Xamarin.Android のアプリ側からアクセスできるようになります。</p>
<h3 id="%E3%82%B3%E3%83%BC%E3%83%89%E3%82%92%E6%9B%B8%E3%81%8F">
<a class="header-anchor-link" href="#%E3%82%B3%E3%83%BC%E3%83%89%E3%82%92%E6%9B%B8%E3%81%8F" aria-hidden="true"></a> コードを書く</h3>
<p>今回は移植なので <a href="https://github.com/Unity-Technologies/uaal-example/tree/master/NativeAndroidApp/app/src/main/java/com/unity/mynativeapp" target="_blank" rel="nofollow noopener noreferrer">元の Java コード</a> を C# に移植します。 Gist に参考実装を上げました (<a href="https://github.com/Unity-Technologies/uaal-example/blob/master/LICENSE.md" target="_blank" rel="nofollow noopener noreferrer">Unity Companion License</a>) 。</p>
<ul>
<li><a href="https://gist.github.com/aosoft/123d317d1271f21866666fc66c4bd2a0" target="_blank" rel="nofollow noopener noreferrer">MainActivity.cs</a></li>
<li><a href="https://gist.github.com/aosoft/63a8b6218cea8a74cb4fdd1f8c2d6d62" target="_blank" rel="nofollow noopener noreferrer">MainUnityActivity.cs</a></li>
</ul>
<p><a href="https://github.com/Unity-Technologies/uaal-example/blob/master/NativeAndroidApp/app/src/main/res/layout/content_main.xml" target="_blank" rel="nofollow noopener noreferrer">content_main.xml</a> も同様に移植する必要がありますが、起動画面の UI は本質ではないので適当でもよいと思います。</p>
<h2 id="xamarin.android-%E5%8C%96%E3%81%AE%E7%B5%90%E6%9E%9C">
<a class="header-anchor-link" href="#xamarin.android-%E5%8C%96%E3%81%AE%E7%B5%90%E6%9E%9C" aria-hidden="true"></a> Xamarin.Android 化の結果</h2>
<p>とりあえず Unity 側の Activity (MainUnityActivity) を起動しようとすると応答なしになり最終的に強制終了になります。元々の Java 版では問題ないですし、 Xamarin.Android で単純な Activity の切り替えは問題ないので UaaL と Xamarin の組み合わせが原因とは思うのですが追及が難しくて断念しました。</p>
<h2 id="%E3%81%8A%E3%82%8F%E3%82%8A%E3%81%AB">
<a class="header-anchor-link" href="#%E3%81%8A%E3%82%8F%E3%82%8A%E3%81%AB" aria-hidden="true"></a> おわりに</h2>
<p>当初はサンプルが動いたらそこからいろいろやってみようと考えていたのですが、一番最初で躓いてしまいました。時間をかければなんとかできそうな感じもしなかったので・・・　もっと低レイヤーなところでデバッガ実行できればなにかわかるかもしれないですが難しいですかね。</p>
<p>Unity と同じ C# でローカル実行とはいっても実行空間は分断されているので Xamarin であるメリットはほぼないのですが、 Xamarin.iOS と合わせて Xamarin.Forms から扱えるとよいかもですね。</p>


Xamarin.Android で Unity as a Library (をやろうとしてうまくいかなった話)

Unity のライブラリを AAR 化する

Visual Studio でプロジェクトと AAR Binding Library の作成をする

Discussion