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中导入。

错误类	说明
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);