playback.open()

创建应用会话级音频输出，并返回宿主实际采用的格式和缓冲预算。

Syntax

const stream = await host.playback.open(options?);

Parameters

PlaybackOptions {
  preferredSampleRate?: u32
  channels?: 1 | 2
  latency?: "interactive" | "balanced"
}

所有字段都是偏好或封闭枚举，宿主可以选择不同采样率。

Return value

{
  output: Handle<audio-output, write, app-context, session>
  sampleRate: u32
  channels: 1 | 2
  maxQueuedFrames: u32
}

Examples

const stream = await host.playback.open({
  preferredSampleRate: 48_000,
  channels: 2,
  latency: 'interactive',
});
configureMixer(stream.sampleRate, stream.channels);

Errors

activation-required、device-unavailable、invalid-argument、limit-exceeded。

Requirements

• 能力：host:playback.open
• 用户激活：平台要求首次发声时需要
• 信任档位：yellow

See also

playback.write()、playback.stop()