capture.requestCamera()

通过可信宿主 UI 申请摄像头。用户取消返回 null；成功返回会话级只读句柄。

Syntax

const camera = await host.capture.requestCamera(constraints);

Parameters

v0.1 白名单约束包括 facing: "user" | "environment"、maxWidth、maxHeight 和 maxFrameRate。它们不是浏览器原始 constraints。

Return value

Handle<camera-stream, read, external-resource, session> | null

Examples

startButton.onclick = async () => {
  const camera = await host.capture.requestCamera({
    facing: 'user', maxWidth: 1280, maxHeight: 720,
  });
  if (camera) await preview(camera);
};

Errors

activation-required、denied、device-unavailable、limit-exceeded。用户主动关闭选择界面返回 null。

Requirements

• 能力：host:capture.requestCamera
• 可信用户激活和系统确认：必须
• 信任档位：yellow

See also

capture.frame()、capture.stop()