iOS: Force audio output to speakers while headphones are plugged in

iOS: Force audio output to speakers while headphones are plugged in 
After much searching through Apple documentation and scarce examples of what I wanted to do, I came up with the following code. A client wanted to play audio through the iPhone/iPad speakers while a microphone was plugged in. While this solution can't do both at the same time, it will let you switch back and forth between playing sounds through the speakers, then record through a microphone or a headset, without unplugging anything. It will also default to use the internal microphone and speakers if nothing is plugged in. Note that by calling the setup method, audio output will initially be forced through the speakers, rather than the headphones, if plugged in. Hopefully this code helps someone facing similar issues.

AudioRouter.h

1. @interface AudioRouter : NSObject
3. + (void) initAudioSessionRouting;
4. + (void) switchToDefaultHardware;
5. + (void) forceOutputToBuiltInSpeakers;
8. @end

AudioRouter.m

1. #import "AudioRouter.h"
2. #import
3. #import
5. @implementation AudioRouter
7. #define IS_DEBUGGING NO
8. #define IS_DEBUGGING_EXTRA_INFO NO
10. + (void) initAudioSessionRouting {
12. // Called once to route all audio through speakers, even if something's plugged into the headphone jack
13. static BOOL audioSessionSetup = NO;
14. if (audioSessionSetup == NO) {
16. // set category to accept properties assigned below
17. NSError *sessionError = nil;
18. [[AVAudioSession sharedInstance] setCategory:AVAudioSessionCategoryPlayAndRecord withOptions:AVAudioSessionCategoryOptionDefaultToSpeaker error: &sessionError];
20. // Doubly force audio to come out of speaker
21. UInt32 audioRouteOverride = kAudioSessionOverrideAudioRoute_Speaker;
22. AudioSessionSetProperty (kAudioSessionProperty_OverrideAudioRoute, sizeof(audioRouteOverride), &audioRouteOverride);
24. // fix issue with audio interrupting video recording - allow audio to mix on top of other media
25. UInt32 doSetProperty = 1;
26. AudioSessionSetProperty (kAudioSessionProperty_OverrideCategoryMixWithOthers, sizeof(doSetProperty), &doSetProperty);
28. // set active
29. [[AVAudioSession sharedInstance] setDelegate:self];
30. [[AVAudioSession sharedInstance] setActive: YES error: nil];
32. // add listener for audio input changes
33. AudioSessionAddPropertyListener (kAudioSessionProperty_AudioRouteChange, onAudioRouteChange, nil );
34. AudioSessionAddPropertyListener (kAudioSessionProperty_AudioInputAvailable, onAudioRouteChange, nil );
36. }
38. // Force audio to come out of speaker
39. [[AVAudioSession sharedInstance] overrideOutputAudioPort:AVAudioSessionPortOverrideSpeaker error:nil];
42. // set flag
43. audioSessionSetup = YES;
44. }
46. + (void) switchToDefaultHardware {
47. // Remove forcing to built-in speaker
48. UInt32 audioRouteOverride = kAudioSessionOverrideAudioRoute_None;
49. AudioSessionSetProperty (kAudioSessionProperty_OverrideAudioRoute, sizeof(audioRouteOverride), &audioRouteOverride);
50. }
52. + (void) forceOutputToBuiltInSpeakers {
53. // Re-force audio to come out of speaker
54. UInt32 audioRouteOverride = kAudioSessionOverrideAudioRoute_Speaker;
55. AudioSessionSetProperty (kAudioSessionProperty_OverrideAudioRoute, sizeof(audioRouteOverride), &audioRouteOverride);
58. }
60. void onAudioRouteChange (void* clientData, AudioSessionPropertyID inID, UInt32 dataSize, const void* inData) {
62. if( IS_DEBUGGING == YES ) {
63. NSLog(@"==== Audio Harware Status ====");
64. NSLog(@"Current Input: %@", [AudioRouter getAudioSessionInput]);
65. NSLog(@"Current Output: %@", [AudioRouter getAudioSessionOutput]);
66. NSLog(@"Current hardware route: %@", [AudioRouter getAudioSessionRoute]);
67. NSLog(@"==============================");
68. }
70. if( IS_DEBUGGING_EXTRA_INFO == YES ) {
71. NSLog(@"==== Audio Harware Status (EXTENDED) ====");
72. CFDictionaryRef dict = (CFDictionaryRef)inData;
73. CFNumberRef reason = CFDictionaryGetValue(dict, kAudioSession_RouteChangeKey_Reason);
74. CFDictionaryRef oldRoute = CFDictionaryGetValue(dict, kAudioSession_AudioRouteChangeKey_PreviousRouteDescription);
75. CFDictionaryRef newRoute = CFDictionaryGetValue(dict, kAudioSession_AudioRouteChangeKey_CurrentRouteDescription);
76. NSLog(@"Audio old route: %@", oldRoute);
77. NSLog(@"Audio new route: %@", newRoute);
78. NSLog(@"=========================================");
79. }
83. }
85. + (NSString*) getAudioSessionInput {
86. UInt32 routeSize;
87. AudioSessionGetPropertySize(kAudioSessionProperty_AudioRouteDescription, &routeSize);
88. CFDictionaryRef desc; // this is the dictionary to contain descriptions
90. // make the call to get the audio description and populate the desc dictionary
91. AudioSessionGetProperty (kAudioSessionProperty_AudioRouteDescription, &routeSize, &desc);
93. // the dictionary contains 2 keys, for input and output. Get output array
94. CFArrayRef outputs = CFDictionaryGetValue(desc, kAudioSession_AudioRouteKey_Inputs);
96. // the output array contains 1 element - a dictionary
97. CFDictionaryRef diction = CFArrayGetValueAtIndex(outputs, 0);
99. // get the output description from the dictionary
100. CFStringRef input = CFDictionaryGetValue(diction, kAudioSession_AudioRouteKey_Type);
101. return [NSString stringWithFormat:@"%@", input];
102. }
104. + (NSString*) getAudioSessionOutput {
105. UInt32 routeSize;
106. AudioSessionGetPropertySize(kAudioSessionProperty_AudioRouteDescription, &routeSize);
107. CFDictionaryRef desc; // this is the dictionary to contain descriptions
109. // make the call to get the audio description and populate the desc dictionary
110. AudioSessionGetProperty (kAudioSessionProperty_AudioRouteDescription, &routeSize, &desc);
112. // the dictionary contains 2 keys, for input and output. Get output array
113. CFArrayRef outputs = CFDictionaryGetValue(desc, kAudioSession_AudioRouteKey_Outputs);
115. // the output array contains 1 element - a dictionary
116. CFDictionaryRef diction = CFArrayGetValueAtIndex(outputs, 0);
118. // get the output description from the dictionary
119. CFStringRef output = CFDictionaryGetValue(diction, kAudioSession_AudioRouteKey_Type);
120. return [NSString stringWithFormat:@"%@", output];
121. }
123. + (NSString*) getAudioSessionRoute {
124. /*
125. returns the current session route:
126. * ReceiverAndMicrophone
127. * HeadsetInOut
128. * Headset
129. * HeadphonesAndMicrophone
130. * Headphone
131. * SpeakerAndMicrophone
132. * Speaker
133. * HeadsetBT
134. * LineInOut
135. * Lineout
136. * Default
137. */
139. UInt32 rSize = sizeof (CFStringRef);
140. CFStringRef route;
141. AudioSessionGetProperty (kAudioSessionProperty_AudioRoute, &rSize, &route);
143. if (route == NULL) {
144. NSLog(@"Silent switch is currently on");
145. return @"None";
146. }
147. return [NSString stringWithFormat:@"%@", route];
148. }
150. @end