섬타임

🏝️ 프로젝트 소개

📱 주요 기능

🏝️ 다이나믹 아일랜드 시계 (Live Activity)

• 토글 한 번으로 시작 : 홈에서 토글을 켜면 다이나믹 아일랜드와 잠금 화면에 현재 시각이 표시되어, 전체 화면 영상이나 게임 중에도 상단을 내리지 않고 시간을 확인할 수 있습니다.
• 상황별 최적 표시 : 다이나믹 아일랜드의 컴팩트 · 미니멀 · 확장 상태와 잠금 화면(StandBy)에 맞춰 시계를 각각 알맞게 배치합니다. 확장 화면에서는 날짜와 자동 종료까지 남은 시간도 함께 보여줍니다.
• 가로 모드 지원 (iOS 27+) : 폭이 좁은 가로 모드 다이나믹 아일랜드에서는 카메라 위 · 아래 공간에 시 · 분과 초를 나눠 표시합니다.
• 자동 종료 안내 · 상태 복원 : Live Activity는 시스템 정책상 약 8시간 후 종료되므로 홈에서 "약 N시간 N분 후 자동 종료"처럼 남은 시간을 알려주고, 앱을 다시 실행해도 실행 중인 시계를 감지해 토글 상태를 그대로 복원합니다.

🖼️ PiP 플로팅 시계

• 영상 위에 떠 있는 작은 시계 창 : PiP(화면 속 화면) 창으로 시계를 띄워, 다른 앱 위에서도 항상 시간을 확인할 수 있습니다.
• 두 가지 창 비율 : 영상을 거의 가리지 않는 얇은 10:1 막대형과 모서리에 두기 좋은 2:1 창형 중에서 고를 수 있습니다.
• 자동 표시 : 시계를 켠 상태로 앱을 벗어나면 PiP 창이 자동으로 떠오르며, 재생 중인 음악이나 영상 소리는 끊지 않습니다.
• 기기별 대응 : 다이나믹 아일랜드가 없는 기기(노치 iPhone, iPad 등)에서는 PiP 시계를 주 기능으로 안내합니다.

⏱️ 서버 시간

• 사이트 서버 시각 측정 : 사이트 주소를 입력하고 측정을 누르면 그 사이트 서버의 시각을 맞춰, "내 폰보다 0.42초 빠름 · 오차 ±0.03초"처럼 내 폰과의 차이와 오차를 보여줍니다.
• 원하는 곳에 표시 : 측정한 서버 시간을 다이나믹 아일랜드 또는 PiP 플로팅 시계 중 원하는 곳에 띄울 수 있습니다.
• 밀리초 표시 : PiP에서는 밀리초까지 표시해, 티켓팅처럼 정확한 순간이 필요할 때 활용할 수 있습니다.
• 다시 맞추기 : 시계가 실행 중일 때 다시 측정하면 새로 맞춘 시각이 곧바로 시계에 반영됩니다.

🎟️ 티켓팅 연습

• 정각 클릭 연습 : 09:59:50부터 흐르는 연습 시계를 보고 10:00:00 정각에 예매하기를 누르면, 정각과의 차이를 밀리초 단위로 보여주고 "완벽해요 · 아주 좋아요"처럼 판정합니다. 누른 순간은 −0.5초 ~ +0.5초 타임라인 위에 표시됩니다.
• 포도알 클릭 연습 : 좌석 배치도에서 무작위로 뜨는 빈 좌석(포도알)을 찾아 누르고, 제한 시간 안에 예매하기까지 누르는 연습입니다. 결과 화면에서는 걸린 시간을 "좌석 선택"과 "예매하기까지"로 나눠 보여줍니다.
• 보안 문자 입력 연습 : 그림 속 무작위 영문 6자리를 대소문자 구분 없이 입력하고 입력 완료를 누르는 연습입니다. 틀리거나 새 문자로 바꿔도 시간은 이어서 재며, 결과 화면에서는 통과까지 걸린 시간과 틀린 횟수 · 새로고침 횟수를 보여줍니다.
• 난이도 · 좌석 사라짐 : 쉬움(5초) · 보통(3초) · 어려움(2초) 중에서 고르며, 다른 사람이 먼저 잡은 것처럼 빈 좌석이 하나씩 사라지고 고른 좌석도 뺏길 수 있어 실전처럼 연습할 수 있습니다.
• 연습 기록 : 정각 클릭의 최고 기록 · 최근 10회 평균 · 연습 횟수와 포도알 클릭 · 보안 문자 입력의 난이도별 최고 기록을 기기에 저장합니다.

