Skip to content

오락 탭과 연타 게임(눌러눌러) 추가 - #83

Open
soyeonLee126 wants to merge 8 commits into
developfrom
add-clicker-game
Open

soyeonLee126 wants to merge 8 commits into
developfrom
add-clicker-game

Conversation

@soyeonLee126

@soyeonLee126 soyeonLee126 commented Nov 18, 2026 •

Copy link
Copy Markdown
Collaborator

작업 개요

하단 탭에 오락 탭을 추가하고, 키를 연타해 게이지를 채우는 게임(눌러눌러)을 구현했습니다. 같은 게임의 웹 버전도 docs/에 함께 넣었습니다.

작업 유형

  • feat: 새 기능
  • fix: 버그 수정
  • refactor: 리팩토링 (동작 변경 없음)
  • build: 빌드/의존성 설정
  • chore: 기타 (문서, 설정 등)
  • test: 테스트 추가/수정

변경 사항

  • 새 모듈 :feature:game을 추가했습니다.
    • 오락 탭 목록 화면(GameListScreen)에 눌러눌러 카드 1개를 두었습니다.
    • 게임 화면(ClickerGameScreen)은 기록 칸, 다시하기, 메모지 속 캐릭터 게이지, 키캡 2개로 구성됩니다.
  • 게임 규칙
    • 키캡 두 개 중 아무 키나 누르면 게이지가 2% 차고, 진행 중에는 초당 10%씩 빠집니다.
    • 게이지를 가득 채우는 데 걸린 시간이 기록입니다. 진행 중에는 0.1초 단위로 흐르고, 채우면 0.01초 단위 기록으로 멈춥니다.
    • 빠지는 속도보다 느리게 누르면 끝나지 않으므로 30초가 지나면 "시간 초과"로 끝냅니다. 제한 시간은 화면에 숫자로 보여 주지 않습니다.
    • 수치는 ClickerGameState.kt의 상수입니다.
  • 캐릭터 게이지
    • 대기 시안 그림 하나로 그립니다. 채움 실루엣을 그림 아래에, 흰 눈·입 레이어를 위에 두고 둘 다 게이지 높이까지만 보이게 잘라 그립니다.
    • 그래서 0%는 대기 시안과 같고, 채움에 덮인 눈·입만 흰색이 됩니다. 진행 중 시안의 캐릭터는 대기 그림을 약 5도 돌린 것이라, 기울기 없이 대기 그림을 그대로 씁니다.
  • 키를 누를 때 효과음을 냅니다. 합성한 짧은 wav를 SoundPool(USAGE_GAME, 미디어 볼륨)로 재생하고, 반영된 입력에만 냅니다.
  • 상태와 recomposition
    • 게임 상태는 순수 data class(ClickerGameState)이고, ClickerGameController가 mutableStateOf로 들고 derivedStateOf로 필요한 값만 내보냅니다.
    • 매 프레임 바뀌는 게이지는 그리기 단계에서만 읽고, 기록은 0.1초 단위로 바뀔 때만 기록 칸만 다시 그립니다.
  • 하단 탭 순서는 보관함, 홈, 대화, 오락입니다. 탭이 4개가 되어 GamssBottomBar의 아이콘 행 폭을 255dp에서 312dp로 넓혔습니다(Figma 탭 5개 시안 기준 값).
  • 화면 진입 이벤트 이름은 game_list, clicker_game입니다.
  • 웹 버전 docs/clicker-game.html
    • 앱 이미지와 효과음을 파일 안에 넣은 단일 HTML입니다.
    • 마우스로도 할 만하도록 웹만 한 번에 4%, 초당 6% 감소로 쉽게 두었습니다.
    • 현재 이 브랜치의 /docs로 GitHub Pages에 게시되어 있습니다: https://nexters.github.io/GAMSS-Android/clicker-game.html

관련 이슈

  • 없음

관련 작업 (Notion)

  • 없음

스크린샷 / 동작 화면

  • Figma: 오락 탭(5563:10384), 게임 초기(5573:8900), 진행 중(5609:9431)

체크리스트

  • base 브랜치가 develop으로 설정되어 있다
  • 로컬 빌드 및 실행을 확인했다
  • 커밋 메시지가 컨벤션(feat:, fix: 등)을 따른다
  • 불필요한 로그/주석/디버그 코드를 제거했다
  • 리뷰어가 이해할 수 있도록 설명을 작성했다

테스트

  • ./gradlew :feature:game:testDebugUnitTest :feature:game:detekt :app:compileDebugKotlin 통과
  • ClickerGameStateTest 8건: 대기, 시작, 게이지 감소와 하한, 진행 중 기록, 가득 참 기록, 50번 만에 가득, 시간 초과, 종료 후 입력 무시
  • ClickerGameControllerTest 4건: 반영 여부, 종료 후 입력, 다시하기, 접근성 게이지 값
  • 실기기(SM-S937N, Android 16, debug)에 설치해 오락 탭, 대기, 진행 중 화면을 Figma와 비교했습니다. 기록 표시로 바꾼 뒤의 화면은 웹(헤드리스 크롬)으로만 확인했습니다.

리뷰 요청 사항

  • 시안과 다른 점
    • 기록 칸: 시안의 남은 시간과 5자리 점수 대신 걸린 시간 하나만 보여 줍니다. 디자이너 확인이 필요합니다.
    • 키캡: 시안(167dp)보다 작은 140dp입니다.
    • 상단바 아래 구분선이 없고, 진행 중 캐릭터가 기울지 않습니다(대기와 동일하게 유지).
    • 결과 화면 시안이 없어 기록 칸에 기록이나 "시간 초과"만 보여 줍니다.
  • 기록은 프레임마다 쌓는 시간이라 첫 탭 직후 1~2프레임이 빠지고, 0.01초 자리는 주사율에 따라 조금 다를 수 있습니다.
  • 하단 탭바 폭 변경(255dp에서 312dp)이 다른 탭 화면에 문제없는지 봐 주세요.

@soyeonLee126

Copy link
Copy Markdown
Collaborator Author

@theminjunchoi 웹 버전을 GitHub Pages에 올려 두었습니다. 우리 도메인으로 옮겨 주실 수 있을까요?

  • 현재 주소: https://nexters.github.io/GAMSS-Android/clicker-game.html
  • 파일: docs/clicker-game.html (이미지를 포함한 단일 HTML)
  • Pages 소스가 지금은 이 PR 브랜치(add-clicker-game)의 /docs입니다. 머지 후 브랜치를 지우면 페이지가 내려가므로, 머지되면 소스를 develop의 /docs로 바꾸겠습니다.

This branch was successfully deployed

1 active deployment
github-pages — 43224203 Deployed Nov 19, 2026 by soyeonLee126 via deploy #4
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant