👄 HearWithEyes

"Experience the world of the Deaf — read lips, not sound." "소리가 아닌 입술로 읽는다 — 청각장애인의 세상을 경험하세요."

입술의 움직임만으로 말을 읽는 독화(lip reading) 를 직접 체험하며,
청각장애인의 일상을 공감할 수 있는 Swift Playgrounds 인터랙티브 앱입니다.

An interactive Swift Playgrounds app where you experience lip reading —
the technique deaf and hard-of-hearing people use to understand speech through visual cues alone.

🌟 소개 / Introduction

전 세계 4억 6천 6백만 명 이상이 청각장애를 가지고 있습니다.
그들에게 독화는 특기가 아닌 매일의 생존 수단입니다.
하지만 영어에서 입술로 명확히 보이는 소리는 전체의 30~40%에 불과합니다.

이 앱은 당신을 단 몇 분간 그 세상으로 초대합니다.

Over 466 million people worldwide live with disabling hearing loss.
For many of them, lip reading is not a party trick — it's a daily necessity.
Yet only 30–40% of English sounds are clearly visible on the lips.

This app invites you to step into that world — and walk away with deeper empathy.

📱 스크린샷 / Screenshots

인트로 / Intro	독화 체험 / Lip Reading	퀴즈 / Quiz
(스크린샷 추가 예정)	(스크린샷 추가 예정)	(스크린샷 추가 예정)

✨ 기능 / Features

🎬 독화 체험 / Lip Reading Experience

• 말하는 사람의 GIF와 뭉개진 음성을 함께 재생
• 버튼을 누르면 영상과 음성이 동시에 시작되어 독화 환경을 그대로 재현
• Press a button to play a GIF of a person speaking alongside a muffled audio clip — simulating the real lip reading experience

🧩 3지선다 퀴즈 / Multiple Choice Quiz (3 Options)

• 영상을 보고 3개의 보기 중 말하고 있는 문장을 선택
• 4단계 난이도(Easy / Medium / Hard / Expert)로 구성
• Watch the GIF and choose the correct phrase from 3 options
• 4 difficulty levels: Easy / Medium / Hard / Expert

🗂 프로젝트 구조 / Project Structure

HearWithEyes.swiftpm/
├── Package.swift
├── Sources/
│   └── App/
│       ├── LipReadingApp.swift         # 앱 진입점 / App entry point
│       ├── ContentView.swift           # 탭 네비게이션 + 인트로 / Tab navigation + Intro
│       ├── PhraseDetailView.swift      # GIF + 음성 재생 + 3지선다 퀴즈 / Playback + Quiz
│       ├── Models/
│       │   └── Phrase.swift            # 데이터 모델 (난이도 포함) / Data model with difficulty
│       └── Helpers/
│           ├── GIFImageView.swift      # UIKit 기반 GIF 렌더러 / GIF renderer
│           └── AudioManager.swift      # AVAudioPlayer 래퍼 / Audio wrapper
└── Sources/App/Resources/
    ├── phrase_01.gif
    ├── phrase_01_muffled.mp3
    └── ...

실행 방법 / How to Run

1. 이 저장소를 클론하거나 다운로드합니다.
   Clone or download this repository.

2. HearWithEyes.swiftpm을 Xcode 15+ 또는 Swift Playgrounds 4.4+ 에서 엽니다.
   Open HearWithEyes.swiftpm in Xcode 15+ or Swift Playgrounds 4.4+.

3. GIF와 MP3 파일을 Sources/App/Resources/에 추가합니다 (phrase_01.gif, phrase_01_muffled.mp3 형식).
   Add your GIF and MP3 files to Sources/App/Resources/ following the naming convention.

4. 실행 대상을 iPad 시뮬레이터 또는 연결된 iPad로 선택합니다.
   Select an iPad Simulator or a connected iPad as the run target.

5. 실행 (▶️) 버튼을 누릅니다.
   Press Run (▶️).

⚠️ Mac Catalyst는 지원하지 않습니다. iPad 타겟을 사용하세요.
⚠️ Mac Catalyst is not supported. Please use an iPad target.

🍎 Apple Swift Student Challenge 2026 Win

Built with Swift Playgrounds · No third-party libraries used · SwiftUI only