ドキュメント

Unity Engine

Unity Engine

AndroidアプリケーションへのUnityの統合

Unity ランタイムライブラリを Android アプリケーションに統合する方法を説明しています。
読み終わるまでの所要時間 7 分最終更新 6日前

このページでは、Unity のライブラリとしての特徴を使用して Unity ランタイムライブラリを Android アプリケーションに統合する方法について説明します。
この特徴を使用して、3D/2D リアルタイムレンダリング、AR 体験、3D モデルインタラクション、2D ミニゲームなどの Unity 搭載の機能をアプリケーションに組み込むことができます。Unity ランタイム ライブラリ は、アプリケーション内のコンテンツのロード、アクティブ化する化、アンロードのタイミングと方法を管理するためのコントロールを公開します。
重要
プロジェクトに Unity as a Library を導入すると、Android で正しく機能するように ネイティブ および マネージ プラグインを適応させる必要がある場合があります。Gradle マニフェストを変更するプラグインは、iOS/Android ネイティブアプリケーションでの Unity のライブラリとしての使用 で説明されている Gradle の変更を使用する必要があります。

しくみ

Unity から Gradle プロジェクトをビルドする場合は、何も変更する必要はありません。
Unity が生成するすべての Android Gradle プロジェクトは以下の構造体を持ちます。
  • ほかの Gradle プロジェクトに統合することができる unityLibrary モジュールのライブラリ部分。Unity ランタイムとプレイヤーデータが含まれます。
  • Launcher モジュールの薄いランチャー部分。アプリケーション名とそのアイコンが含まれています。Unity を起動する簡単な Android アプリケーションです。このモジュールを独自のアプリケーションに置き換えることができます。
Unity を別の Android Gradle プロジェクトに統合するには、生成された Android Gradle プロジェクトの unityLibrary モジュールを settings.Gradle ファイルを通して Android Unity プロジェクトに含める必要があります。
このリポジトリには、Unity を Android アプリに統合する方法を示すサンプルプロジェクトとプラグインが、その他のドキュメントとともに含まれています。
プレイヤーをコントロールするには、Unityアクティビティを起動するインテントをRelayし、必要に応じて拡張します。詳細については、インテントとインテント フィルタに関する Android 開発者ドキュメントを参照してください。UnityPlayer Java API を使用することもできます。

IUnityPlayerLifecycleEvents

IUnityPlayerLifecycleEvents は、Unity Player の 2 つの重要なライフサイクルイベントと対話する方法を提供します。
  • アンロード -
    Application.Unload
    または
    UnityPlayer.unload()
    が Unity Player をアンロードするときに、アプリケーションが
    IUnityPlayerLifecycleEvents.onUnityPlayerUnloaded
    を呼び出します。これにより、Unity Player は一時停止ステートになり、すべてのシーンがアンロードされますが、その他はすべてメモリにロードされたままになります。
  • 終了 - Unity Player が終了すると、アプリケーションが
    IUnityPlayerLifecycleEvents.onUnityPlayerQuitted
    を呼び出します。Unity を実行していたプロセスは、このコールの後に終了します。
IUnityPlayerLifecycleEvents
のインスタンスを UnityPlayer コンストラクタに渡したり、
UnityPlayer
と
UnityPlayerActivity
のサブクラスのメソッドをオーバーライドしたりできます。

制限事項

Unityはランタイム ライフサイクルをコントロールしません。そのため、ライブラリとしてのUnityは、すべてのユースケースで機能するわけではありません。既知の制限事項は以下のとおりです。
  • ライブラリとしての Unity は、全画面のレンダリングのみをサポートします。ただし、Unity Industry のお客様は、制限と機能が異なる場合があります。
  • Unity ランタイムの複数のインスタンスをロードまたは統合することはできません。
  • Unity ランタイムで動作するようにサードパーティのプラグイン (ネイティブとマネージの両方) を適応させる必要がある場合があります。
  • ライブラリとしての Unity は、Xamarin アプリプラットフォームと互換性がありません。
  • Unity ランタイムライブラリを動的モジュールとして再生特徴配信と統合することはできません。

追加リソース