본문으로 건너뛰기

콕 길이 정책

문서 정보​

  • 작성일: 2026-05-07
  • 최종 업데이트: 2026-05-07
  • 버전: v1.0.0
TL;DR

콕 길이는 콕을 찍은 시점을 기준으로 앞·뒤 몇 초씩 잘라서 클립을 만들지 결정하는 값입니다. 사용자는 마이페이지에서 자기만의 기본값을 설정할 수 있고(15초 ~ 3분), 예약마다 다르게 정할 수도 있어요. 한 번 예약하면 그 길이는 그 예약에서 만들어지는 모든 콕에 동일하게 적용되며, 나중에 기본값을 바꿔도 이미 잡힌 예약의 콕 길이는 변하지 않습니다.

목차​

  1. 콕 길이가 무엇인가요?
  2. 길이는 어떻게 정해지나요?
  3. 내 기본값 설정하기 (마이페이지)
  4. 이번 예약만 다르게 쓰고 싶을 때
  5. 예약 후에 기본값을 바꾸면?
  6. 길이 제한 (15초 ~ 3분)
  7. FAQ

콕 길이가 무엇인가요?​

콕은 운동 중에 "그 순간을 콕!" 찍는 마킹이고, 콕 길이는 그 순간 주변을 얼마만큼 영상으로 남길지 결정하는 값입니다.

비유하자면, 사진과 비슷한 콕을 영상으로 늘릴 때 "셔터 누른 시점 기준 앞 몇 초 / 뒤 몇 초"를 정하는 것이라 보면 됩니다.

항목설명
prepend (앞)콕을 찍기 전 몇 ms부터 클립이 시작되는지
append (뒤)콕을 찍은 뒤 몇 ms까지 클립이 이어지는지
총 길이prepend + append (15s 이상 3분 이하)
시스템 기본값

사용자가 따로 설정하지 않으면 앞 10초 / 뒤 5초 (총 15초) 가 적용됩니다. 도입 전 모든 사용자에게 적용되던 길이와 동일해요.

길이는 어떻게 정해지나요?​

예약을 만들 때 시스템이 다음 우선순위로 콕 길이를 결정합니다.

1. 이번 예약 요청에 직접 명시한 값
   ↓ (없으면)
2. 마이페이지에 저장된 사용자 기본값
   ↓ (없으면)
3. 시스템 기본값 (앞 10초 / 뒤 5초)

이렇게 결정된 값은 예약에 저장되어, 그 예약에서 만들어지는 모든 콕/마이콕에 동일하게 적용됩니다.

내 기본값 설정하기 (마이페이지)​

자주 쓰는 길이를 매번 입력하지 않아도 되도록, 마이페이지에서 사용자별 기본값을 설정할 수 있어요.

액션결과
기본값 설정다음 예약부터 그 값이 자동 적용됨
기본값 해제 (값을 비움)시스템 기본값 (앞 10초 / 뒤 5초) 으로 복귀
응답에는 항상 effective value

마이페이지에서 설정 안 했어도 조회하면 시스템 기본값이 채워져서 반환돼요. 즉 "비어있음"을 볼 일은 없고, 항상 지금 적용 중인 값이 보입니다.

이번 예약만 다르게 쓰고 싶을 때​

평소엔 짧은 클립(15초)이 좋지만 이번 농구 경기는 긴 랠리가 많아 1분 클립으로 보고 싶은 경우, 예약 요청 시 콕 길이를 직접 명시하면 됩니다.

상황마이페이지 기본값예약 요청 명시적용된 길이
평소 빠른 종목15초(생략)15초
평소 빠른 종목인데 이번만 길게15초60초60초 ← 요청 우선
기본값 미설정(없음)90초90초

예약 후에 기본값을 바꾸면?​

이미 잡힌 예약의 콕 길이는 변하지 않습니다.

예시:

  1. 사용자가 마이페이지 기본값을 30초로 설정
  2. 11:00 ~ 12:00 예약 잡음 → 그 예약에 30초가 박힘
  3. 사용자가 기본값을 60초로 변경
  4. 이미 잡힌 11~12시 예약은 여전히 30초 ← 영향 없음
  5. 새로 잡는 예약부터 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분 클립이 나오나요?​

대체로 그렇습니다. 다만 콕을 찍은 위치가 영상 시작점/종료점에 너무 가까우면, 영상 경계 안에서 가능한 만큼만 잘립니다 (앞이 모자라면 뒤를 더 늘리고, 뒤가 모자라면 앞을 더 당겨서 보상).

관련 문서​

변경 이력​

버전날짜변경 내용
v1.0.02026-05-07초기 문서 작성
- 콕 길이 정책 사용자 가이드
- 우선순위 / 마이페이지 / 예약 override / snapshot 동작 / 길이 제한 / FAQ