Menggunakan file sumber Java atau Kotlin sebagai plug-ins
Tautan dalam di Android

Mengintegrasikan Unity ke aplikasi Android

Halaman ini menjelaskan bagaimana untuk mengintegrasikan Perpustakaan Ketertiban Unity ke aplikasi Android menggunakan fitur Unity sebagai Perpustakaan.

Anda dapat menggunakan fitur ini untuk menyertakan fitur berkekuatan Unity, seperti 3D / 2D Rendering Real-Time, AR Experience, interaksi model 3D, atau 2D mini-games, ke aplikasi Anda. Perpustakaan Runtime Unity mengekspos kontrol untuk mengelola kapan dan bagaimana memuat, mengaktifkan, dan membongkar konten dalam aplikasi.

Important: Jika Anda meningkatkan proyek Anda ke Unity 2019.4 atau di atas, pengenalan Unity sebagai Perpustakaan mungkin memerlukan Anda untuk menyesuaikan native dan managed plug-insSatu set kode yang dibuat di luar Unity yang menciptakan fungsi dalam Unity. Ada dua jenis plug-ins yang dapat Anda gunakan di Unity: Managed plug-ins (diproduksi. Rakitan NET dibuat dengan alat-alat seperti Studio Visual) dan plug-ins asli (pustaka kode asli yang spesifik platform). More info
Lihat di Glossary
untuk bekerja dengan benar untuk Android. Plug-ins yang membuat perubahan pada manifestasi GradleSistem build Android yang mengotomatiskan beberapa proses build. Otomasi ini berarti bahwa banyak kesalahan build umum cenderung terjadi. More info
Lihat di Glossary
perlu menggunakan perubahan Gradle yang diuraikan dalam .

How it works

Anda tidak perlu melakukan apa pun yang berbeda ketika Anda membangun proyek Gradle Anda dari Unity.

Setiap Proyek Gradle Android yang menghasilkan Unity memiliki struktur berikut:

  • Bagian perpustakaan dalam modul unityLibrary yang dapat Anda mengintegrasikan ke proyek Gradle lainnya. Ini berisi runtime Unity dan data Pemain.
  • Bagian peluncur tipis dalam launcher module yang mengandung nama aplikasi dan ikonnya. Ini adalah aplikasi Android sederhana yang meluncurkan Unity. Anda dapat mengganti modul ini dengan aplikasi Anda sendiri.

Untuk mengintegrasikan Unity ke proyek Gradle Android lain, Anda harus menyertakan modul unityLibrary dari proyek Gradle Android yang dihasilkan di Proyek Unity Android Anda melalui file Sitemap Login.

repository ini berisi proyek contoh dan plug-ins yang menunjukkan cara mengintegrasikan Unity ke aplikasi Android, bersama dengan dokumentasi lebih lanjut.

Untuk mengontrol Pemain, relai Intent untuk meluncurkan aktivitas Unity dan memperluasnya jika diperlukan. Untuk informasi lebih lanjut, lihat dokumentasi pengembang Android pada Filter Intents dan Intent. Anda juga dapat menggunakan API UnityPlayer Java.

IUnityPlayerLifecycleEvents

Login Acara menyediakan cara untuk berinteraksi dengan dua peristiwa siklus hidup penting dari Pemain Unity:

  • Unload - Aplikasi panggilan IUnityPlayerLifecycleEvents.onUnityPlayerUnloaded ketika Application.Unload atau UnityPlayer.unload() membongkar Unity Player. Ini menempatkan Unity Player dalam keadaan jeda di mana ia membongkar semua ScenesAdegan berisi lingkungan dan menu permainan Anda. Pikirkan setiap file Adegan unik sebagai tingkat yang unik. Di setiap Adegan, Anda menempatkan lingkungan, hambatan, dan dekorasi, pada dasarnya merancang dan membangun permainan Anda dalam potongan-potongan. More info
    Lihat di Glossary
    , tetapi menyimpan semua yang lain dimuat dalam memori.
  • Quit - Aplikasi panggilan IUnityPlayerLifecycleEvents.onUnityPlayerQuitted ketika Pemain Unity berhenti. Proses yang berjalan Unity berakhir setelah panggilan ini.

Anda dapat melewati contoh IUnityPlayerLifecycleEvents ke konstruktor UnityPlayer, atau untuk menimpa metode dalam subklas UnityPlayer dan UnityPlayerActivity.

Limitations

Unity tidak mengontrol siklus hidup runtime, sehingga Unity sebagai Perpustakaan mungkin tidak bekerja untuk semua kasus penggunaan yang mungkin. Batasan yang diketahui termasuk:

  • Unity sebagai Perpustakaan hanya mendukung rendering layar penuh, dan tidak mendukung rendering pada bagian layar.
  • Anda tidak dapat memuat atau mengintegrasikan lebih dari satu kasus runtime Unity.
  • Anda mungkin perlu untuk menyesuaikan plug-in pihak ketiga (baik native dan managed) untuk bekerja dengan runtime Unity.

  • Unity sebagai Perpustakaan untuk Android ditambahkan di .NewIn20193
Menggunakan file sumber Java atau Kotlin sebagai plug-ins
Tautan dalam di Android