AudioSession 类

定义

命名空间:

AudioToolbox

程序集:

Xamarin.iOS.dll

与 的接口，用于控制应用程序的音频上下文

[ObjCRuntime.Deprecated(ObjCRuntime.PlatformName.iOS, 7, 0, ObjCRuntime.PlatformArchitecture.None, "Use 'AVAudioSession' instead.")]
public static class AudioSession

type AudioSession = class

继承

Object

AudioSession

属性

DeprecatedAttribute

注解

AVAudioSession和 AVAudioSession 都引用同一个基础单一实例对象。 中的 AVAudioSession 属性在 iOS 7.0 中已弃用，并且 AVAudioSession 似乎是首选前进路径。

可以使用各种 AudioSession 方法来控制操作系统如何处理输入和输出、配置录音机和扬声器、控制音频的播放位置以及音频的录制位置。 AudioSession 还提供一种机制，用于启动和停止使用音频系统以及监视对音频系统的更改。

初始化序列和使用 AudioSession 上的某些属性可能会引发 AudioSessionException。

应用程序可以使用 AddListener(AudioSessionProperty, AudioSession+PropertyListener) 具有 AudioInputAvailable 值的方法监视麦克风何时可用。

属性

AudioInputAvailable	确定音频输入是否可用。
AudioRoute	过时的方法。
AudioShouldDuck	控制应用程序的音频躲避。
Category	控制操作系统如何处理应用程序中的音频。
CurrentHardwareInputLatency	当前硬件输入延迟（以秒为单位）。
CurrentHardwareInputNumberChannels	硬件输入通道数。
CurrentHardwareIOBufferDuration	硬件输入和输出缓冲区的大小（以秒为单位）。
CurrentHardwareOutputLatency	当前硬件输出延迟（以秒为单位）。
CurrentHardwareOutputNumberChannels	硬件输出通道数。
CurrentHardwareOutputVolume	应用程序卷，从 0 到 1。
CurrentHardwareSampleRate	当前硬件采样率。
InputGainAvailable	确定输入增益是否可用。
InputGainScalar	输入增益为 0 到 1 的浮点值。
InputRoute	控制音频输入的源。
InputSources	可从 USB 连接获取的音频输入源。
InterruptionType	中断类型，用于确定 AudioSession 中断时的适当操作过程。
Mode	音频的配置模式，它提供对 Category 属性的精细控制。
OtherAudioIsPlaying	另一个应用程序当前是否正在播放音频。
OutputDestinations	输出目标
OutputRoutes	重试有关可用音频输出路由的信息。
OverrideCategoryDefaultToSpeaker	控制在没有插入耳机的情况下是否应将音频路由到扬声器。
OverrideCategoryEnableBluetoothInput	如果输入来自蓝牙耳机，它会将音频输出路由到头戴显示设备。
OverrideCategoryMixWithOthers	将后台音频与应用程序生成的音频混合，而不考虑默认设置 Category 。
PreferredHardwareIOBufferDuration	应用程序所需的缓冲区大小（以秒为单位）。
PreferredHardwareSampleRate	所需的音频采样率。
RoutingOverride	控制输出路由，重写 由 设置的 Category默认值。

方法

AddListener(AudioSessionProperty, AudioSession+PropertyListener)	开发人员不应使用此已弃用的方法。
Initialize()	初始化音频会话。
Initialize(CFRunLoop, String)	初始化音频会话。
RemoveListener(AudioSessionProperty, AudioSession+PropertyListener)	从受监视的音频会话属性列表中删除指定的侦听器。
SetActive(Boolean)	启用或禁用音频会话。
SetActive(Boolean, AudioSessionActiveFlags)	激活或停用音频会话。

事件

AudioInputBecameAvailable	与 的接口，用于控制应用程序的音频上下文
AudioRouteChanged	当设备上的输入和输出音频路由发生更改时引发的事件。
CurrentHardwareOutputVolumeChanged	与 的接口，用于控制应用程序的音频上下文
InputGainBecameAvailable	与 的接口，用于控制应用程序的音频上下文
InputGainScalarChanged	与 的接口，用于控制应用程序的音频上下文
InputSourcesChanged	与 的接口，用于控制应用程序的音频上下文
Interrupted	音频会话中断时引发的事件。
OutputDestinationsChanged	与 的接口，用于控制应用程序的音频上下文
Resumed	音频会话恢复时引发的事件。
ServerDied	与 的接口，用于控制应用程序的音频上下文

另请参阅

• StreamingAudio
• SysSound