capture.frame()

把摄像头最新可用帧写入 ByteSink。v0.1 至少支持 rgba8；格式是封闭枚举。

Syntax

const result = await host.capture.frame(camera, output, format?);

Return value

{ written, required?, width, height, stride, format, sequence }

Examples

const output = new Uint8Array(1280 * 720 * 4);
const frame = await host.capture.frame(camera, output, 'rgba8');
processFrame(output.subarray(0, frame.written), frame.width, frame.height, frame.stride);

生产代码应由可读通知或异步等待驱动，不应忙轮询。

Errors

stale-handle、sink-too-small、unsupported-format、device-unavailable、limit-exceeded。

Requirements

• 能力：host:capture.frame
• 有效 camera-stream 句柄
• 信任档位：yellow

See also

capture.requestCamera()、canvas.present()