메인 콘텐츠로 건너뛰기

알려진 문제

  • CSP가 SDK 로딩을 차단함 — 필수 CSP 지시어(worker-src, script-src 등)가 없으면 Web SDK가 Web Worker와 추가 리소스를 로드하지 못합니다. CSP 구성을 검토하세요.

  • iFrame 외부에서 prepareSelfieCameraForIFrame을 호출하면 오류 73724 반환 — iFrame 메서드는 iFrame 내부에서만 작동합니다. iFrame이 아닌 컨텍스트에서는 prepareSelfieCamera를 사용하세요. 반대의 경우도 마찬가지입니다.

  • iPhone에서 전체 화면이 제한됨 — Apple은 iPhone(iPad는 허용)에서 전체 화면 API 사용을 제한합니다. iPhone에서 캡처할 경우 iFrame의 위치를 수동으로 구성하세요.

  • 상위 CSS로 인해 프레임이 왜곡됨 — 그리드 컴포넌트가 있는 디자인 시스템(Bootstrap, Material-UI 등)이 캡처 프레임을 방해할 수 있습니다. 원치 않는 CSS 규칙을 상속받지 않는 위치에 프레임(id="box-camera")을 배치하세요.

  • 모바일 웹에서 프레임이 100vw/100vh가 아닐 경우 스마트 카메라 오류 발생 — 모바일에서 캡처 프레임은 컴퓨터 비전 알고리즘 문제를 방지하기 위해 기기 화면의 100%를 차지해야 합니다.

  • 소셜 미디어 웹뷰에서 상호작용 방식 라이브니스 미작동 — 상호작용 없는 라이브니스는 Instagram 및 Facebook 웹뷰에서 승인되었지만, 상호작용 방식은 지원되지 않습니다.