업로드 진행 상태를 확인할 때 동영상 업로드 진행 조회 API, 동영상 업로드 상태 조회 API를 사용하여 확인할 수 있습니다.
동영상 업로드 진행 조회 API
동영상 업로드 진행 조회 API는 동영상 파일이 업로더 서버에 업로드가 되는 진행사항을 퍼센티지로 표현하여 리턴하는 API입니다.
동영상 파일 업로드 API v2에 한하여 progress값이 ‘100%’가 된 시점에 썸네일 이미지 업로드 API, 자막파일 업로드 API 를 사용할 수 있습니다.
- 동영상 파일 업로드 API v1는 progress값이 ‘100%’가 되어도 다음 과정인 썸네일 이미지 추출이 완료되지 않으면 access key를 리턴 받을 수 없기때문에 별도 API로 업로드 상태를 확인하여야 합니다.
- 파일 업로드 API v1, v2의 차이에 있는 그림과 같이 이 API에서 리턴 받은 progress값이 ‘100%’이라고 해도 업로드 전체 과정이 진행되지 않은 상태이기 때문에 이 구간에서 인코딩 진행은 불가능합니다. 업로드 전체 과정이 완료된 상태인 동영상 업로드 상태 조회 API의 status가 COMPLETE인 시점부터 인코딩이 가능합니다.
동영상 업로드 상태 조회 API
동영상 업로드 상태 조회 API는 현재 업로드 진행 상태를 확인하고 인코딩 작업가능 여부를 확인 가능한 API입니다.
이 API에서 리턴 받은 status 값 ‘COMPLETE’는 업로드의 전체 과정이 완료되어 인코딩 진행이 가능한 상태를 뜻합니다.
고객사는 이 ‘COMPLETE’ 값을 사용하여 다음 인코딩 단계를 진행할 수 있습니다.
인코딩 상태 조회
- 동영상 인코딩 상태 조회 API로 인코딩 상태를 확인할 수 있습니다.
인코딩 과정은 크게 인코딩(ENCODING) – 배포(DEPLOYING) – 서비스(SERVICE) 단계로 볼 수 있습니다.- 이 일련의 과정을 동영상 인코딩 상태 조회 API의 status값으로 확인할 수 있습니다.
API를 사용하시는 사용자는 status값으로 ‘SERVICE’를 리턴받은 것을 확인한 후에 사용자에게 동영상 배포 URL을 공개하시면 됩니다.