Camera
Camera(카메라) 위젯은 기기의 카메라 미리보기를 화면에 실시간으로 표시하는 표면입니다.
사진 촬영·영상 녹화·플래시·줌·초점·노출 등을 스크립트로 제어할 수 있습니다.
정의 / 역할
Camera 위젯은 기기 카메라의 실시간 미리보기를 렌더링합니다. 편집 화면(디자인 모드)에서는 플레이스홀더를 보여주고, 앱을 실행하면 실제 카메라 프리뷰가 표시됩니다. 렌즈 방향·해상도·오디오·플래시·촬영 모드를 속성으로 설정하고, 촬영·녹화·저장을 스크립트로 제어합니다.
- 카테고리: Contents
- 기본 크기: 가로 채움 × 높이 200
- 기본 촬영 버튼 표시: 끔(
showCaptureButton = false)
기능
| 기능 | 설명 |
|---|---|
| 실시간 미리보기 | 기기 카메라 영상을 실시간으로 화면에 표시합니다. (앱 실행 시) |
| 사진 촬영 | 현재 카메라로 사진을 촬영합니다. 내장 촬영 버튼 또는 스크립트로 실행합니다. |
| 영상 녹화 | 영상 녹화를 시작·정지·일시정지·재개합니다. |
| 카메라 설정 | 렌즈 방향·해상도·오디오·플래시·촬영 모드를 속성으로 지정합니다. |
| 카메라 제어 | 줌·초점·노출·촬영 방향 잠금을 스크립트로 조정합니다. |
| 갤러리 저장 | 촬영 파일이나 base64 이미지를 기기 갤러리에 저장합니다. |
사용 방법
- 왼쪽 위젯 팔레트에서 Contents 카테고리를 엽니다.
- Camera 항목을 캔버스로 끌어다 놓습니다.
- 오른쪽 속성 패널에서 렌즈 방향(
lensFacing)·해상도(resolutionPreset)·촬영 모드(captureMode) 등을 설정합니다. - 내장 촬영 버튼을 쓰려면
showCaptureButton을 켜니다. - 앱을 실행하면 실제 카메라 미리보기가 표시됩니다. (편집 화면에서는 플레이스홀더만 표시)
속성 (Property)
| 속성 | 설명 | 기본값 | 값 / 타입 |
|---|---|---|---|
lensFacing | 사용할 카메라 렌즈 방향 | back(후면) | back, front |
resolutionPreset | 미리보기·촬영 해상도 | high | low, medium, high, veryHigh, ultraHigh, max |
enableAudio | 영상 녹화 시 오디오 포함 여부 | 켜(true) | 참/거짓 |
initialFlashMode | 초기 플래시 모드 | off | off, auto, always, torch |
captureMode | 촬영 모드 | photo | photo, video |
showCaptureButton | 미리보기 위에 내장 촬영 버튼 표시 여부 | 끔(false) | 참/거짓 |
주의 / 팁
경고
실제 카메라 미리보기는 앱 실행(실기기) 시에만 표시됩니다. 편집 화면(디자인 모드)에서는 카메라 아이콘과 안내 문구가 담긴 플레이스홀더만 나타납니다.
노트
카메라·저장 권한이 필요합니다. Android에서 사진·영상을 갤러리에 저장하려면 사진(또는 저장소) 권한이 허용되어야 합니다.
더 알아보기
팁
이 위젯을 스크립트로 제어하는 Widget Control(Property·Method·Event) 전체는 Camera (카메라) Widget Control 문서에서 확인하세요.