Skip to content

GoldenCreature/AR_MyPet

Repository files navigation

🐾 AR My Pet 프로젝트

🛠 개발 환경

  • Unity Version: 6000.0.68f1
  • Target OS: Android
  • Main Packages: AR Foundation, ARCore Extensions

👥 팀원 및 역할

  • 한종수(팀장): 환경 구축, 빌드 세팅, 시스템 아키텍처(매니저) 설계
  • 김기범: 캐릭터 컨트롤러 및 애니메이션
  • 최민수: 상태 관리 시스템 및 백엔드 로직
  • 사공민규: UI 제작 및 인터페이스 연동

📖 프로젝트 소개

AR My Pet은 스마트폰 카메라로 현실 공간에 가상의 강아지 펫을 소환하고 돌볼 수 있는 안드로이드 AR 반려동물 앱입니다.

AR Foundation과 ARCore를 활용해 실제 바닥 평면을 인식하고, 그 위에 3D 펫 캐릭터를 배치합니다. 펫은 시간이 지남에 따라 배고프고 지루해지므로 먹이를 주고, 함께 놀고, 쓰다듬어 주면서 꾸준히 관리해야 합니다.


✨ 주요 기능

기능 설명
🌍 AR 소환 카메라로 바닥을 스캔한 뒤 터치하면 현실 공간에 펫이 등장
🍖 먹이주기 버튼 클릭으로 포만감을 회복시키고 먹는 애니메이션 재생
🎾 놀아주기 함께 놀아 친밀도와 행복도를 동시에 상승
👆 터치 반응 캐릭터를 직접 터치하면 친밀도가 소폭 상승하고 리액션 애니메이션 재생
📉 시간 경과 스탯 감소 배고픔·친밀도·행복도가 시간이 지날수록 자동으로 감소
🐕 자율 행동 펫이 스스로 주변을 서성이거나 카메라를 바라보는 유휴 행동 수행
📊 상태 UI 포만감·행복도·친밀도를 실시간 슬라이더로 표시

🏗️ 시스템 구조

AR 바닥 감지 (ARPlacementManager)
        │
        ▼ 펫 소환
MyPetManager (싱글톤 · 중앙 컨트롤 타워)
  ├── 버튼 입력 수신 (PetButtonController)
  ├── 상태 로직 위임 ──► PetStatusController
  │                         ├── 스탯 감소 루프 (1초 주기)
  │                         └── 애니메이터 동기화
  └── UI 갱신 ──────────► HungerBar / HappinessBar / MoodBar
                            (상태 변경 이벤트로 실시간 반영)

캐릭터 자율 이동 (AnimalMover)
  └── 랜덤 서성이기 / 카메라 응시 / 터치 리액션

📂 폴더 구조

Assets/
├── HJS/          # 팀장 - AR 배치, MyPetManager (시스템 아키텍처)
├── CMS/          # 최민수 - PetStatusController (상태 관리 & 백엔드 로직)
├── KGB/          # 김기범 - 캐릭터 컨트롤러 & 애니메이션 (AnimalMover)
├── SGMG/         # 사공민규 - UI (StatusBar, SafeArea, 인터페이스 연동)
└── Simple Blocky Dogs Animated/  # 3D 펫 에셋

🚀 빌드 및 실행 방법

  1. Unity 6000.0.68f1 버전으로 프로젝트를 엽니다.
  2. File → Build Settings에서 플랫폼을 Android로 전환합니다.
  3. Player Settings에서 ARCore 지원 여부를 확인합니다.
  4. ARCore를 지원하는 안드로이드 기기를 연결한 뒤 빌드 & 실행합니다.
  5. 앱 실행 후 카메라를 바닥 쪽으로 향하면 AR 평면이 감지되며, 터치하면 펫이 소환됩니다.

About

Unity 6와 AR Foundation을 활용한 지능형 AR 반려동물 육성 시뮬레이션: AR_MyPet

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors