Skip to content

About

KOSA 2차 팀 소개 페이지

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

34 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

2조 개발자 도감

포켓몬 골드 스타일로 만든 팀 소개 게임입니다. 인트로와 오박사 대화를 지나 월드맵을 탐험하고, 개발자몬을 만나 퀴즈를 풀어 포획한 뒤 도감에서 팀원 소개, 장비, 맛집 지도, 포획 영상을 확인할 수 있습니다.

주요 기능

기능 내용
인트로 시작 화면, 오박사 대화, 팀 소개 흐름
월드맵 Canvas 기반 타일맵, 플레이어 이동, 충돌, 지형별 인카운터
배틀 개발자별 퀴즈, 몬스터볼 선택/드래그 포획, 배틀 스프라이트 렌더링
포획 영상 포획 장면을 캔버스 스트림으로 녹화해 도감에서 재생
도감 포획한 개발자 상세 정보, 프로필, 프로젝트, 장비 장착
커스텀 아이템 캔버스에 직접 그린 장비를 저장하고 장착
맛집 지도 Kakao Maps SDK와 Geolocation API로 식당/현재 위치 표시
엔딩 4명 모두 포획하면 엔딩 영상 재생
반응형 모바일 화면, 터치 버튼, 드래그 가능한 컨트롤러 지원

사용한 HTML API

API 사용 위치
Geolocation API 도감 맛집 지도에서 현재 위치 표시
Drag and Drop API 도감 장비 드래그 앤 드롭
Web Storage API 세이브 데이터, 커스텀 아이템, 볼륨/컨트롤러 위치 저장
HTML Video 엔딩 영상, 도감 포획 영상 재생
HTML Audio BGM과 효과음 재생

추가로 포획 영상 저장에는 MediaRecorder, canvas.captureStream(), IndexedDB를 사용합니다.

기술 사용 방식

이 프로젝트는 단순히 API를 호출하는 데서 끝내지 않고, 각 기술을 실제 게임 흐름 안에 연결

  • Canvas 2D

    • 월드맵, 플레이어, NPC, 배틀 화면, 포획 장면 직접 렌더링
    • 타일맵 좌표, 충돌 판정, 카메라 이동, 지형별 인카운터 처리
    • 현재 CSS 스타일에 맞춘 배틀 장면 재렌더링 및 포획 영상 녹화 활용
  • Geolocation API

    • 도감 맛집 지도에서 현재 위치 권한 요청
    • Kakao Maps 위에 현재 위치 마커 표시
    • 권한 거부 또는 위치 조회 실패 시 식당 마커만 표시
  • Drag and Drop API

    • 도감 장비 화면에서 개발자별 장비 장착 기능 구현
    • 데스크톱 기본 dragstart, dragover, drop 이벤트 활용
    • 모바일 터치 조작 대응
  • Web Storage API

    • localStorage에 포획 상태, 장착 장비, 커스텀 아이템, 볼륨, 모바일 컨트롤러 위치 저장
    • 새로고침 후 게임 진행 상태와 사용자 설정 유지
  • HTML Video

    • 4명 모두 포획 시 엔딩 영상 재생
    • 도감에서 포획 당시 녹화 영상 <video> 재생
  • HTML Audio

    • BGM과 효과음 분리 재생
    • 사용자 볼륨 설정 저장 및 다음 실행 시 유지
  • MediaRecorder / IndexedDB

    • 포획 성공 순간의 캔버스 스트림을 MediaRecorder로 녹화
    • 생성된 영상 Blob을 IndexedDB에 저장
    • 저장된 Blob을 URL로 변환해 도감에서 영상 재생
  • Kakao Maps SDK

    • 개발자별 추천 식당 좌표를 지도 마커로 표시
    • Geolocation API와 함께 현재 위치와 식당 위치 동시 확인
  • 반응형 CSS

    • 모바일 화면에서도 인트로, 대화, 배틀, 도감, 컨트롤러 사용 가능
    • 화면 폭에 따른 글자 크기, 버튼 크기, 도감 레이아웃, 배틀 UI 조정

실행

GitHub Pages 또는 VS Code Live Server 같은 정적 서버에서 실행합니다.

환경 비고
file:// HTML 조각을 fetch로 불러오기 때문에 비권장
localhost / 127.0.0.1 로컬 개발 권장
GitHub Pages 배포 환경

폴더 구조

