푸시 알림 시스템 (Notification System)
문서 정보
- 작성일: 2026-03-12
- 최종 업데이트: 2026-03-12
- 버전: v1.0.0
TL;DR
사용자의 활동(댓글, 공유 요청, 녹화 완료 등)이 발생하면 모바일 푸시 알림을 자동으로 보내주는 시스템입니다. 알림 문구는 서버에서 관리하며, 사용자는 알림 설정에서 받고 싶은 알림만 골라서 켜고 끌 수 있습니다.
목차
핵심 개념
한 줄 요약
서비스에서 이벤트가 발생하면, 알림 시스템이 알림 문구를 만들어 사용자의 기기로 푸시를 보낸다.
용어 설명
| 용어 | 설명 |
|---|---|
| 알림 유형 | 알림의 종류. "댓글 알림", "공유 요청 알림" 등 각각의 알림 종류를 의미합니다 |
| 푸시 알림 | 앱을 열지 않아도 기기에 표시되는 알림. 카카오톡 메시지 알림과 동일한 방식입니다 |
| 딥링크 | 알림을 터치했을 때 앱 내 특정 화면으로 바로 이동하는 기능 |
동작 구조
- 서버에서 문구 관리: 알림 제목과 내용은 서버에서 관리합니다. 앱 업데이트 없이 문구를 변경할 수 있습니다.
- 자동 재시도: 발송에 실패하면 최대 3회까지 자동으로 다시 시도합니다.
- 핵심 기능에 영향 없음: 알림 발송이 실패하더라도 댓글 작성, 공유 승인 등 원래 기능은 정상 동작합니다.
알림 유형
현재 스포클립에서 지원하는 알림 목록입니다.
영상 관련
| 알림 | 푸시 제목 | 언제 보내나요? | 누구에게? | 터치 시 이동 |
|---|---|---|---|---|
| 댓글 알림 | 내 영상에 댓글이 달렸어요 | 내 영상에 누군가 댓글을 남겼을 때 | 영상 소유자 | 해당 영상 |
| 공유 요청 도착 | 영상 공유 승인 요청이 도착했어요 | 누군가 내 영상 공유를 요청했을 때 | 영상 소유자 | 공유 요청 목록 |
| 공유 승인 | 영상 공유 승인이 완료되었어요 | 내 공유 요청이 승인되었을 때 | 공유 요청한 사람 | 해당 영상 |
| 공유 거절 | 영상 공유 승인이 거절되었어요 | 내 공유 요청이 거절되었을 때 | 공유 요청한 사람 | 해당 영상 |
| 녹화 완료 | 녹화가 완료되었어요 | 예약한 녹화가 완료되었을 때 | 녹화 예약자 | 해당 영상 |
| 영상 업로드 준비 | 영상 업로드가 준비되었어요 | 10분 단위 영상이 일정 비율 이상 업로드되었을 때 | 녹화 예약자 | 해당 영상 |
콕 관련
| 알림 | 푸시 제목 | 언제 보내나요? | 누구에게? | 터치 시 이동 |
|---|---|---|---|---|
| 공유 리워드 | 콕 공유 리워드가 도착했어요 | 내가 공유한 콕을 상대방이 시청 완료했을 때 | 콕 공유자 | 알림 목록 |
컨디션 관련
| 알림 | 푸시 제목 | 언제 보내나요? | 누구에게? | 터치 시 이동 |
|---|---|---|---|---|
| 리포트 완료 | 운동 컨디션 리포트가 완료되었어요 | AI가 운동 컨디션 분석을 완료했을 때 | 컨디션 작성자 | 알림 목록 |
알림이 전달되는 과정
여러 기기 사용 시
아이폰과 안드로이드 등 여러 기기에 로그인되어 있으면, 모든 기기에서 알림을 받습니다.
알림 설정
사용자는 앱의 알림 설정 화면에서 알림을 유형별로 켜고 끌 수 있습니다.
어떻게 동작하나요?
- 기본값: 모든 알림은 처음에 켜진 상태입니다
- 개별 제어: 알림 유형별로 하나씩 켜거나 끌 수 있습니다
- 예: "댓글 알림은 끄고, 공유 요청 알림만 받고 싶다" → 가능
- 설정 즉시 반영: 설정을 변경하면 다음 알림부터 바로 적용됩니다
주의사항
기기 알림 권한
앱 내 알림 설정과 별개로, 기기의 알림 권한이 허용되어 있어야 합니다.
- iOS: 설정 > 스포클립 > 알림 허용
- Android: 설정 > 앱 > 스포클립 > 알림 허용
디바이스 등록
알림을 받으려면 사용자의 기기가 서버에 등록되어 있어야 합니다.
언제 등록/해제 되나요?
- 로그인하면 자동으로 기기가 등록되어 알림을 받을 수 있습니다
- 로그아웃하면 기기 등록이 해제되어 더 이상 알림이 오지 않습니다
- 앱 삭제 후 재설치 시 다시 로그인하면 자동으로 등록됩니다
딥링크
알림을 터치하 면 앱 내 관련 화면으로 바로 이동합니다.
| 알림 종류 | 터치 시 이동 화면 |
|---|---|
| 댓글, 공유 승인/거절, 녹화 완료, 영상 업로드 준비 | 해당 영상 상세 화면 |
| 공유 요청 도착 | 공유 요청 목록 화면 |
| 콕 리워드, 운동 리포트 | 알림 목록 화면 |
딥링크가 없는 알림
콕 리워드, 운동 리포트 알림은 특정 화면으로의 이동 없이 알림 목록으로 이동합니다.
FAQ
Q: 알림이 안 와요
다음을 순서대로 확인해주세요:
- 기기 알림 권한: iOS/Android 설정에서 스포클립 앱의 알림이 허용되어 있는지 확인
- 앱 내 알림 설정: 스포클립 앱의 알림 설정에서 해당 알림이 켜져 있는지 확인
- 재로그인: 로그아웃 후 다시 로그인하 면 기기가 새로 등록됩니다
Q: 같은 알림이 여러 번 와요
하나의 이벤트에 대해 알림은 한 번만 발송됩니다. 다만, 여러 기기에 로그인되어 있다면 각 기기에서 한 번씩 알림을 받게 됩니다.
Q: 특정 알림만 끄고 싶어요
앱의 알림 설정 화면에서 알림 유형별로 개별적으로 켜고 끌 수 있습니다.
Q: 알림을 눌렀는데 해당 화면으로 안 가요
영상 관련 알림(댓글, 공유, 녹화)은 해당 영상으로 이동합니다. 콕 리워드, 운동 리포트 알림은 알림 목록으로 이동합니다.
관련 문서
변경 이력
| 버전 | 날짜 | 변경 내용 |
|---|---|---|
| v1.2.0 | 2026-03-17 | VIDEO 알림 코드 리네이밍 및 target 수정 - VIDEO_RECORDING_UPLOADED → VIDEO_RECORDING_COMPLETED - VIDEO_UPLOAD_READY → VIDEO_PLAYBACK_READY - title/body 직관적으로 개선 - target: 각 알림 목적에 맞는 시간 범위로 수정 |
| v1.1.0 | 2026-03-12 | 영상 업로드 준비 알림 추가 - VIDEO_UPLOAD_READY 알림 유형 추가 (8가지) |
| v1.0.0 | 2026-03-12 | 초기 문서 작성 - 7가지 알림 유형 정의 - 알림 전달 과정 - 알림 설정, 디바이스 등록 - 딥링크 - FAQ |