🎨 나만의 시계 꾸미기

• 4가지 시계 디자인 : 기본 · 굵게 · 모노 · 도트(도트 매트릭스) 디자인을 가로 슬라이드로 골라볼 수 있습니다.
• 6가지 색상 : 화이트 · 앰버 · 민트 · 스카이 · 라벤더 · 코랄 중에서 고르며, 선택한 색상은 시계뿐 아니라 앱 전체의 강조색으로도 쓰입니다.
• 표시 옵션 : 24시간 / 12시간 형식, 초 표시, 오전/오후 표시를 원하는 대로 설정할 수 있습니다.
• 실시간 반영 : 설정 화면의 미리보기는 물론, 이미 켜져 있는 다이나믹 아일랜드 · PiP 시계에도 바뀐 설정이 즉시 적용됩니다.

⚙️ 설정

• 앱 언어 : 시스템 설정의 섬타임 페이지로 바로 이동해 앱 언어를 바꿀 수 있습니다.
• 문의하기 : 기기 · iOS · 앱 버전 정보가 자동으로 채워진 메일 작성 화면을 띄우고, 메일 앱을 쓸 수 없으면 문의 정보를 복사할 수 있습니다.
• 개인정보 처리방침 : 앱 안에서 바로 확인할 수 있습니다.

🌏 다국어 지원

• 한국어 · 영어 · 일본어 : String Catalog 기반으로 세 개 언어를 지원하며, 앱 이름도 언어에 맞게 섬타임 / SomTime으로 표시됩니다.

👥 팀 소개

프로필	이름	역할	담당 업무	GitHub
	허성필	PM, iOS	프로젝트 매니징, Live Activity · PiP 시계 구현, 서버 시간 측정, 설정 기능, UI 컴포넌트 개발	🔗

🛠 기술 스택 (Tech Stack)

분류	기술 명세
Architecture	TCA (The Composable Architecture)
UI Framework	SwiftUI, WidgetKit
Live Activity	ActivityKit (Dynamic Island / Lock Screen Live Activity)
Picture in Picture	AVKit (AVPictureInPictureController), AVFoundation (AVSampleBufferDisplayLayer, AVAudioSession), CoreMedia, CoreVideo
Async / State	Swift Concurrency (async/await, AsyncStream), TCA Dependencies, Swift Sharing (@Shared)
Network	URLSession (HTTP Date 헤더 기반 서버 시각 측정)
Storage	App Group UserDefaults, App Group Container (File Storage)
System	WebKit(WebView), MessageUI(Mail), OSLog
Font	Pretendard, Doto (위젯 확장은 서브셋 폰트 사용)
Localization	String Catalog (.xcstrings) — 한국어 / 영어
Deployment	iOS 18.0+, iPhone / iPad, Swift 5.0
Ads	Google Mobile Ads SDK (AdMob), User Messaging Platform (UMP)

💡 기술적 의사결정 (iOS)

아키텍처 : TCA (The Composable Architecture)

• 단방향 데이터 흐름 : 시계는 홈의 아일랜드 · PiP 토글과 서버 시간 화면 등 여러 곳에서 켜고 끌 수 있어 상태가 꼬이기 쉽습니다. 모든 시계 전환을 HomeFeature 리듀서로 모아, 서버 시간 시계와 일반 시계가 동시에 켜지지 않는 규칙을 한 곳에서 보장했습니다.
• 기능 조합(Composition) : 홈 · 설정 · 서버 시간 · 개인정보 처리방침을 각각의 Reducer로 분리하고 @Reducer enum Destination과 ifLet으로 화면 전환을 조합했습니다. 서버 시간 화면은 delegate 액션으로 시작 · 종료만 요청하고 실제 시계 제어는 홈이 맡아 책임을 나눴습니다.

의존성 관리 : TCA Dependencies

• 부수효과 격리 : Live Activity, PiP, 서버 시각 측정을 각각 LiveActivityClient · PipClockClient · ServerTimeClient로 정의하고 @Dependency로 주입해, ActivityKit · AVKit · 네트워크 같은 시스템 의존성을 리듀서 밖으로 분리했습니다.
• 교체 가능성 : @DependencyClient로 클라이언트를 추상화해, 테스트와 프리뷰 환경에서 손쉽게 대체할 수 있도록 설계했습니다.

상태 공유 : Swift Sharing + App Group

• 설정 즉시 반영 : 시계 디자인 · 색상 · 시간 형식을 @Shared(.appStorage)로 App Group UserDefaults에 저장해, 설정 화면에서 값을 바꾸는 즉시 홈 · Live Activity · PiP가 같은 값을 바라보도록 했습니다.
• 수명에 맞는 저장소 선택 : 서버 시간 측정 결과는 fileStorage로 App Group 컨테이너에, 실행 중인 서버 시간 시계는 inMemory로 관리해 데이터의 수명에 맞게 저장 위치를 나눴습니다.

Live Activity 시계 : 시스템이 갱신하는 현재 시각

• 매초 업데이트 없이 흐르는 시계 : Live Activity는 앱이 매초 업데이트하는 구조가 아니므로, Text(.currentDate, format:)로 시스템이 직접 시각을 갱신하게 했습니다. 앱은 설정이 바뀔 때만 Live Activity를 업데이트합니다.
• 최소 지원 버전 iOS 18 : iOS 17에서 쓸 수 있는 Text(timerInterval:) 방식은 자정이 지나면 24:00:xx로 넘어가는 문제가 검증 과정에서 확인되어, 최소 지원 버전을 iOS 18.0으로 올렸습니다.
• 기기 설정과 무관한 시간 형식 : 지역 기반 Date.FormatStyle은 기기의 24시간제 설정에 따라 표시가 달라져, Date.VerbatimFormatStyle로 형식을 직접 지정했습니다. 한글 글자가 없는 폰트(모노 · 도트)의 12시간제는 "오후" 대신 AM/PM으로 표시합니다.
• 가로 모드 다이나믹 아일랜드 : isDynamicIslandLimitedInWidth 환경 값으로 분기해, 폭이 제한된 가로 아일랜드에서는 카메라 위에 시 · 분, 아래에 초를 나눠 그리고 ViewThatFits로 글자 크기를 단계적으로 맞췄습니다.
• 아카이브 용량 제한 대응 : 커스텀 폰트가 포함된 Live Activity 아카이브가 용량 제한을 넘어 시작 직후 종료되는 문제가 있어, 위젯 확장에는 필요한 글자만 담은 Pretendard 서브셋 폰트(약 59KB)를 포함했습니다.

PiP 시계 : SwiftUI 화면을 영상 프레임으로

• 렌더링 파이프라인 : PiP는 영상만 띄울 수 있으므로, SwiftUI 시계 뷰를 ImageRenderer로 그려 CVPixelBuffer → CMSampleBuffer로 변환한 뒤 AVSampleBufferDisplayLayer에 넣어 AVPictureInPictureController로 띄웠습니다. 창을 키워도 선명하도록 6배 해상도로 그리고, 픽셀 버퍼 풀을 재사용합니다.
• 프레임 간격 최적화 : 일반 시계는 초가 바뀌는 순간에 맞춰 1초에 한 번만 그리고, 밀리초를 표시할 때만 약 30fps로 그려 배터리 소모를 줄였습니다.
• 다른 앱과의 공존 : 오디오 세션을 .playback + .mixWithOthers로 설정해 다른 앱의 소리를 끊지 않으며, canStartPictureInPictureAutomaticallyFromInline으로 앱이 백그라운드로 갈 때 PiP가 자동으로 시작되도록 했습니다.

서버 시간 측정 : HTTP Date 헤더 + 초 경계 탐색

• Date 헤더 활용 : 사이트에 HEAD(막히면 GET) 요청을 보내 응답의 Date 헤더로 서버 시각을 얻습니다. 본문은 받지 않고 헤더가 도착하는 즉시 요청을 끊어 왕복 시간을 줄였습니다.
• 초 단위 한계 극복 : Date 헤더는 초 단위라, 응답 순간의 서버 시각이 [S, S+1) 범위에 있다는 점을 이용했습니다. 네트워크 지연을 왕복 시간의 절반으로 보정한 여러 표본의 범위를 교집합으로 좁혀, 폰 시각 대비 오프셋과 오차(±) 를 계산합니다.
• 초 경계 겨냥 요청 : 처음에는 1초 안의 여러 위치에 고르게 요청을 보내고, 이후에는 추정한 "서버 초가 바뀌는 순간"에 요청이 닿도록 시점을 맞춰 보내 오차 범위를 빠르게 좁혔습니다.
• 오프셋 적용 : 측정 결과는 오프셋으로 저장해 표시할 때 폰 시각 + 오프셋을 사용합니다. PiP는 밀리초까지 그대로 더하고, Live Activity는 시스템 갱신 텍스트에 오프셋만큼 옮긴 시간대(TimeZone)를 적용했습니다.

기기별 대응

• 다이나믹 아일랜드 판별 : 다이나믹 아일랜드 유무를 알려주는 공식 API가 없어 Safe Area inset으로 판별하고, 아일랜드가 없는 기기에서는 PiP를 주 기능으로 안내했습니다.

광고 : AdMob 배너 + UMP 동의

• 동의 → SDK 시작 → 광고 요청 순서 보장 : 앱 실행 시 홈에서 UMP로 동의 정보를 갱신하고, 동의가 필요한 지역(EEA · 영국 · 스위스)에서만 동의 창을 띄운 뒤 광고를 요청할 수 있을 때만 SDK를 시작합니다. 결과는 @Shared(.adConsent) 하나에 저장해 모든 화면의 배너와 설정 화면이 같은 값을 읽습니다.
• 화면별 광고 단위 : 홈 · 티켓팅 연습 · 설정 · 서버 시간에 광고 단위를 따로 두어 화면별 성과를 확인할 수 있게 했고, Debug 빌드는 Google 테스트 광고 단위로 고정해 개발 중 실제 광고 노출 · 클릭을 막았습니다.
• 레이아웃 안정성 : safeAreaInset으로 화면 하단에 고정하고, 동의 확인 · 로딩 중에는 배너 높이만큼 자리를 비워 두며, 광고를 받지 못하면 자리를 접어 레이아웃이 흔들리지 않게 했습니다.
• 배너 크기 선택 : SDK 13이 권장하는 large 배너(최대 150pt)는 시계 앱 화면에 너무 커서, 목업과 같은 높이(약 55pt)의 표준 적응형 배너를 선택했습니다.
• 실수 클릭 방지 : 빠르게 연달아 누르는 연습 화면과 키보드가 떠 있는 동안에는 배너를 넣지 않고, 버튼 · 카드와 24pt 이상 간격을 두며, 광고 소재가 배너 영역 밖으로 넘치지 않도록 잘랐습니다.

📸 App Previews

🚀 Release History

Version	Date	Description
v26.0.0	2026.10.10	첫 공식 배포 (Initial Release)
v26.1.0	2026.10.15	티켓팅 연습 기능 추가 (정각 클릭, 포도알 클릭)
v26.2.0	2026.10.20	애드몹(AdMob) 광고 배너 추가, 일본어 지원
v26.3.0	2026.10.22	목표 시각 카운트다운 · 알림 · 진동 기능 추가, PiP 시계 깜빡임 추가
v26.3.1	2026.10.26	보안 문자 연습 기능 추가, 목표 시간 10초 후 서버 시계 자동 꺼짐 기능 추가

🌳 프로젝트 구조

