AVAudioSession 類別

參考

定義

命名空間:: AVFoundation

組件:: Xamarin.iOS.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

協調音訊播放或擷取會話。

[Foundation.Register("AVAudioSession", true)]
[ObjCRuntime.Introduced(ObjCRuntime.PlatformName.WatchOS, 3, 0, ObjCRuntime.PlatformArchitecture.All, null)]
public class AVAudioSession : Foundation.NSObject

type AVAudioSession = class
    inherit NSObject

繼承: Object

NSObject
AVAudioSession

屬性: RegisterAttribute IntroducedAttribute

備註

應用程式開發人員應該使用所擷 SharedInstance() 取的單一物件。

因為 iOS 裝置的音訊硬體在所有應用程式之間共用，所以音訊設定只能「慣用」 (查看 SetPreferred* 方法) ，而應用程式開發人員必須考慮這些喜好設定被覆寫的使用案例。

應用程式與其他應用程式和系統服務的互動取決於音訊類別。您可以使用 SetCategory(String, String, AVAudioSessionRouteSharingPolicy, AVAudioSessionCategoryOptions, NSError) 方法來設定此專案

您也應該使用來控制模式 (SetMode(NSString, NSError) ，以描述您的應用程式如何使用音訊。

與 AV Foundation 一樣，中的 AVAudioSession 許多方法都是非同步，屬性可能需要一些時間才能反映其最終狀態。應用程式開發人員應該熟悉非同步程式設計技術。

， AVAudioSession 例如 AVCaptureSession 和 AVAssetExportSession 是一些和 InputDataSources OutputDataSources 之間的協調物件。

您可以使用中的 AVAudioSession.Notifications 便利方法，向音訊系統張貼的一些通知註冊。

void Setup ()
{
	AVAudioSession.SharedInstance ().Init ();
	NSError error;
	if (!AVAudioSession.SharedInstance ().SetCategory (AVAudioSessionCategory.Playback, out error)) {
		ReportError (error);
		return;
	}
	AVAudioSession.Notifications.ObserveInterruption (ToneInterruptionListener);

	if (!AVAudioSession.SharedInstance ().SetActive (true, out error)) {
		ReportError (error);
		return;
	}

	void ToneInterruptionListener (object sender, AVAudioSessionInterruptionEventArgs interruptArgs)
	{
		//
	}
}

建構函式

AVAudioSession(IntPtr)	建立 Unmanaged 物件的 Managed 標記法時所使用的建構函式;由執行時間呼叫。
AVAudioSession(NSObjectFlag)	在衍生類別上呼叫的建構函式，以略過初始化，並只配置物件。

屬性

AvailableCategories	取得陣列，其中包含裝置可以提供的會話類別描述。
AvailableInputs	取得陣列，其中包含 AVAudioSessionPortDescription 列出裝置上可用音訊來源的。
AvailableModes	取得包含可用音訊會話模式的陣列。
Category	應用程式的弱式類型音訊分類，用來平衡其裝置上其他應用程式的需求。
CategoryAmbient	表示與常數 AVAudioSessionCategoryAmbient 相關聯的值
CategoryAudioProcessing	開發人員不應該使用此已被取代的屬性。
CategoryMultiRoute	表示與常數 AVAudioSessionCategoryMultiRoute 相關聯的值
CategoryOptions	的選項 Category 。
CategoryPlayAndRecord	表示與常數 AVAudioSessionCategoryPlayAndRecord 相關聯的值
CategoryPlayback	表示與常數 AVAudioSessionCategoryPlayback 相關聯的值
CategoryRecord	表示與常數 AVAudioSessionCategoryRecord 相關聯的值
CategorySoloAmbient	表示與常數 AVAudioSessionCategorySoloAmbient 相關聯的值
Class	協調音訊播放或擷取會話。 (繼承來源 NSObject)
ClassHandle	這個類別的控制碼。
CurrentHardwareInputNumberOfChannels	應用程式開發人員不應該使用這個已被取代的屬性。請改用 InputNumberOfChannels。
CurrentHardwareOutputNumberOfChannels	應用程式開發人員不應該使用這個已被取代的屬性。請改用 OutputNumberOfChannels。
CurrentHardwareSampleRate	應用程式開發人員不應該使用這個已被取代的屬性。請改用 SampleRate。
CurrentRoute	作用中的輸入輸出路由。
DebugDescription	此物件的開發人員有意義描述。 (繼承來源 NSObject)
Delegate	AVFoundation.IAVAudioSessionDelegate 模型類別的實例，做為類別委派。
Description	物件的描述，ToString 的 Objective-C 版本。 (繼承來源 NSObject)
Handle	處理非受控物件標記法) (指標。 (繼承來源 NSObject)
InputAvailable	任何輸入路由是否支援音訊。
InputDataSource	目前選取的輸入 AVAudioSessionDataSourceDescription 。
InputDataSources	目前輸入埠可用的資料來源。
InputGain	以浮點數從 0 到 1 的輸入增益。
InputGainSettable	判斷輸入取得是否可用。
InputIsAvailable	應用程式開發人員不應該使用此已被取代。請改用 InputAvailable。
InputLatency	輸入延遲，以秒為單位。
InputNumberOfChannels	目前輸入路由的通道數目。
InterruptionNotification	中斷通知常數
IOBufferDuration	目前緩衝區的持續時間，以秒為單位。
IsDirectBinding	協調音訊播放或擷取會話。 (繼承來源 NSObject)
IsProxy	協調音訊播放或擷取會話。 (繼承來源 NSObject)
MaximumInputNumberOfChannels	目前輸入路由可用的通道數目最大。
MaximumOutputNumberOfChannels	目前輸出路由可用的通道數目最大。
MediaServicesWereLostNotification	MediaServicesWereLost 的通知常數
MediaServicesWereResetNotification	MediaServicesWereReset 的通知常數
Mode	音訊的組態模式可提供更精細的 Category 屬性控制。
ModeDefault	表示與常數 AVAudioSessionModeDefault 相關聯的值
ModeGameChat	表示與常數 AVAudioSessionModeGameChat 相關聯的值
ModeMeasurement	表示與常數 AVAudioSessionModeMeasurement 相關聯的值
ModeMoviePlayback	表示與常數 AVAudioSessionModeMoviePlayback 相關聯的值
ModeSpokenAudio	表示與常數 AVAudioSessionModeSpokenAudio 相關聯的值。
ModeVideoChat	表示與常數 AVAudioSessionModeVideoChat 相關聯的值
ModeVideoRecording	表示與常數 AVAudioSessionModeVideoRecording 相關聯的值
ModeVoiceChat	表示與常數 AVAudioSessionModeVoiceChat 相關聯的值
OrientationLeft	表示與常數 AVAudioSessionOrientationLeft 相關聯的值
OrientationRight	表示與常數 AVAudioSessionOrientationRight 相關聯的值
OtherAudioPlaying	另一個應用程式目前是否現正播放音訊。
OutputDataSource	目前選取的輸出資料來源。
OutputDataSources	的 AVAudioSessionDataSourceDescription 陣列，列出目前輸出路由的可用來源。
OutputLatency	輸出延遲，以秒為單位。
OutputNumberOfChannels	輸出路由中的目前通道數目。
OutputVolume	目前的磁片區。
PortAirPlay	表示與常數 AVAudioSessionPortAirPlay 相關聯的值
PortBluetoothA2DP	表示與常數 AVAudioSessionPortBluetoothA2DP 相關聯的值
PortBluetoothHfp	表示與常數 AVAudioSessionPortBluetoothHFP 相關聯的值
PortBluetoothLE	表示與常數 AVAudioSessionPortBluetoothLE 相關聯的值
PortBuiltInMic	表示與常數 AVAudioSessionPortBuiltInMic 相關聯的值
PortBuiltInReceiver	表示與常數 AVAudioSessionPortBuiltInReceiver 相關聯的值
PortBuiltInSpeaker	表示與常數 AVAudioSessionPortBuiltInSpeaker 相關聯的值
PortCarAudio	表示與常數 AVAudioSessionPortCarAudio 相關聯的值
PortHdmi	表示與常數 AVAudioSessionPortHDMI 相關聯的值
PortHeadphones	表示與常數 AVAudioSessionPortHeadphones 相關聯的值
PortHeadsetMic	表示與常數 AVAudioSessionPortHeadsetMic 相關聯的值
PortLineIn	表示與常數 AVAudioSessionPortLineIn 相關聯的值
PortLineOut	表示與常數 AVAudioSessionPortLineOut 相關聯的值
PortUsbAudio	表示與常數 AVAudioSessionPortUSBAudio 相關聯的值
PreferredHardwareSampleRate	您想要的音訊取樣率。
PreferredInput	音訊路由慣用的輸入埠。
PreferredIOBufferDuration	您的應用程式需要以秒為單位的緩衝區大小。
PreferredSampleRate	應用程式慣用的取樣率，以 Hz 為單位。
PromptStyle	協調音訊播放或擷取會話。
RecordPermission	取得值，這個值描述目前授與的錄製許可權狀態。
RetainCount	傳回物件的目前 Objective-C 保留計數。 (繼承來源 NSObject)
RouteChangeNotification	RouteChange 的通知常數
RouteSharingPolicy	協調音訊播放或擷取會話。
SampleRate	目前硬體取樣率，以 Hz 為單位。
SecondaryAudioShouldBeSilencedHint	取得布林值，指出另一個應用程式是否現正播放音訊。
Self	協調音訊播放或擷取會話。 (繼承來源 NSObject)
SilenceSecondaryAudioHintNotification	SilenceSecondaryAudioHint 的通知常數
Superclass	協調音訊播放或擷取會話。 (繼承來源 NSObject)
SuperHandle	用來表示這個 NSObject 基類中方法的控制碼。 (繼承來源 NSObject)
VoicePrompt	協調音訊播放或擷取會話。
WeakDelegate	物件，可回應此類型的委派通訊協定
Zone	協調音訊播放或擷取會話。 (繼承來源 NSObject)

方法

AddObserver(NSObject, NSString, NSKeyValueObservingOptions, IntPtr)	使用 NSString keyPath) 在外部 (註冊要觀察的物件。觀察到的變更會分派至觀察者的物件 ObserveValue(NSString, NSObject, NSDictionary, IntPtr) 方法。 (繼承來源 NSObject)
AddObserver(NSObject, String, NSKeyValueObservingOptions, IntPtr)	使用字串 keyPath) 在外部 (註冊要觀察的物件。觀察到的變更會分派至觀察者的物件 ObserveValue(NSString, NSObject, NSDictionary, IntPtr) 方法。 (繼承來源 NSObject)
AddObserver(NSString, NSKeyValueObservingOptions, Action<NSObservedChange>)	使用任意方法註冊要從外部觀察到的物件。 (繼承來源 NSObject)
AddObserver(String, NSKeyValueObservingOptions, Action<NSObservedChange>)	使用任意方法註冊要從外部觀察到的物件。 (繼承來源 NSObject)
AwakeFromNib()	從 nib 檔案載入物件之後呼叫。覆寫程式必須呼叫基底。AwakeFromNib () 。 (繼承來源 NSObject)
BeginInvokeOnMainThread(Action)	協調音訊播放或擷取會話。 (繼承來源 NSObject)
BeginInvokeOnMainThread(Selector, NSObject)	在主要 UI 執行緒上以非同步方式叫用指定的程式碼。 (繼承來源 NSObject)
Bind(NSString, NSObject, String, NSDictionary)	協調音訊播放或擷取會話。 (繼承來源 NSObject)
Bind(String, NSObject, String, NSDictionary)	已淘汰. 協調音訊播放或擷取會話。 (繼承來源 NSObject)
BindingInfo(String)	已淘汰. 協調音訊播放或擷取會話。 (繼承來源 NSObject)
BindingOptionDescriptions(String)	已淘汰. 協調音訊播放或擷取會話。 (繼承來源 NSObject)
BindingValueClass(String)	已淘汰. 協調音訊播放或擷取會話。 (繼承來源 NSObject)
CommitEditing()	協調音訊播放或擷取會話。 (繼承來源 NSObject)
CommitEditing(NSObject, Selector, IntPtr)	協調音訊播放或擷取會話。 (繼承來源 NSObject)
ConformsToProtocol(IntPtr)	叫用以判斷這個物件是否實作指定的通訊協定。 (繼承來源 NSObject)
Copy()	執行基礎 Objective-C 物件的複本。 (繼承來源 NSObject)
DangerousAutorelease()	協調音訊播放或擷取會話。 (繼承來源 NSObject)
DangerousRelease()	協調音訊播放或擷取會話。 (繼承來源 NSObject)
DangerousRetain()	協調音訊播放或擷取會話。 (繼承來源 NSObject)
DidChange(NSKeyValueChange, NSIndexSet, NSString)	指出對多關聯性的索引發生變更。 (繼承來源 NSObject)
DidChange(NSString, NSKeyValueSetMutationKind, NSSet)	協調音訊播放或擷取會話。 (繼承來源 NSObject)
DidChangeValue(String)	表示在指定的索引鍵上發生變更。 (繼承來源 NSObject)
Dispose()	釋放 NSObject 物件所使用的資源。 (繼承來源 NSObject)
Dispose(Boolean)	釋放 AVAudioSession 物件所使用的資源。
DoesNotRecognizeSelector(Selector)	表示這個物件無法辨識指定的選取器。 (繼承來源 NSObject)
Equals(NSObject)	協調音訊播放或擷取會話。 (繼承來源 NSObject)
Equals(Object)	協調音訊播放或擷取會話。 (繼承來源 NSObject)
ExposedBindings()	協調音訊播放或擷取會話。 (繼承來源 NSObject)
GetBindingInfo(NSString)	協調音訊播放或擷取會話。 (繼承來源 NSObject)
GetBindingOptionDescriptions(NSString)	協調音訊播放或擷取會話。 (繼承來源 NSObject)
GetBindingValueClass(NSString)	協調音訊播放或擷取會話。 (繼承來源 NSObject)
GetDictionaryOfValuesFromKeys(NSString[])	擷取指定索引鍵的值。 (繼承來源 NSObject)
GetHashCode()	產生目前實例的雜湊碼。 (繼承來源 NSObject)
GetMethodForSelector(Selector)	協調音訊播放或擷取會話。 (繼承來源 NSObject)
GetNativeField(String)	已淘汰. 協調音訊播放或擷取會話。 (繼承來源 NSObject)
GetNativeHash()	協調音訊播放或擷取會話。 (繼承來源 NSObject)
GetPreferredInputNumberOfChannels()	擷取慣用的輸入通道數目。
GetPreferredOutputNumberOfChannels()	擷取慣用的輸出通道數目。
Init()	協調音訊播放或擷取會話。 (繼承來源 NSObject)
InitializeHandle(IntPtr)	協調音訊播放或擷取會話。 (繼承來源 NSObject)
InitializeHandle(IntPtr, String)	協調音訊播放或擷取會話。 (繼承來源 NSObject)
Invoke(Action, Double)	協調音訊播放或擷取會話。 (繼承來源 NSObject)
Invoke(Action, TimeSpan)	協調音訊播放或擷取會話。 (繼承來源 NSObject)
InvokeOnMainThread(Action)	協調音訊播放或擷取會話。 (繼承來源 NSObject)
InvokeOnMainThread(Selector, NSObject)	在主要 UI 執行緒上，以同步方式叫用指定的程式碼。 (繼承來源 NSObject)
IsEqual(NSObject)	協調音訊播放或擷取會話。 (繼承來源 NSObject)
IsKindOfClass(Class)	協調音訊播放或擷取會話。 (繼承來源 NSObject)
IsMemberOfClass(Class)	協調音訊播放或擷取會話。 (繼承來源 NSObject)
MarkDirty()	將一般對等物件升階 (IsDirectBinding 為 true) 為 toggleref 物件。 (繼承來源 NSObject)
MutableCopy()	建立指定之 NSObject 的可變動複本。 (繼承來源 NSObject)
ObjectDidEndEditing(NSObject)	協調音訊播放或擷取會話。 (繼承來源 NSObject)
ObserveValue(NSString, NSObject, NSDictionary, IntPtr)	表示相對於這個物件的指定 keyPath 的值已變更。 (繼承來源 NSObject)
OverrideOutputAudioPort(AVAudioSessionPortOverride, NSError)	暫時變更輸出音訊埠的要求。
PerformSelector(Selector)	協調音訊播放或擷取會話。 (繼承來源 NSObject)
PerformSelector(Selector, NSObject)	協調音訊播放或擷取會話。 (繼承來源 NSObject)
PerformSelector(Selector, NSObject, Double)	叫用目前實例上的選取器，如果 `obj` 不是 Null，它會傳遞這個做為其單一參數。 (繼承來源 NSObject)
PerformSelector(Selector, NSObject, Double, NSString[])	協調音訊播放或擷取會話。 (繼承來源 NSObject)
PerformSelector(Selector, NSObject, NSObject)	協調音訊播放或擷取會話。 (繼承來源 NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean)	協調音訊播放或擷取會話。 (繼承來源 NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean, NSString[])	協調音訊播放或擷取會話。 (繼承來源 NSObject)
PrepareForInterfaceBuilder()	協調音訊播放或擷取會話。 (繼承來源 NSObject)
RemoveObserver(NSObject, NSString)	停止指定的觀察者接收指定 keyPath 變更值的進一步通知。 (繼承來源 NSObject)
RemoveObserver(NSObject, NSString, IntPtr)	停止指定的觀察者接收指定 keyPath 和內容的變更值進一步通知。 (繼承來源 NSObject)
RemoveObserver(NSObject, String)	停止指定的觀察者接收指定 keyPath 變更值的進一步通知。 (繼承來源 NSObject)
RemoveObserver(NSObject, String, IntPtr)	停止指定的觀察者接收指定 keyPath 和內容的變更值進一步通知。 (繼承來源 NSObject)
RequestRecordPermission(AVPermissionGranted)	向應用程式使用者呈現標準 UI，要求記錄許可權。
RespondsToSelector(Selector)	這個物件是否辨識指定的選取器。 (繼承來源 NSObject)
SetActive(Boolean)	啟動或停用應用程式的音訊會話。
SetActive(Boolean, AVAudioSessionFlags, NSError)	應用程式開發人員不應該使用這個已被取代的方法。
SetActive(Boolean, AVAudioSessionSetActiveOptions)	啟動和停用應用程式的音訊會話。
SetActive(Boolean, AVAudioSessionSetActiveOptions, NSError)	啟動和停用應用程式的音訊會話。
SetActive(Boolean, NSError)	啟用或停用應用程式的音訊會話。
SetAggregatedIOPreference(AVAudioSessionIOType, NSError)	協調音訊播放或擷取會話。
SetCategory(AVAudioSessionCategory)	要求變更。 Category
SetCategory(AVAudioSessionCategory, AVAudioSessionCategoryOptions)	要求變更。 Category
SetCategory(NSString)	弱型別;要求變更。 Category
SetCategory(NSString, NSError)	弱型別;要求變更。 Category
SetCategory(String, AVAudioSessionCategoryOptions, NSError)	弱型別;要求變更。 Category
SetCategory(String, String, AVAudioSessionCategoryOptions, NSError)	協調音訊播放或擷取會話。
SetCategory(String, String, AVAudioSessionRouteSharingPolicy, AVAudioSessionCategoryOptions, NSError)	協調音訊播放或擷取會話。
SetInputDataSource(AVAudioSessionDataSourceDescription, NSError)	選取指定的 `dataSource` 。
SetInputGain(Single, NSError)	要求特定提升層級。
SetMode(NSString, NSError)	要求特定模式。
SetNativeField(String, NSObject)	已淘汰. 協調音訊播放或擷取會話。 (繼承來源 NSObject)
SetNilValueForKey(NSString)	將指定索引鍵的值設定為 null。 (繼承來源 NSObject)
SetOutputDataSource(AVAudioSessionDataSourceDescription, NSError)	選取特定的輸出 `dataSource` 。
SetPreferredHardwareSampleRate(Double, NSError)	應用程式開發人員不應該使用此已被取代的方法。請改用 M：AVFoundation.AVAudioSession.SetPreferredSampleRate (Double、out NSError)
SetPreferredInput(AVAudioSessionPortDescription, NSError)	設定慣用的輸入資料來源。
SetPreferredInputNumberOfChannels(nint, NSError)	協調音訊播放或擷取會話。
SetPreferredIOBufferDuration(Double, NSError)	設定 IO 緩衝區的慣用持續時間，以秒為單位。
SetPreferredOutputNumberOfChannels(nint, NSError)	協調音訊播放或擷取會話。
SetPreferredSampleRate(Double, NSError)	以 Hz 設定慣用的取樣率。
SetValueForKey(NSObject, NSString)	將索引鍵所指定的屬性值設定為指定的值。 (繼承來源 NSObject)
SetValueForKeyPath(IntPtr, NSString)	建立 Unmanaged 物件的 Managed 標記法時所使用的建構函式;由執行時間呼叫。 (繼承來源 NSObject)
SetValueForKeyPath(NSObject, NSString)	設定可以使用索引鍵路徑到達的屬性值。 (繼承來源 NSObject)
SetValueForUndefinedKey(NSObject, NSString)	表示嘗試將值寫入未定義的索引鍵。如果未覆寫，會引發 NSUndefinedKeyException。 (繼承來源 NSObject)
SetValuesForKeysWithDictionary(NSDictionary)	將這個 NSObject 的值設定為指定字典中的值。 (繼承來源 NSObject)
SharedInstance()	傳回共用 AVAudioSession 物件的 Factory 方法。
ToString()	傳回目前實例值的字串表示。 (繼承來源 NSObject)
Unbind(NSString)	協調音訊播放或擷取會話。 (繼承來源 NSObject)
Unbind(String)	已淘汰. 協調音訊播放或擷取會話。 (繼承來源 NSObject)
ValueForKey(NSString)	傳回與指定索引鍵相關聯的屬性值。 (繼承來源 NSObject)
ValueForKeyPath(NSString)	傳回可以使用 keypath 到達的屬性值。 (繼承來源 NSObject)
ValueForUndefinedKey(NSString)	表示嘗試讀取未定義索引鍵的值。如果未覆寫，會引發 NSUndefinedKeyException。 (繼承來源 NSObject)
WillChange(NSKeyValueChange, NSIndexSet, NSString)	表示指定索引鍵中指定索引的值即將變更。 (繼承來源 NSObject)
WillChange(NSString, NSKeyValueSetMutationKind, NSSet)	協調音訊播放或擷取會話。 (繼承來源 NSObject)
WillChangeValue(String)	表示指定索引鍵的值即將變更。 (繼承來源 NSObject)

事件

BeginInterruption	已淘汰. 開發人員不應該使用此已被取代的方法。相反地，它們應該使用 ObserveInterruption(NSObject, EventHandler<AVAudioSessionInterruptionEventArgs>) 。
CategoryChanged	已淘汰. 事件， Category 表示已變更。
EndInterruption	已淘汰. 開發人員不應該使用此已被取代的方法。相反地，它們應該使用 ObserveInterruption(NSObject, EventHandler<AVAudioSessionInterruptionEventArgs>) 。
InputAvailabilityChanged	已淘汰. 事件，指出輸入的可用性已變更。
InputChannelsChanged	已淘汰. 已取代。不再引發此事件。
OutputChannelsChanged	已淘汰. 已取代。不再引發此事件。
SampleRateChanged	已淘汰. 事件， SampleRate 表示已變更。

擴充方法

GetDebugDescription(INSObjectProtocol)	協調音訊播放或擷取會話。
GetAccessibilityCustomRotors(NSObject)	取得物件適用的 `this` 物件陣列 UIAccessibilityCustomRotor 。
SetAccessibilityCustomRotors(NSObject, UIAccessibilityCustomRotor[])	設定適用于 `this` 物件的陣列 UIAccessibilityCustomRotor 。

適用於

另請參閱

Apple 檔 AVAudioSession

共用方式為

AVAudioSession 類別

定義

備註

建構函式

屬性

方法

事件

擴充方法

適用於

另請參閱

其他資源