기기 등록 및 페어링 매뉴얼

3종 가족 기기 등록 & 연동 가이드

WithU는 스마트폰 📱, 키즈워치 ⌚, 그리고 앱 설치가 필요 없는 GPS 토큰 🏷️까지 가족 구성원의 모든 기기 형태를 하나의 통합 패밀리 맵에서 지원합니다. 아래 안내에 따라 1분 만에 기기를 연동해 보세요.


Device Type 01

스마트폰 (Android APK) 연동 가이드

자녀의 안드로이드 스마트폰에 WithU 자녀앱을 설치하고 부모웹에서 발급받은 인증키를 입력하여 실시간 위치, 안심 툭, 스크린타임 기능을 연결합니다.

1

부모웹에서 기기 등록 및 연동키 발급

부모웹 대시보드에서 [가족 기기 현황] ➔ [기기 추가] 버튼을 누르고 [스마트폰 📱]을 선택합니다. 자녀의 기기 명칭(예: 민우 스마트폰)과 비상 전화번호를 입력 후 등록하면 고유한 앱 페어링 시크릿 키(예: withu_smartphone_1a2b3c4d)가 즉시 발급됩니다.

2

자녀 스마트폰에 WithU 자녀앱(APK) 설치

자녀 스마트폰의 모바일 브라우저에서 제공되는 자녀앱 설치 파일(withu-child-dev.apk)을 다운로드하여 설치합니다. (보안 설정에서 '출처를 알 수 없는 앱 설치' 허용 필요)

3

필수 시스템 권한 허용 (4종)

📍 위치 권한: "항상 허용"앱이 백그라운드에 있을 때도 안심존 진입/이탈을 실시간 감지합니다.
🔋 배터리 최적화: "제한 없음"안드로이드 절전 모드 시 프로세스가 강제 종료되는 것을 방지합니다.
📊 사용 정보 접근 허용스크린타임 가족 저금통 절약 시간을 측정하기 위해 필요합니다.
🔔 알림 허용부모님의 응원 핑 및 안심 알림을 자녀가 즉각 수신합니다.
4

인증키 입력 후 즉시 연동 완료

자녀앱 실행 후 첫 화면의 입력란에 1단계에서 발급받은 시크릿 키를 입력하고 [기기 연동 시작]을 누릅니다. 연동 즉시 부모웹 패밀리 맵에 자녀 기기의 실시간 위치, 배터리 잔량, 스크린타임 현황이 연동됩니다!


Device Type 02

키즈워치 (Galaxy Watch Wear OS) 가이드

스마트워치는 화면에 브라우저가 없으므로, 워치와 연결된 스마트폰을 통해 무선으로 APK를 전송하여 설치하는 방식(사이드로딩)을 사용합니다.

💡스마트폰 없이 워치만 단독 등록하셔도 정상 동작합니다!

자녀 스마트폰을 WithU에 별도로 등록하지 않아도 괜찮습니다. 자녀가 스마트폰을 가방에 넣고 손목에 워치를 착용하면, 블루투스 페어링 통로(Companion Proxy)를 통해 스마트폰의 LTE/5G 데이터를 활용하여 별도 와이파이 없이도 이동 중 실시간 GPS 위치를 부모님께 정상 전송합니다. (단독 외출 시에는 Wi-Fi 또는 LTE 모델 지원)

1

스마트폰에 WithU 워치용 APK 다운로드

워치와 블루투스로 연결되어 있는 스마트폰에서 워치 전용 경량화 앱(withu-watch.apk)을 다운로드합니다.

2

스마트폰에 무선 전송 앱 (Wear Installer 2) 설치

스마트폰의 구글 플레이스토어에서 무료 유틸리티인 [Wear Installer 2] 또는 [Easy Fire Tools] 앱을 검색하여 설치합니다.

3

워치에서 [무선 디버깅] 활성화

워치 설정 ➔ 시스템 ➔ 정보 ➔ 소프트웨어 ➔ [빌드 번호]를 연속 7번 터치하여 개발자 모드를 켭니다.
이후 [설정 ➔ 개발자 옵션 ➔ 무선 디버깅 (Wireless Debugging)]을 켭니다.

