Index: webrtc/modules/audio_device/ios/objc/RTCAudioSession.h |
diff --git a/webrtc/modules/audio_device/ios/objc/RTCAudioSession.h b/webrtc/modules/audio_device/ios/objc/RTCAudioSession.h |
index c0ea2163ae2a908d16d2ba49f56fc84606a9bb69..2f52ca383d1263978028dacab1ff52ea7c519009 100644 |
--- a/webrtc/modules/audio_device/ios/objc/RTCAudioSession.h |
+++ b/webrtc/modules/audio_device/ios/objc/RTCAudioSession.h |
@@ -1,5 +1,5 @@ |
/* |
- * Copyright 2016 The WebRTC Project Authors. All rights reserved. |
+ * Copyright 2017 The WebRTC Project Authors. All rights reserved. |
* |
* Use of this source code is governed by a BSD-style license |
* that can be found in the LICENSE file in the root of the source |
@@ -8,235 +8,4 @@ |
* be found in the AUTHORS file in the root of the source tree. |
*/ |
-#import <AVFoundation/AVFoundation.h> |
-#import <Foundation/Foundation.h> |
- |
-#import "WebRTC/RTCMacros.h" |
- |
-NS_ASSUME_NONNULL_BEGIN |
- |
-extern NSString * const kRTCAudioSessionErrorDomain; |
-/** Method that requires lock was called without lock. */ |
-extern NSInteger const kRTCAudioSessionErrorLockRequired; |
-/** Unknown configuration error occurred. */ |
-extern NSInteger const kRTCAudioSessionErrorConfiguration; |
- |
-@class RTCAudioSession; |
-@class RTCAudioSessionConfiguration; |
- |
-// Surfaces AVAudioSession events. WebRTC will listen directly for notifications |
-// from AVAudioSession and handle them before calling these delegate methods, |
-// at which point applications can perform additional processing if required. |
-RTC_EXPORT |
-@protocol RTCAudioSessionDelegate <NSObject> |
- |
-@optional |
-/** Called on a system notification thread when AVAudioSession starts an |
- * interruption event. |
- */ |
-- (void)audioSessionDidBeginInterruption:(RTCAudioSession *)session; |
- |
-/** Called on a system notification thread when AVAudioSession ends an |
- * interruption event. |
- */ |
-- (void)audioSessionDidEndInterruption:(RTCAudioSession *)session |
- shouldResumeSession:(BOOL)shouldResumeSession; |
- |
-/** Called on a system notification thread when AVAudioSession changes the |
- * route. |
- */ |
-- (void)audioSessionDidChangeRoute:(RTCAudioSession *)session |
- reason:(AVAudioSessionRouteChangeReason)reason |
- previousRoute:(AVAudioSessionRouteDescription *)previousRoute; |
- |
-/** Called on a system notification thread when AVAudioSession media server |
- * terminates. |
- */ |
-- (void)audioSessionMediaServerTerminated:(RTCAudioSession *)session; |
- |
-/** Called on a system notification thread when AVAudioSession media server |
- * restarts. |
- */ |
-- (void)audioSessionMediaServerReset:(RTCAudioSession *)session; |
- |
-// TODO(tkchin): Maybe handle SilenceSecondaryAudioHintNotification. |
- |
-- (void)audioSession:(RTCAudioSession *)session |
- didChangeCanPlayOrRecord:(BOOL)canPlayOrRecord; |
- |
-/** Called on a WebRTC thread when the audio device is notified to begin |
- * playback or recording. |
- */ |
-- (void)audioSessionDidStartPlayOrRecord:(RTCAudioSession *)session; |
- |
-/** Called on a WebRTC thread when the audio device is notified to stop |
- * playback or recording. |
- */ |
-- (void)audioSessionDidStopPlayOrRecord:(RTCAudioSession *)session; |
- |
-/** Called when the AVAudioSession output volume value changes. */ |
-- (void)audioSession:(RTCAudioSession *)audioSession |
- didChangeOutputVolume:(float)outputVolume; |
- |
-@end |
- |
-/** This is a protocol used to inform RTCAudioSession when the audio session |
- * activation state has changed outside of RTCAudioSession. The current known use |
- * case of this is when CallKit activates the audio session for the application |
- */ |
-RTC_EXPORT |
-@protocol RTCAudioSessionActivationDelegate <NSObject> |
- |
-/** Called when the audio session is activated outside of the app by iOS. */ |
-- (void)audioSessionDidActivate:(AVAudioSession *)session; |
- |
-/** Called when the audio session is deactivated outside of the app by iOS. */ |
-- (void)audioSessionDidDeactivate:(AVAudioSession *)session; |
- |
-@end |
- |
-/** Proxy class for AVAudioSession that adds a locking mechanism similar to |
- * AVCaptureDevice. This is used to that interleaving configurations between |
- * WebRTC and the application layer are avoided. |
- * |
- * RTCAudioSession also coordinates activation so that the audio session is |
- * activated only once. See |setActive:error:|. |
- */ |
-RTC_EXPORT |
-@interface RTCAudioSession : NSObject <RTCAudioSessionActivationDelegate> |
- |
-/** Convenience property to access the AVAudioSession singleton. Callers should |
- * not call setters on AVAudioSession directly, but other method invocations |
- * are fine. |
- */ |
-@property(nonatomic, readonly) AVAudioSession *session; |
- |
-/** Our best guess at whether the session is active based on results of calls to |
- * AVAudioSession. |
- */ |
-@property(nonatomic, readonly) BOOL isActive; |
-/** Whether RTCAudioSession is currently locked for configuration. */ |
-@property(nonatomic, readonly) BOOL isLocked; |
- |
-/** If YES, WebRTC will not initialize the audio unit automatically when an |
- * audio track is ready for playout or recording. Instead, applications should |
- * call setIsAudioEnabled. If NO, WebRTC will initialize the audio unit |
- * as soon as an audio track is ready for playout or recording. |
- */ |
-@property(nonatomic, assign) BOOL useManualAudio; |
- |
-/** This property is only effective if useManualAudio is YES. |
- * Represents permission for WebRTC to initialize the VoIP audio unit. |
- * When set to NO, if the VoIP audio unit used by WebRTC is active, it will be |
- * stopped and uninitialized. This will stop incoming and outgoing audio. |
- * When set to YES, WebRTC will initialize and start the audio unit when it is |
- * needed (e.g. due to establishing an audio connection). |
- * This property was introduced to work around an issue where if an AVPlayer is |
- * playing audio while the VoIP audio unit is initialized, its audio would be |
- * either cut off completely or played at a reduced volume. By preventing |
- * the audio unit from being initialized until after the audio has completed, |
- * we are able to prevent the abrupt cutoff. |
- */ |
-@property(nonatomic, assign) BOOL isAudioEnabled; |
- |
-// Proxy properties. |
-@property(readonly) NSString *category; |
-@property(readonly) AVAudioSessionCategoryOptions categoryOptions; |
-@property(readonly) NSString *mode; |
-@property(readonly) BOOL secondaryAudioShouldBeSilencedHint; |
-@property(readonly) AVAudioSessionRouteDescription *currentRoute; |
-@property(readonly) NSInteger maximumInputNumberOfChannels; |
-@property(readonly) NSInteger maximumOutputNumberOfChannels; |
-@property(readonly) float inputGain; |
-@property(readonly) BOOL inputGainSettable; |
-@property(readonly) BOOL inputAvailable; |
-@property(readonly, nullable) |
- NSArray<AVAudioSessionDataSourceDescription *> * inputDataSources; |
-@property(readonly, nullable) |
- AVAudioSessionDataSourceDescription *inputDataSource; |
-@property(readonly, nullable) |
- NSArray<AVAudioSessionDataSourceDescription *> * outputDataSources; |
-@property(readonly, nullable) |
- AVAudioSessionDataSourceDescription *outputDataSource; |
-@property(readonly) double sampleRate; |
-@property(readonly) double preferredSampleRate; |
-@property(readonly) NSInteger inputNumberOfChannels; |
-@property(readonly) NSInteger outputNumberOfChannels; |
-@property(readonly) float outputVolume; |
-@property(readonly) NSTimeInterval inputLatency; |
-@property(readonly) NSTimeInterval outputLatency; |
-@property(readonly) NSTimeInterval IOBufferDuration; |
-@property(readonly) NSTimeInterval preferredIOBufferDuration; |
- |
-/** Default constructor. */ |
-+ (instancetype)sharedInstance; |
-- (instancetype)init NS_UNAVAILABLE; |
- |
-/** Adds a delegate, which is held weakly. */ |
-- (void)addDelegate:(id<RTCAudioSessionDelegate>)delegate; |
-/** Removes an added delegate. */ |
-- (void)removeDelegate:(id<RTCAudioSessionDelegate>)delegate; |
- |
-/** Request exclusive access to the audio session for configuration. This call |
- * will block if the lock is held by another object. |
- */ |
-- (void)lockForConfiguration; |
-/** Relinquishes exclusive access to the audio session. */ |
-- (void)unlockForConfiguration; |
- |
-/** If |active|, activates the audio session if it isn't already active. |
- * Successful calls must be balanced with a setActive:NO when activation is no |
- * longer required. If not |active|, deactivates the audio session if one is |
- * active and this is the last balanced call. When deactivating, the |
- * AVAudioSessionSetActiveOptionNotifyOthersOnDeactivation option is passed to |
- * AVAudioSession. |
- */ |
-- (BOOL)setActive:(BOOL)active |
- error:(NSError **)outError; |
- |
-// The following methods are proxies for the associated methods on |
-// AVAudioSession. |lockForConfiguration| must be called before using them |
-// otherwise they will fail with kRTCAudioSessionErrorLockRequired. |
- |
-- (BOOL)setCategory:(NSString *)category |
- withOptions:(AVAudioSessionCategoryOptions)options |
- error:(NSError **)outError; |
-- (BOOL)setMode:(NSString *)mode error:(NSError **)outError; |
-- (BOOL)setInputGain:(float)gain error:(NSError **)outError; |
-- (BOOL)setPreferredSampleRate:(double)sampleRate error:(NSError **)outError; |
-- (BOOL)setPreferredIOBufferDuration:(NSTimeInterval)duration |
- error:(NSError **)outError; |
-- (BOOL)setPreferredInputNumberOfChannels:(NSInteger)count |
- error:(NSError **)outError; |
-- (BOOL)setPreferredOutputNumberOfChannels:(NSInteger)count |
- error:(NSError **)outError; |
-- (BOOL)overrideOutputAudioPort:(AVAudioSessionPortOverride)portOverride |
- error:(NSError **)outError; |
-- (BOOL)setPreferredInput:(AVAudioSessionPortDescription *)inPort |
- error:(NSError **)outError; |
-- (BOOL)setInputDataSource:(AVAudioSessionDataSourceDescription *)dataSource |
- error:(NSError **)outError; |
-- (BOOL)setOutputDataSource:(AVAudioSessionDataSourceDescription *)dataSource |
- error:(NSError **)outError; |
-@end |
- |
-@interface RTCAudioSession (Configuration) |
- |
-/** Applies the configuration to the current session. Attempts to set all |
- * properties even if previous ones fail. Only the last error will be |
- * returned. |
- * |lockForConfiguration| must be called first. |
- */ |
-- (BOOL)setConfiguration:(RTCAudioSessionConfiguration *)configuration |
- error:(NSError **)outError; |
- |
-/** Convenience method that calls both setConfiguration and setActive. |
- * |lockForConfiguration| must be called first. |
- */ |
-- (BOOL)setConfiguration:(RTCAudioSessionConfiguration *)configuration |
- active:(BOOL)active |
- error:(NSError **)outError; |
- |
-@end |
- |
-NS_ASSUME_NONNULL_END |
+#import "webrtc/sdk/objc/Framework/Headers/WebRTC/RTCAudioSession.h" |