Provide isAudioEnabled flag to control audio unit.

webrtc/modules/audio_device/ios/objc/RTCAudioSession.h

 /*
  *  Copyright 2016 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
  *  tree. An additional intellectual property rights grant can be found
  *  in the file PATENTS.  All contributing project authors may
  *  be found in the AUTHORS file in the root of the source tree.
  */
 
@@ skipping 40 matching lines @@
  */
 - (void)audioSessionMediaServicesWereLost:(RTCAudioSession *)session;
 
 /** Called on a system notification thread when AVAudioSession media server
  *  restarts.
  */
 - (void)audioSessionMediaServicesWereReset:(RTCAudioSession *)session;
 
 // TODO(tkchin): Maybe handle SilenceSecondaryAudioHintNotification.
 
-/** Called on a WebRTC thread when WebRTC needs to take over audio. Applications
- *  should call -[RTCAudioSession configureWebRTCSession] to allow WebRTC to
- *  play and record audio. Will only occur if shouldDelayAudioConfiguration is
- *  set to YES.
+- (void)audioSession:(RTCAudioSession *)session
+    didChangeCanPlayOrRecord:(BOOL)canPlayOrRecord;
+
+/** Called on a WebRTC thread when the audio device is notified to begin
+ *  playback or recording.
  */
-- (void)audioSessionShouldConfigure:(RTCAudioSession *)session;
+- (void)audioSessionDidStartPlayOrRecord:(RTCAudioSession *)session;
 
-/** Called on a WebRTC thread when WebRTC no longer requires audio. Applications
- *  should call -[RTCAudioSession unconfigureWebRTCSession] to restore their
- *  audio session settings. Will only occur if shouldDelayAudioConfiguration is
- *  set to YES.
+/** Called on a WebRTC thread when the audio device is notified to stop
+ *  playback or recording.
  */
-- (void)audioSessionShouldUnconfigure:(RTCAudioSession *)session;
-
-/** Called on a WebRTC thread when WebRTC has configured the audio session for
- *  WebRTC audio.
- */
-- (void)audioSessionDidConfigure:(RTCAudioSession *)session;
-
-/** Called on a WebRTC thread when WebRTC has unconfigured the audio session for
- *  WebRTC audio.
- */
-- (void)audioSessionDidUnconfigure:(RTCAudioSession *)session;
+- (void)audioSessionDidStopPlayOrRecord:(RTCAudioSession *)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:|.
  */
 @interface RTCAudioSession : NSObject
 
 /** 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
- *  listen to the delegate method |audioSessionShouldConfigure| and configure
- *  the session manually. This should be set before making WebRTC media calls
- *  and should not be changed while a call is active.
+ *  call setIsWebRTCAudioEnabled. If NO, WebRTC will initialize the audio unit
+ *  as soon as an audio track is ready for playout or recording.
  */
-@property(nonatomic, assign) BOOL shouldDelayAudioConfiguration;
+@property(nonatomic, assign) BOOL useManualAudio;
+/** Setting this to YES will cause the audio session to be configured for WebRTC

[henrika_webrtc, 2016/05/04 12:33:07]

Rather tricky to read IMHO. Can you add an example or a slightly more simple
comment as well which explains the usage from a higher level?

[tkchin_webrtc, 2016/05/05 23:23:28]

Better?

[henrika_webrtc, 2016/05/06 11:22:16]

Perfect ;-)

+ *  and activated, and the audio unit to be initialized and started, provided
+ *  an audio track is active. Likewise, setting this to NO will terminate any
+ *  current audio. This property is ignored if useManualAudio is NO.
+ */
+@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;
 
@@ skipping 36 matching lines @@
                     error:(NSError **)outError;
 - (BOOL)setInputDataSource:(AVAudioSessionDataSourceDescription *)dataSource
                      error:(NSError **)outError;
 - (BOOL)setOutputDataSource:(AVAudioSessionDataSourceDescription *)dataSource
                       error:(NSError **)outError;
 
 @end
 
 @interface RTCAudioSession (Configuration)
 
-/** Whether or not |configureWebRTCSession| has been called without a balanced
- *  call to |unconfigureWebRTCSession|. This is not an indication of whether the
- *  audio session has the right settings.
- */
-@property(readonly) BOOL isConfiguredForWebRTC;
-
 /** Applies the configuration to the current session. Attempts to set all
  *  properties even if previous ones fail. Only the last error will be
- *  returned. Also calls setActive with |active|.
+ *  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;
 
-/** Configure the audio session for WebRTC. This call will fail if the session
- *  is already configured. On other failures, we will attempt to restore the
- *  previously used audio session configuration.
- *  |lockForConfiguration| must be called first.
- *  Successful calls to configureWebRTCSession must be matched by calls to
- *  |unconfigureWebRTCSession|.
- */
-- (BOOL)configureWebRTCSession:(NSError **)outError;
-
-/** Unconfigures the session for WebRTC. This will attempt to restore the
- *  audio session to the settings used before |configureWebRTCSession| was
- *  called.
- *  |lockForConfiguration| must be called first.
- */
-- (BOOL)unconfigureWebRTCSession:(NSError **)outError;
-
 @end
 
 NS_ASSUME_NONNULL_END