`capture.requestMic()`

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

Syntax

const mic = await host.capture.requestMic(constraints);

Parameters

v0.1 白名单字段为 preferredSampleRate 和 maxChannels: 1 | 2。宿主返回的实际格式以 readAudio() 为准。

Return value

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

Examples

recordButton.onclick = async () => {
  const mic = await host.capture.requestMic({ preferredSampleRate: 48_000, maxChannels: 1 });
  if (mic) beginRecording(mic);
};

Errors

activation-required、denied、device-unavailable、limit-exceeded。用户取消不是错误。

Requirements

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

capture.requestMic()