Device.openCamera

함수형 API openCamera로도 같은 기능을 쓸 수 있어요.

기능 설명

카메라를 실행해서 촬영한 이미지를 반환해요.

카메라 권한이 없으면 OpenCameraPermissionError가 발생해요. Device.openCamera.getPermission() / Device.openCamera.openPermissionDialog()로 권한을 확인·요청할 수 있어요.

타입

Device.openCamera(options?: OpenCameraOptions): Promise<ImageResponse>;

Params

type OpenCameraOptions = {
  /** 이미지를 Base64로 반환할지 여부예요. 기본값은 false예요. */
  base64?: boolean;
  /** 이미지의 최대 너비(px)예요. 기본값은 1024예요. */
  maxWidth?: number;
};

Response

type ImageResponse = {
  id: string;
  dataUri: string;
};

에러

에러는 클래스로 던져져요 — error instanceof OpenCameraPermissionError로 식별해요. 클래스는 @apps-in-toss/web-framework에서 import할 수 있어요.

에러 클래스	설명
OpenCameraPermissionError	카메라 권한이 거부된 경우예요. Device.openCamera.openPermissionDialog()로 다시 요청할 수 있어요.

예시 코드

import { Device, OpenCameraPermissionError } from "@apps-in-toss/web-framework";

const base64 = true;

async function captureAndShow() {
  try {
    const image = await Device.openCamera({ base64, maxWidth: 1024 });

    const img = document.getElementById("preview");
    img.src = base64
      ? "data:image/jpeg;base64," + image.dataUri
      : image.dataUri;
  } catch (error) {
    if (error instanceof OpenCameraPermissionError) {
      console.warn("카메라 권한이 없어요.");
      return;
    }
    console.error(error);
  }
}

document
  .getElementById("open-camera")
  .addEventListener("click", captureAndShow);