pixel-game/
├─ index.html
├─ README.md
├─ app/
│  ├─ app.js
│  ├─ styles.css
│  ├─ common/
│  │  ├─ audio.js
│  │  ├─ controls.js
│  │  └─ storage.js
│  ├─ intro/
│  │  └─ intro.html
│  ├─ dialogue/
│  │  ├─ dialogue.html
│  │  └─ dialogue.js
│  ├─ world/
│  │  ├─ world.html
│  │  ├─ world.js
│  │  └─ world-engine.js
│  ├─ battle/
│  │  ├─ battle.html
│  │  ├─ battle.js
│  │  ├─ battle-sprites.js
│  │  ├─ capture-video.js
│  │  └─ quiz-data.js
│  ├─ pokedex/
│  │  ├─ pokedex.html
│  │  ├─ pokedex.js
│  │  ├─ custom-items.js
│  │  ├─ dragdrop.js
│  │  ├─ restaurant-map.js
│  │  ├─ developer-data.js
│  │  ├─ item-data.js
│  │  ├─ profile-data.js
│  │  └─ restaurant-data.js
│  └─ ending/
│     ├─ ending.html
│     └─ ending.js
└─ assets/
   ├─ audio/
   ├─ battle/
   ├─ map/
   ├─ profile/
   └─ story/

파일 역할

파일 역할
index.html 앱 껍데기, 공통 UI, 스크립트 로드 순서 관리
app/app.js 앱 상태, 화면 HTML 로딩, 상태 전환, 공통 타이핑/토스트
app/styles.css 전체 UI, 배틀/도감/모바일 반응형 스타일
app/common/audio.js BGM, 효과음, 볼륨 저장
app/common/controls.js 키보드, 터치 버튼, 메뉴, 컨트롤러 위치
app/common/storage.js localStorage 세이브/리셋, 커스텀 아이템 저장
app/world/world-engine.js 월드맵 렌더링, 이동, 충돌, 카메라, 인카운터
app/world/world.js 월드 전용 액션
app/battle/battle.js 배틀 진행, 퀴즈 판정, 포획 시퀀스
app/battle/battle-sprites.js 배틀 캐릭터 이미지 preload와 캔버스 렌더링
app/battle/capture-video.js 포획 장면 녹화, IndexedDB 저장, Blob URL 생성
app/battle/quiz-data.js 배틀 퀴즈 데이터
app/pokedex/pokedex.js 도감 목록/상세/영상 표시
app/pokedex/custom-items.js 직접 그린 장비 생성과 등록
app/pokedex/dragdrop.js 장비 드래그 앤 드롭 장착
app/pokedex/restaurant-map.js Kakao Maps, 현재 위치, 식당 마커
app/pokedex/*-data.js 개발자, 장비, 프로필, 식당 데이터
app/dialogue/dialogue.js 오박사 대화 내용과 진행
app/ending/ending.js 엔딩 화면, 엔딩 영상 재생

화면 흐름

flowchart TD
  intro["INTRO: 시작 화면"] --> dialogue["DIALOGUE: 오박사 대화"]
  dialogue --> world["WORLD: 월드맵 탐험"]
  world --> encounter["NPC/지형 인카운터"]
  encounter --> battle["BATTLE: 퀴즈 배틀"]
  battle -->|정답 + 포획 성공| capture["포획 영상 저장"]
  battle -->|오답/도망| world
  capture --> pokedex["도감 등록"]
  pokedex --> complete{"4명 모두 포획?"}
  complete -->|아니오| world
  complete -->|예| ending["ENDING: 엔딩 영상"]
Loading

데이터 흐름

flowchart LR
  developerData["pokedex/developer-data.js"] --> app["app/app.js"]
  itemData["pokedex/item-data.js"] --> pokedex["도감 UI"]
  profileData["pokedex/profile-data.js"] --> pokedex
  restaurantData["pokedex/restaurant-data.js"] --> map["맛집 지도"]
  quizData["battle/quiz-data.js"] --> battle["배틀"]
  app --> worldEngine["world/world-engine.js"]
  app --> storage["localStorage / IndexedDB"]
  battle --> capture["capture-video.js"]
  capture --> indexedDB["IndexedDB: 포획 영상 Blob"]
Loading

저장소

저장소 내용
localStorage.dev_pokedex_save_fs 포획 목록, 장착 아이템, 스탯
localStorage.dev_pokedex_custom_items_fs 직접 그린 커스텀 아이템
localStorage.pixelGameVolume 볼륨
localStorage.pixelGame*PadOffset 모바일 컨트롤러 위치
IndexedDB.dev_pokedex_capture_videos 포획 영상 Blob

자산

폴더 내용
assets/audio/ BGM 파일
assets/battle/ 배틀 캐릭터, 몬스터볼 시트
assets/map/ 월드맵 타일, 플레이어, NPC
assets/profile/ 개발자 프로필 이미지
assets/story/ 오박사 이미지, 엔딩 영상

참고

  • app/는 실제 앱 화면과 로직을 도메인별로 나눈 폴더입니다.
  • assets/는 이미지, 오디오, 영상 같은 정적 자산을 모아둔 폴더입니다.
  • file://로 직접 열면 HTML partial 로딩이 막힐 수 있으니 정적 서버에서 실행해야 합니다.

About

KOSA 2차 팀 소개 페이지

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages