앱인 척하는웹
웹뷰 경험 · 신분증 자동 촬영앱 안에서 열리는 웹 화면이 네이티브처럼 움직이게 만들고, 웹 신분증 촬영을 네이티브와 같은 자동 촬영으로 바꿔 여러 채널에 공용으로 묶었어요.
01Problem
- 웹뷰 화면이 네이티브와 다르게 전환되고, iOS 스와이프 백과 겹치면 애니메이션이 두 번 재생됐어요.
- 웹과 웹뷰는 인증·라우팅 요구가 다른데 경계가 흐려, 웹뷰에서 401 사고가 났어요.
- 웹 신분증 촬영이 수동 셔터라 첫 시도 실패와 재촬영이 잦았고, 셔터 연타로 사진이 중복 전송됐어요.
02Transition
네이티브 같은 화면 전환
한 번에 정해지지 않았어요. 네 가지 방식을 직접 만들어 보고, iOS 스와이프 백까지 견줘 골랐어요.
| 방식 | 스와이프 백 | 걸림돌 |
|---|---|---|
| Stackflow | ○ | 매끄럽지만 지금 라우터와 함께 쓸 수 없어, 앱 전체의 라우팅을 바꿔야 해요. |
| 직접 구현 이전 화면을 복제해 깔기 | ✕ | 코드가 복잡해요. 동료 리뷰에서도 「너무 복잡하다」는 의견을 받았어요. |
| ssgoi | ○ | 탭처럼 나란한 화면 사이에서만 쓸 수 있어요. |
| 라우터의 View Transitions ✓ | ✕ | 가장 매끄럽고 단순해요. 스와이프 백만 해결하면 돼요. |
그래서 가장 단순한 표준 API를 고르고, 남은 문제인 스와이프 백만 따로 잡기로 했어요.
방문 기록의 순서로 앞으로 가는지 뒤로 가는지를 판단해서, 들어갈 땐 새 화면이 오른쪽에서 덮고 밑 화면은 왼쪽으로 밀리며 살짝 어두워져요. 나올 땐 그 반대로 움직여요. iOS 네이티브 화면 전환과 같은 모양이에요.
문제는 iOS의 스와이프 백이었어요. 화면 왼쪽 끝을 밀면 OS가 이미 이전 화면을 끌어와 보여 주는데, 손을 떼면 웹 전환이 한 번 더 재생돼 화면이 두 번 움직였어요. 브라우저는 「OS가 뒤로 가기를 했다」고 알려 주지 않아서, 터치 좌표로 추정했어요.
- 왼쪽 끝에서 시작했나터치가 화면 왼쪽 끝 50px 안에서 시작했는지 봐요.
- 오른쪽으로 밀었나세로보다 가로로 더 움직였고 오른쪽으로 5px 넘게 밀렸으면 스와이프 백으로 봐요. 실제 스와이프는 생각보다 짧게 일어나서, 놓치지 않도록 기준을 가장 짧게 잡았어요. 중간에 위아래나 왼쪽으로 움직이면 바로 취소해요.
- 그 한 번만 끄기바로 다음 화면 전환 한 번만 애니메이션을 꺼요. 0.3초가 지나면 판정을 자동으로 풀어서, 다음에 버튼을 눌러 이동할 땐 전환이 정상으로 돌아와요.
iOS가 아닌 환경에서는 아무것도 하지 않는 빈 감지기를 돌려주고, 페이지를 떠날 때는 터치 감지와 타이머를 정리하도록 해서 앱 전체에 부담이 남지 않게 했어요. 이 정리 구조는 PR을 AI 리뷰로 점검받고 지적을 반영하면서 다듬었어요.
결과적으로 iOS에서는 화면의 뒤로가기 버튼엔 전환이 돌고, 스와이프 백은 OS에 맡겨요. 안드로이드는 화면 뒤로가기, 물리 뒤로가기 버튼, 예측 뒤로가기까지 모두 같은 전환으로 움직여요.
03Boundary
웹뷰 페이지는 웹뷰 앱이 맡는다
웹뷰 안에서 일반 웹 앱의 화면을 열었더니, 401이 나자 웹 방식대로 세션을 지우고 웹 로그인 창을 띄웠어요. 웹뷰에서는 세션의 주인이 네이티브라서, 고객이 빠져나올 수 없는 상태가 됐어요.
그 흐름을 웹뷰 앱으로 옮기고, 「웹뷰에서 열리는 페이지는 웹뷰 앱이 맡는다」를 ADR로 정했어요. 앱 안에서 분기하기, 인프라에서 돌려보내기, 공용 패키지로 묶기도 검토했지만 버린 이유를 같이 남겨서, 같은 고민을 다시 하지 않게 했어요.
04ID capture
표준 API 없이 카드 찾기
웹에는 사각형이나 글자를 찾아 주는 표준 API가 없어요. 그래서 카드 네 변은 밝기 변화를 가로·세로로 더해 직접 찾고, 무엇을 어떤 순서로 판정할지는 네이티브 정책을 그대로 따랐어요. 글자 판독만 빼고, 그건 서버 진위확인이 뒤에서 거르게 했어요.
합성 시험은 통과, 실기기는 실패
시험용 이미지로 맞춘 기준이 실제 휴대폰에서는 번번이 빗나갔어요. 그래서 점검 화면에 프레임마다 판정값을 기록하게 하고, 갤럭시·아이폰으로 밝은 바닥·어두운 바닥·키보드를 찍어 가며 원인을 하나씩 짚었어요.
- 갤럭시에서 흐림브라우저가 자동초점 없는 초광각 렌즈를 고르고 있었어요. 초점이 맞는 렌즈로 바꾸고 1.5배 줌으로 열었어요.
- 기기마다 다른 선명도같은 장면도 기기에 따라 선명도 값이 3배쯤 달랐어요. 고정 기준 대신 「최근 1초 동안의 최고치의 절반」을 기준으로 삼았어요.
- 키보드는 서버에 맡기기키보드를 막는 검사를 넣었더니 진짜 신분증이 1.5초에서 8초로 늦어져서 되돌렸어요. 키보드가 찍히면 다시 찍으면 되지만, 신분증이 안 찍히면 사용자가 할 수 있는 게 없으니까요.
세 앱에 한 벌로
판정을 공용 패키지 하나로 모아 투자·핀크·스탁론에 켜고, 카카오페이에도 같은 흐름을 옮겼어요. 복사해 두면 실기기에서 맞춘 기준을 고칠 때마다 세 곳을 똑같이 고쳐야 하니까요.
가이드 프레임 → 자동 인식 → 촬영 완료까지 한 번에.
⚠ 실제 신분증 금지 — 샘플 카드나 가짜 신분증으로 녹화05Result
- 웹뷰에서도 네이티브와 같은 화면 전환 경험.
- 카카오페이 · 스탁론 웹 신분증 촬영: 첫 시도 성공률 67.3% → 96.0%, OCR 성공률 46.8% → 92.6%, 재시도율 58.6% → 20.6%.
- 웹뷰 Sentry 이슈의 약 절반(2,587건)을 차지하던 노이즈 정리.
06Learning
비슷해 보이는 두 환경도 책임 경계가 다르면 분리가 장기적으로 더 단순하다. 그리고 판정 기준은 시험용 이미지가 아니라 실제 기기의 기록으로 정해야 한다.