콕 길이 정책
문서 정보
- 작성일: 2026-05-07
- 최종 업데이트: 2026-05-07
- 버전: v1.0.0
콕 길이는 콕을 찍은 시점을 기준으로 앞·뒤 몇 초씩 잘라서 클립을 만들지 결정하는 값입니다. 사용자는 마이페이지에서 자기만의 기본값을 설정할 수 있고(15초 ~ 3분), 예약마다 다르게 정할 수도 있어요. 한 번 예약하면 그 길이는 그 예약에서 만들어지는 모든 콕에 동일하게 적용되며, 나중에 기본값을 바꿔도 이미 잡힌 예약의 콕 길이는 변하지 않습니다.
목차
- 콕 길이가 무엇인가요?
- 길이는 어떻게 정해지나요?
- 내 기본값 설정하기 (마이페이지)
- 이번 예약만 다르게 쓰고 싶을 때
- 예약 후에 기본값을 바꾸면?
- 길이 제한 (15초 ~ 3분)
- FAQ
콕 길이가 무엇인가요?
콕은 운동 중에 "그 순간을 콕!" 찍는 마킹이고, 콕 길이는 그 순간 주변을 얼마만큼 영상으로 남길지 결정하는 값입니다.
비유하자면, 사진과 비슷한 콕을 영상으로 늘릴 때 "셔터 누른 시점 기준 앞 몇 초 / 뒤 몇 초"를 정하는 것이라 보면 됩니다.
| 항목 | 설명 |
|---|---|
| prepend (앞) | 콕을 찍기 전 몇 ms부터 클립이 시작되는지 |
| append (뒤) | 콕을 찍은 뒤 몇 ms까지 클립이 이어지는지 |
| 총 길이 | prepend + append (15s 이상 3분 이하) |
사용자가 따로 설정하지 않으면 앞 10초 / 뒤 5초 (총 15초) 가 적용됩니다. 도입 전 모든 사용자에게 적용되던 길이와 동일해요.
길이는 어떻게 정해지나요?
예약을 만들 때 시스템이 다음 우선순위로 콕 길이를 결정합니다.
1. 이번 예약 요청에 직접 명시한 값
↓ (없으면)
2. 마이페이지에 저장된 사용자 기본값
↓ (없으면)
3. 시스템 기본값 (앞 10초 / 뒤 5초)
이렇게 결정된 값은 예약에 저장되어, 그 예약에서 만들어지는 모든 콕/마이콕에 동일하게 적용됩니다.
내 기본값 설정하기 (마이페이지)
자주 쓰는 길이를 매번 입력하지 않아도 되도록, 마이페이지에서 사용자별 기본값을 설정할 수 있어요.
| 액션 | 결과 |
|---|---|
| 기본값 설정 | 다음 예약부터 그 값이 자동 적용됨 |
| 기본값 해제 (값을 비움) | 시스템 기본값 (앞 10초 / 뒤 5초) 으로 복귀 |
마이페이지에서 설정 안 했어도 조회하면 시스템 기본값이 채워져서 반환돼요. 즉 "비어있음"을 볼 일은 없고, 항상 지금 적용 중인 값이 보입니다.
이번 예약만 다르게 쓰고 싶을 때
평소엔 짧은 클립(15초)이 좋지만 이번 농구 경기는 긴 랠리가 많아 1분 클립으로 보고 싶은 경우, 예약 요청 시 콕 길이를 직접 명시하면 됩니다.
| 상황 | 마이페이지 기본값 | 예약 요청 명시 | 적용된 길이 |
|---|---|---|---|
| 평소 빠른 종목 | 15초 | (생략) | 15초 |
| 평소 빠른 종목인데 이번만 길게 | 15초 | 60초 | 60초 ← 요청 우선 |
| 기본값 미설정 | (없음) | 90초 | 90초 |
예약 후에 기본값을 바꾸면?
이미 잡힌 예약의 콕 길이는 변하지 않습니다.
예시:
- 사용자가 마이페이지 기본값을 30초로 설정
- 11:00 ~ 12:00 예약 잡음 → 그 예약에 30초가 박힘
- 사용자가 기본값을 60초로 변경
- 이미 잡힌 11~12시 예약은 여전히 30초 ← 영향 없음
- 새로 잡는 예약부터 60초가 적용됨
"예약 잡을 때 정한 정책"이 그대로 보존되는 게 사용자 입장에서 예측 가능하고, 운영자 입장에서도 정책을 바꿀 때 진행 중인 예약에 영향을 주지 않아 안전하기 때문입니다. 패스(멤버십) 정책도 같은 방식으로 동결됩니다.
길이 제한 (15초 ~ 3분)
너무 짧거나 너무 긴 클 립은 시청 경험에 좋지 않아 다음 범위로 제한됩니다.
| 항목 | 값 |
|---|---|
| 최소 합계 | 15초 (도입 전 기본 길이와 동일) |
| 최대 합계 | 3분 (180초) |
| 각 필드 | 0 이상 (앞·뒤 어느 한쪽이 0이어도 OK) |
범위를 벗어나면 다음 에러가 응답됩니다.
| errorCode | 의미 |
|---|---|
KOK_LENGTH_OUT_OF_RANGE | 합이 15초 미만 또는 3분 초과 |
KOK_LENGTH_NEGATIVE | 앞 또는 뒤가 음수 |
KOK_LENGTH_INVALID_SHAPE | 형식 오류 (필드 누락, 숫자 아님 등) |
FAQ
Q. 마이페이지 기본값을 바꿔도 다음 예약부터만 적용되나요?
네. 이미 잡힌 예약의 콕 길이는 그대로 유지되고, 변경 후 새로 잡는 예약부터 새 기본값이 적용됩니다.
Q. 콕 길이를 바꾸면 이미 만들어진 마 이콕 영상도 다시 잘리나요?
아니요. 마이콕은 매니페스트 생성 시점에 그 예약에 박혀있는 콕 길이로 한 번 잘려서 만들어집니다. 한 번 만들어진 영상은 다시 잘리지 않아요.
Q. 한 예약 안에서 콕마다 다른 길이로 자를 수 있나요?
아니요. 한 예약 = 한 콕 길이입니다. 예약 안에 여러 콕이 있더라도 모두 동일 길이로 잘립니다.
Q. 다운로드 받은 영상 길이도 콕 길이대로 인가요?
네. 마이콕 다운로드 시 클립 영상은 매니페스트에서 잘려진 그대로이며, 다운로드 메타에도 같은 길이가 기록됩니다.
Q. 시스템 기본값 (앞 10초 / 뒤 5초) 은 왜 이런 값인가요?
이 기능 도입 전 모든 사용자에게 적용되던 길이와 동일하게 맞췄습니다. 그래야 미설정 사용자에게 동작 변화가 없습니다.
Q. 가장 긴 3분(180초) 으로 설정해도 항상 3분 클립이 나오나요?
대체로 그렇습니다. 다만 콕을 찍은 위치가 영상 시작점/종료점에 너무 가까우면, 영상 경계 안에서 가능한 만큼만 잘립니다 (앞이 모자라면 뒤를 더 늘리고, 뒤가 모자라면 앞을 더 당겨서 보상).
관련 문서
- 콕 개요 — 콕 자체에 대한 사용자 가이드
- 기술 결정 기록: kok ADR-003, user-schedule ADR-012, user-preference ADR-001
변경 이력
| 버전 | 날짜 | 변경 내용 |
|---|---|---|
| v1.0.0 | 2026-05-07 | 초기 문서 작성 - 콕 길이 정책 사용자 가이드 - 우선순위 / 마이페이지 / 예약 override / snapshot 동작 / 길이 제한 / FAQ |