@capgo/camera-preview

개요

@capgo/camera-preview 렌더링합니다 네이티브 카메라 레이어 WebView 뒤 또는 위에 배치하여 실시간 프리뷰, 스틸 캡처, 플래시 제어, 화면 비율 및 선택 사항인 바코드 스캔. 사용자를 기본 카메라 앱으로 보내지 않고도 스캔 결제, AR 스타일 오버레이, 커스텀 셔터 UX 및 비전 워크플로우를 구축하세요.

함께 사용: @capgo/capacitor-uploader JavaScript에서 전체 버퍼를 로드하는 대신 디스크 경로에서 캡처 파일을 업로드할 수 있습니다.

플랫폼 지원

플랫폼	참고 사항
iOS	멀티 렌즈 기기, 핀치 줌, 네이티브 스캐너를 통한 바코드 포맷 지원
Android	CameraX preview, 설정 가능한 캡처 해상도
웹	지원 제한적, 현재 웹 지원 범위는 플러그인 README 참조

핵심 기능

• start - 카메라 프리뷰를 시작합니다.
• stop - 카메라 프리뷰를 중지합니다.
• capture - 카메라로 사진을 촬영합니다.
• captureSample - 카메라 프리뷰 스트림에서 단일 프레임을 캡처합니다.

공개 API

메서드	설명
start	카메라 프리뷰를 시작합니다.
stop	카메라 프리뷰를 중지합니다.
capture	카메라로 사진을 촬영합니다.
captureSample	카메라 프리뷰 스트림에서 단일 프레임을 캡처합니다.
getSupportedFlashModes	활성 카메라에서 지원하는 플래시 모드를 가져옵니다.
setAspectRatio	카메라 프리뷰의 종횡비를 설정합니다.
getAspectRatio	카메라 프리뷰의 현재 종횡비를 가져옵니다.
setGridMode	카메라 프리뷰 오버레이의 그리드 모드를 설정합니다.
getGridMode	카메라 프리뷰 오버레이의 현재 그리드 모드를 가져옵니다.
checkPermissions	시스템 대화 상자를 띄우지 않고 현재 카메라(및 옵션인 마이크) 권한 상태를 확인합니다.
requestPermissions	카메라(및 선택 사항인 마이크) 권한을 요청합니다. 이미 권한이 허용되었거나 거부된 경우, 별도의 안내 없이 현재 상태를 반환합니다. 만약 showSettingsAlert 값이 true이고 권한이 거부된 경우, 사용자를 앱 설정으로 안내하는 플랫폼별 알림이 표시됩니다.
getHorizontalFov	활성화된 카메라의 수평 시야각(FOV)을 가져옵니다. 참고: 일부 기기에서는 추정치일 수 있습니다.
getSupportedPictureSizes	모든 카메라에서 지원하는 사진 크기를 가져옵니다.
setFlashMode	활성화된 카메라의 플래시 모드를 설정합니다.
flip	전면 카메라와 후면 카메라를 전환합니다.
setOpacity	카메라 프리뷰의 불투명도를 설정합니다.
stopRecordVideo	진행 중인 비디오 녹화를 중단합니다.
startRecordVideo	비디오 녹화를 시작합니다.
isRunning	카메라 프리뷰가 현재 실행 중인지 확인합니다.
getAvailableDevices	사용 가능한 모든 카메라 장치를 가져옵니다.
getZoom	최소/최대 줌 및 현재 렌즈 정보를 포함한 현재 줌 상태를 가져옵니다.
getZoomButtonValues	빠른 전환을 위한 줌 버튼 값을 반환합니다. - iOS/Android: 초광각 사용 가능 시 0.5, 광각 사용 가능 시 1과 2, 망원 사용 가능 시 3 포함 - Web: 지원되지 않음.
setZoom	카메라의 줌 레벨을 설정합니다.
getFlashMode	현재 플래시 모드를 가져옵니다.
removeAllListeners	등록된 모든 리스너를 제거합니다.
setDeviceId	활성 카메라를 지정된 카메라로 전환합니다. deviceId.
getDeviceId	현재 바인딩된 카메라 장치의 ID를 가져옵니다. Android에서 물리 렌즈 요청이 논리 카메라로 폴백되면, 바인딩된 논리 카메라 ID를 반환합니다.
getPreviewSize	현재 프리뷰 크기와 위치를 가져옵니다.
setPreviewSize	프리뷰 크기와 위치를 설정합니다.
setFocus	프리뷰 내 특정 지점에 카메라 포커스를 설정합니다.
addListener	화면 크기 조정(resize) 이벤트 리스너를 추가합니다.
addListener	화면 방향 변경(orientation change) 이벤트 리스너를 추가합니다.
deleteFile	Deletes a file at the given absolute path on the device. Use this to quickly clean up temporary images created with storeToFile. 웹에서는 지원되지 않으며 오류가 발생합니다.
getSafeAreaInsets	기기의 safe area insets를 가져옵니다. 방향에 따른 노치/카메라 컷아웃 인셋과 현재 방향을 반환합니다. 세로 모드에서는 상단 인셋(상단 노치)을, 가로 모드에서는 좌측 인셋(측면 노치)을 반환합니다. 최신 스마트폰의 컷아웃 영역(노치, 펀치홀 등)을 정확히 타겟팅합니다.
getOrientation	현재 기기 방향을 크로스 플랫폼 형식으로 가져옵니다.
getExposureModes	활성화된 카메라가 지원하는 노출 모드를 반환합니다. 모드에는 ‘locked’, ‘auto’, ‘continuous’, ‘custom’이 포함될 수 있습니다.
getExposureMode	현재 노출 모드를 반환합니다.
setExposureMode	노출 모드를 설정합니다.
getExposureCompensationRange	지원되는 노출 보정(EV bias) 범위를 반환합니다.
getExposureCompensation	현재 노출 보정(EV bias) 값을 반환합니다.
setExposureCompensation	노출 보정(EV bias) 값을 설정합니다. 값은 허용 범위 내로 제한됩니다.
getPluginVersion	네이티브 Capacitor 플러그인 버전을 가져옵니다.

참조 값

다음 값을 사용하여 CameraLens.deviceType 또는 LensInfo.deviceType 물리적 카메라 렌즈를 선택하세요.

디바이스 유형

값	사용자는 다음을 확인할 수 있습니다:
ultraWide	초광각 카메라 렌즈.
wideAngle	표준 광각 카메라 렌즈.
telephoto	망원 카메라 렌즈.
trueDepth	TrueDepth 전면 카메라.
dual	듀얼 카메라 시스템.
dualWide	듀얼 광각 카메라 시스템.
triple	트리플 카메라 시스템.

Source of Truth

이 레퍼런스는 다음에서 동기화됩니다. src/definitions.ts 에서 capacitor-camera-preview.

@capgo/camera-preview에서 계속하기

사용 중이라면 @capgo/camera-preview 네이티브 미디어 및 인터페이스 동작을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/camera-preview 사용하기 @capgo/camera-preview를 사용하여 네이티브 기능을 구현할 때, @capgo/capacitor-live-activities 사용 @capgo/capacitor-live-activities 사용에서의 네이티브 기능, @capgo/capacitor-live-activities @capgo/capacitor-live-activities의 구현 세부 사항, @capgo/capacitor-video-player 사용 @capgo/capacitor-video-player 사용에서의 네이티브 기능 및 @capgo/capacitor-video-player @capgo/capacitor-video-player.의 구현 세부 사항