연동 개발자 체크리스트
연동 개발자 체크리스트
C2C 연동 요구 사항
이 체크리스트는 C2C 에코시스템 참여를 위한 모범 사례와 요구 사항을 간략히 설명합니다. 모든 항목이 모든 C2C 디바이스나 애플리케이션에 적용되는 것은 아니지만, C2C 파트너십 팀은 C2C 인증 프로그램 진행 중 구체적인 요구 사항을 정의하기 위해 귀하와 협력할 것입니다.
기본 연동 요구 사항
모든 연동 시스템에는 다음이 포함되어야 합니다.
유연한 업로드 옵션을 제공해야 합니다.
-
자동/수동 업로드 전환
-
개별/대량 파일 선택
-
파일 형식 우선순위 지정(선택 사항)
-
대기열 우선순위 지정(선택 사항)
-
병렬 업로드(선택 사항)
-
개별 또는 모든 업로드의 취소 허용
-
비디오/오디오용 타임코드 스트림
-
다중 형식 업로드 지원(Proxy, OCF, LUT, WAV, RAW, JPG, HEIF, TIFF)
-
프로젝트 이름 변경 처리(이름 문자열 대신
project_id사용)
다음에 대한 명확한 표시기를 제공해야 합니다.
-
남은 파일 수
-
남은 총 파일 크기
-
현재 파일 업로드 진행률
-
완료, 대기 중, 실패한 업로드의 상태
네트워크 연결 상태 표시 및 8시간 경과 후 사용자 개입이나 알림 없이 자동 액세스 토큰 새로 고침(새로 고침 오류가 있는 경우 제외)
추가 요구 사항은 다음과 같습니다.
- 각 단계에서 취소 가능한 권한 부여 흐름
- 실시간 통신을 위한 소켓 상태
- 모든 HTTPS 엔드포인트 호출 시 펌웨어 버전 헤더 포함
보안 요구 사항
Frame.io에서는 보안이 가장 중요합니다. 저희의 요구 사항은 다음과 같습니다.
-
HTTPS 전용 요청(HTTP 요청은 거부됨)
-
디바이스/애플리케이션을 Frame.io에 직접 연결(중간 서비스 없음)
-
client_secret및client_id보호(사용자 액세스 불가) *access_token및refresh_token자격 증명 보호 -
시크릿 및 토큰의 암호화된 스토리지 저장(선택 사항이나 권장됨)
업로더 요구 사항
특히 까다로운 조건에서는 신뢰할 수 있는 미디어 업로드가 매우 중요합니다. 연동 시스템의 필수 사항은 다음과 같습니다.
-
녹화 중 실시간으로(권장) 또는 파일 완료 시 자동 업로드 지원
-
대기열 및 결과를 포함한 명확한 업로드 상태 표시
-
사용자가 액세스할 수 있는 로컬 스토리지에 파일 쓰기
다음을 처리하는 강력한 업로드 대기열을 유지해야 합니다.
-
동시 업로드
-
네트워크 중단
-
전원 재부팅
다음에 대한 자동 재시도를 구현해야 합니다.
-
네트워크 문제
-
전원 중단
-
시스템 오류가 아닌 일반 오류(시간 초과, 네트워크 오류, 만료된 토큰)
-
마지막으로 성공한 청크에서 업로드 재개
-
PAUSED 상태 존중
-
AWS 일반 오류 처리
-
다른 업로드를 차단하지 않고 손상된 미디어 관리
유연한 업로드 옵션을 제공해야 합니다.
-
자동/수동 업로드 전환
-
개별/대량 파일 선택
-
파일 형식 우선순위 지정(선택 사항)
-
대기열 우선순위 지정(선택 사항)
-
병렬 업로드(선택 사항)
-
개별 또는 모든 업로드의 취소 허용
네트워킹 요구 사항
연동 시스템의 필수 사항은 다음과 같습니다.
-
최소 50Mbps 업로드 속도 달성(네트워크 환경이 허용하는 경우)
-
WPA2 WiFi 보안 지원(이더넷은 선택 사항이나 권장됨)
-
DHCP 및 정적 IP 처리
-
명확한 네트워크 상태 표시(연결 유형, 속도, 상태)
-
프로젝트 재페어링 없이 네트워크 전환
-
알려진 WiFi 네트워크 저장
테스트 요구 사항
C2C는 까다로운 조건에 맞게 설계되었으므로 다음에 대한 철저한 테스트가 필요합니다.
적용 가능한 모든 연결 유형을 테스트해야 합니다.
-
다음을 갖춘 상용 라우터.
-
유선 WAN
-
본딩 셀룰러 모뎀
-
상용 셀룰러 모뎀
-
핫스팟 스타일 모뎀
-
메시 라우터 설정(802.11r FT 프로토콜 포함)
-
다양한 모뎀 유형에 대한 직접 연결
-
예상치 못한 정전
-
네트워크 단절
-
ISP 문제
-
손상된 미디어 처리
-
오프라인 에셋 생성 및 재연결
워크플로 요구 사항
C2C는 단순한 기능이 아니라 생태계입니다. 디바이스/애플리케이션별 요구 사항은 다음과 같습니다.
-
카메라에서의 자동 녹화 트리거
-
유연한 카메라 옵션
-
타임코드 오프셋 조정
-
수동 녹화 기능
-
일관된 파일 이름 처리
-
정확한 타임코드 동기화
-
히어로 파일/OCF와 파일 이름/타임코드/메타데이터 일치
-
LTE 최적화(1~12Mbps 비트 전송률)
-
비디오 및 오디오를 위한 표준 코덱 지원
-
비디오/오디오용 타임코드 스트림
-
다중 형식 업로드 지원(Proxy, OCF, LUT, WAV, RAW, JPG, HEIF, TIFF)
-
프로젝트 이름 변경 처리(이름 문자열 대신
project_id사용)
품질 보증
Frame.io에서는 품질이 필수적입니다. 주요 테스트 영역은 다음과 같습니다.
-
안정적인 실행 및 작동
-
프로젝트 연결
-
하드웨어 코드 생성
-
로그인/로그아웃 기능
-
프로젝트/사용자 정보 표시
-
디바이스 관리
-
에셋 업로드
-
형식 지원
-
중단 후 업로드 재개
-
진행률 표시
-
네트워크 상태 표시
-
8시간 연결 지속성
-
취소 가능한 권한 부여
-
직접적인 Frame.io 연결
-
자격 증명 보안
-
네트워크 속도 최적화
향후 개선 사항
Frame.io Camera to Cloud API는 지속적으로 발전하고 있습니다. 이전 버전과의 호환성을 유지하면서, 저희 API를 실제 사용 환경에 맞게 유지하기 위한 향후 개발과 관련하여 지속적인 대화를 나누기를 환영합니다.
이것으로 끝입니다!
UC2CIG(University of C2C 통합 가이드)를 완료하신 것을 축하합니다! 이 가이드가 유용하셨기를 바랍니다.
불명확하거나 누락된 정보에 대한 피드백을 공유해 주시거나, C2C와 관련된 질문이 있다면 언제든 문의해 주세요. 저희에게 도움을 요청하세요!
아직 확인하지 않으셨다면, 계속하기 전에 C2C 구현: 설정 가이드를 검토해 주세요. 인증 및 권한 부여 과정에서 획득한 access_token이 필요합니다. 이 체크리스트는 기본 업로드 가이드 및 고급 업로드 가이드를 바탕으로 작성되었습니다.