4

무선 전송 실행 및 워치에서 연동키 입력

스마트폰 Wear Installer 앱에서 워치를 선택하고 1단계의 withu-watch.apk를 전송하면 워치에 WithU가 자동 설치됩니다.
설치된 WithU 워치 앱을 열고 부모웹에서 발급받은 연동키(withu_smartwatch_...)를 입력하면 손목 안심 케어가 즉시 가동됩니다!


Device Type 03

GPS 토큰 (스마트 태그 & 오픈 Webhook) 가이드

화면이나 키패드가 없는 초소형 스마트 태그, 가방 부착용 트래커, 목걸이형 GPS 기기를 위한 방식입니다.앱 설치가 전혀 필요 없으며, 기기가 WithU의 오픈 Webhook 서버로 좌표를 직접 전송합니다.

1

부모웹에서 GPS 토큰 등록 후 토큰키 발급

부모웹 [기기 추가] ➔ [GPS 토큰 🏷️]을 선택하고 기기 명칭(예: 막내 유치원 가방 태그)을 입력합니다. 등록 완료 시 `X-Device-Token` (오픈 Webhook 인증 토큰)이 발급됩니다.

2

하드웨어 기기 설정에 Webhook 엔드포인트 입력

IoT 트래커 기기의 설정 앱 또는 제조사 대시보드의 "HTTP 전송 주소" 항목에 아래 주소를 등록합니다:

POST https://withu-parent.yeonsoft.net/api/v1/open/telemetry
3

HTTP 전송 전문 규격 & Curl 테스트

curl -X POST https://withu-parent.yeonsoft.net/api/v1/open/telemetry \
  -H "Content-Type: application/json" \
  -H "X-Device-Token: withu_gps_token_your_token_key" \
  -d '{
    "latitude": 37.49812,
    "longitude": 127.02765,
    "battery": 90,
    "speed": 0,
    "accuracy": 8
  }'

• latitude (필수): 위도 (소수점 좌표)

• longitude (필수): 경도 (소수점 좌표)

• battery (선택): 잔여 배터리 (0~100 정수)

• speed (선택): 이동 속도 (km/h)

4

실시간 지도 표시 및 안심존 출입 감지

위치 데이터가 전송되는 순간 WithU 백엔드가 등록된 가족 안심존(Geofence)과의 거리를 0.05초 만에 계산하여, 학교/학원 출입 알림을 부모님께 전달하고 패밀리 맵에 🏷️ 태그 핀으로 실시간 표시합니다.

자주 묻는 질문 & 팁

Q. 자녀 스마트폰 대신 워치만 단독 등록하고 싶습니다. Wi-Fi 모델도 야외에서 위치가 전송되나요?

네, 가능합니다! 자녀 스마트폰을 WithU에 별도로 등록하지 않더라도, 자녀가 스마트폰을 가방에 소지하고 손목에 워치를 찬 상태라면 블루투스 페어링(Companion Proxy)을 통해 스마트폰의 LTE/5G 데이터망으로 워치의 위치가 WithU 서버로 실시간 전송됩니다.
스마트폰 없이 워치만 단독으로 외출하는 경우, LTE 모델은 야외에서도 즉시 전송되며 Wi-Fi 전용 모델은 집/학교/학원 등의 등록된 Wi-Fi망에 연결될 때 위치가 자동 갱신됩니다.

Q. 자녀가 스마트폰을 새 기종으로 바꿨을 때는 어떻게 하나요?

부모웹 [가족 기기 현황]에서 해당 기기 카드를 클릭한 뒤 [기기 교체 / 재발급]을 이용하면, 과거의 이동 동선과 스크린타임 저금통 내역을 100% 보존하면서 새 단말기용 인증키만 깔끔하게 교체할 수 있습니다.

Q. 전화번호는 왜 입력해야 하나요?

전화번호는 선택 사항이며, 자녀가 위험 지역에 진입하거나 긴급 SOS를 보냈을 때 부모웹에서 원터치로 직통 전화를 걸 수 있는 다이렉트 통화 연결용으로 활용됩니다.