UAS-Unity

Ringkasan Proyek

UAS-Unity adalah proyek Unity 360/VR tour interaktif yang dirancang untuk mobile (Android) dan editor. Proyek ini menggunakan panorama 360 derajat dengan hotspot navigasi, sistem kontrol gyroscope dan swipe, serta menu pengaturan runtime.

Fitur Utama

• Panorama 360 derajat berbasis sphere environment.
• Hotspot interaktif untuk berpindah antar-ruangan.
• Visual hotspot yang mengambang dan berubah warna saat diarahkan.
• Kontrol gyro untuk perangkat mobile dan swipe gesture untuk rotasi kamera.
• Modal pengaturan runtime dengan toggle kontrol dan orientasi.
• Transisi portal visual saat berpindah ruangan.
• Support untuk build Android menggunakan menu editor Unity.

Struktur Proyek

• Assets/blablabla/Scripts/

  • TourManager.cs: Manajemen ruangan panorama, memuat tekstur, membuat hotspot, dan transisi ruangan.
  • Hotspot.cs: Komponen interaktif pada hotspot, mendeteksi hover dan tap untuk berpindah ruangan.
  • HotspotVisual.cs: Membuat visual hotspot berupa bola, animasi bobbing, dan efek hover.
  • GyroCamera.cs: Mengontrol rotasi kamera berdasarkan input gyroscope, swipe, atau mouse.
  • MobileInputHandler.cs: Mendukung input sentuh dan klik mouse, mendeteksi tap dan swipe.
  • SettingsManager.cs: Menyimpan preferensi kontrol dan orientasi menggunakan PlayerPrefs.
  • SettingsUI.cs: Membangun UI settings di runtime, termasuk tombol gear dan modal pengaturan.
  • CrosshairUI.cs: Crosshair di tengah layar dengan highlight dan fade effect.
  • SwipeRotator.cs: Menangani gesture swipe untuk menambahkan snap turn pada kamera.
  • PortalTransition.cs: Menghasilkan efek transisi portal saat load ruangan baru.

• Assets/Editor/

  • BuildAndroid.cs: Menu editor untuk build APK Android langsung dari Unity.
  • Setup360Tour.cs: Menu editor untuk membuka scene SampleScene dan setup ulang jika root tour hilang.

• Assets/Scenes/SampleScene.unity: Scene utama yang berisi root 360 tour, kamera utama, dan komponen terkait.

• Packages/manifest.json: Dependensi package Unity seperti Universal Render Pipeline, UI, Timeline, Visual Scripting, dan XR/VR support.

• ProjectSettings/ProjectVersion.txt: Unity Editor versi 2023.4.7f1.

Cara Menjalankan

1. Buka proyek di Unity Editor dengan versi yang sesuai (setidaknya 2023.4.x LTS).
2. Buka Assets/Scenes/SampleScene.unity.
3. Pastikan TourManager sudah memiliki daftar rooms dengan panoramaTexture dan hotspot yang valid.
4. Jalankan scene.

Kontrol

• Gyro: Kamera mengikuti rotasi perangkat mobile.
• Swipe: Gerakkan kamera dengan swipe touch.
• Pada editor, Mouse right-click + drag dapat digunakan untuk memutar kamera.
• Tap hotspot untuk berpindah ruangan.
• Tekan tombol gear untuk membuka pengaturan.

Build Android

Di Unity Editor, buka menu 360 Tour > Build Android. Build akan menghasilkan file build/VR-Pert1.apk.

Catatan Penting

• Proyek saat ini belum memiliki .gitignore, maka beberapa file build, library, dan output besar diabaikan.
• File virtual-tour-0.1.0.apk, virtual-tour-0.1.0.x86_64, libdecor-0.so.0, dan direktori build/output bukan bagian dari Git yang ideal untuk project source.
• Untuk repositori publik, sebaiknya simpan hanya source code dan asset penting, tidak termasuk build artifact.

Potensi Pengembangan

• Tambahkan sistem UI informasi hotspot (nama/teks deskripsi).
• Support cross-platform VR headset via XR Interaction Toolkit.
• Tambahkan audio ambient untuk setiap room.
• Optimalkan asset panorama dan compress texture untuk mobile.