SomTime/
├── SomTime/                                # 앱 메인 타깃
│   ├── SomTimeApp.swift                    # 앱 진입점
│   ├── Info.plist                          # 앱 Info.plist (폰트, 백그라운드 오디오 모드, AdMob 앱 ID · SKAdNetwork)
│   ├── InfoPlist.xcstrings                 # 앱 이름 다국어 리소스 (섬타임 / SomTime)
│   ├── Localizable.xcstrings               # 다국어 문자열 리소스 (한국어 / 영어 / 일본어)
│   ├── SomTime.entitlements                # App Group 권한 (앱↔위젯 데이터 공유)
│   │
│   ├── Features/                           # 기능별 화면 모듈 (View · Feature)
│   │   ├── Home/                           # 홈 (시계 토글 · 미리보기, 시계 전환의 중심)
│   │   │   ├── HomeFeature.swift
│   │   │   ├── HomeView.swift
│   │   │   └── HomePreviewArea.swift       #  └ 아일랜드 · PiP 창 미리보기
│   │   ├── ServerTime/                     # 서버 시간 (측정 · 표시 방식 선택 · 시작)
│   │   │   ├── ServerTimeFeature.swift
│   │   │   ├── ServerTimeView.swift
│   │   │   └── ServerTimeModels.swift
│   │   ├── Settings/                       # 설정 (디자인 · 색상 · 표시 옵션 · 문의하기 · 광고 개인정보 설정)
│   │   │   ├── SettingsFeature.swift
│   │   │   ├── SettingsView.swift
│   │   │   └── MailComposeView.swift
│   │   ├── TicketingPractice/              # 티켓팅 연습 (정각 클릭 · 포도알 클릭)
│   │   │   ├── TicketingPracticeFeature.swift
│   │   │   ├── TicketingPracticeView.swift #  └ 연습 선택 화면
│   │   │   ├── TimingPracticeFeature.swift
│   │   │   ├── TimingPracticeView.swift    #  └ 정각 클릭 연습
│   │   │   ├── SeatPracticeFeature.swift
│   │   │   ├── SeatPracticeView.swift      #  └ 포도알 클릭 연습
│   │   │   └── TicketingPracticeModels.swift
│   │   └── PrivacyPolicy/                  # 개인정보 처리방침
│   │       ├── PrivacyPolicyFeature.swift
│   │       └── PrivacyPolicyView.swift
│   │
│   ├── Clients/                            # TCA Dependency Client
│   │   ├── LiveActivityClient.swift        # Live Activity 시작 · 업데이트 · 종료 (ActivityKit)
│   │   ├── PipClockClient.swift            # PiP 시계 시작 · 업데이트 · 종료
│   │   ├── ServerTimeClient.swift          # 서버 시각 측정 (HTTP Date 헤더)
│   │   └── AdClient.swift                  # 광고 동의 확인 · SDK 시작 · 광고 개인정보 설정
│   │
│   ├── Ads/                                # AdMob 배너 광고
│   │   ├── AdController.swift              # UMP 동의 처리 · Google Mobile Ads SDK 시작
│   │   ├── AdPlacement.swift               # 화면별 광고 단위 ID (Debug는 테스트 광고)
│   │   └── BannerAdView.swift              # SDK BannerView를 감싼 UIViewRepresentable
│   │
│   ├── PictureInPicture/                   # PiP 시계 구현
│   │   ├── PipClockController.swift        # AVPictureInPictureController · 오디오 세션 관리
│   │   └── PipClockFrameRenderer.swift     # SwiftUI 시계 → CMSampleBuffer 렌더링
│   │
│   ├── Components/                         # 공통 UI 컴포넌트
│   │   ├── AdBannerSlot.swift              # 화면 하단 광고 배너 자리
│   │   ├── Chip.swift
│   │   ├── ColorSwatch.swift
│   │   ├── DesignCard.swift
│   │   ├── DifficultyButton.swift
│   │   ├── FeatureCard.swift
│   │   ├── HomeTile.swift
│   │   ├── IconButton.swift
│   │   ├── IconTile.swift
│   │   ├── IslandPill.swift
│   │   ├── MiniSeatGrid.swift
│   │   ├── PipClockWindow.swift
│   │   ├── PracticeClockText.swift
│   │   ├── PracticeModeCard.swift
│   │   ├── PrimaryButton.swift
│   │   ├── RecordList.swift
│   │   ├── ResultIcon.swift
│   │   ├── ScreenHeader.swift
│   │   ├── SeatButton.swift
│   │   ├── SegmentedPicker.swift
│   │   ├── SelectionButton.swift
│   │   ├── SwitchIndicator.swift
│   │   ├── TimeBreakdownBar.swift
│   │   ├── ToastMessage.swift
│   │   ├── URLInputField.swift
│   │   └── WebView.swift
│   │
│   ├── Storage/                            # @Shared 저장 키
│   │   ├── AdSharedKeys.swift              # 광고 동의 상태 (inMemory)
│   │   ├── ClockSettingsSharedKeys.swift   # 시계 설정 (App Group UserDefaults)
│   │   ├── ServerTimeSharedKeys.swift      # 서버 시간 입력값 · 측정 결과 · 실행 상태
│   │   └── TicketingPracticeSharedKeys.swift  # 티켓팅 연습 기록 · 옵션 (앱 전용 저장소)
│   │
│   ├── Extensions/                         # 디자인 · 색상 · PiP 비율 · 난이도 표시 이름
│   │   ├── ClockColor+Name.swift
│   │   ├── ClockDesign+Name.swift
│   │   ├── PipAspectRatio+Name.swift
│   │   └── TicketingPractice+Name.swift
│   │
│   ├── Utilities/
│   │   ├── DeviceCapability.swift          # 다이나믹 아일랜드 · PiP 지원 여부 판별
│   │   └── UINavigationController+SwipeBack.swift  # 스와이프 백 제스처
│   │
│   ├── Resources/                          # 개인정보 처리방침 HTML (ko / en / ja)
│   └── Assets.xcassets/                    # 앱 아이콘
│
├── Shared/                                 # 앱 · 위젯 확장 공유 코드
│   ├── ClockActivityAttributes.swift       # Live Activity 공유 Attributes
│   ├── ClockDisplaySettings.swift          # 시계 표시 설정 묶음 (서버 시간 오프셋 포함)
│   ├── ClockSettingsStorage.swift          # App Group UserDefaults 키 · 기본값
│   ├── ClockTimeFormatter.swift            # 시각 문자열 형식 (VerbatimFormatStyle)
│   ├── ClockDesign.swift                   # 시계 디자인 (기본 · 굵게 · 모노 · 도트)
│   ├── ClockColor.swift                    # 시계 색상 6종 · 강조색
│   ├── PipAspectRatio.swift                # PiP 창 비율 (10:1 · 2:1)
│   ├── ServerTimeClock.swift               # 서버 시간 시계 정보 (호스트 · 오프셋)
│   ├── DesignMetrics.swift                 # 디자인 수치
│   ├── FontStyle.swift                     # 폰트 스타일 정의
│   ├── SharedAssets.xcassets/              # 디자인 토큰 · 시계 색상 에셋
│   └── Fonts/                              # Pretendard, Doto
│
└── SomTimeWidget/                          # 위젯 익스텐션 타깃 (다이나믹 아일랜드 / Live Activity)
    ├── SomTimeWidgetBundle.swift           #  └ 위젯 번들 진입점
    ├── ClockLiveActivity.swift             #     잠금 화면 · 다이나믹 아일랜드 UI
    ├── IslandClockViews.swift              #     컴팩트 · 미니멀 · 가로 모드 시계 뷰
    ├── LiveClockText.swift                 #     시스템이 갱신하는 현재 시각 텍스트
    ├── Fonts/                              #     Live Activity 용량 제한용 Pretendard 서브셋
    ├── Localizable.xcstrings               #     위젯 다국어 문자열
    ├── SomTimeWidgetExtension.entitlements #     위젯 App Group 권한
    └── Info.plist                          #     위젯 익스텐션 Info.plist

License

Copyright © 2026 Seongpil Heo. All rights reserved.