AVAudioSession setCategory availability in Swift 4.2

iOS 10+

If you are targeting iOS 10+, just transition to the new API and use:

try AVAudioSession.sharedInstance().setCategory(.playAndRecord, mode: .default, options: [])

Older iOS versions

When you try this for an app targeting an older iOS version (for example iOS 9) you will get an setCategory(_:mode:options:)' is only available on iOS 10.0 or newer Error.

This has been reported as an error in Apple's API and fixed in Xcode 10.2. For older Xcode versions (for example Xcode 10.1) there is a workaround I found. When you create an Objective-C helper as described you can still access the old API because it is still exposed for Objective-C.

Workaround 1: .perform() Method

If you want a quick inline fix without the error handling, you can call the Obj.-C API with the .perform() method:

if #available(iOS 10.0, *) {
  try AVAudioSession.sharedInstance().setCategory(.playback, mode: .default, options: [])
} else { 
  // Set category with options (iOS 9+) setCategory(_:options:)       
  AVAudioSession.sharedInstance().perform(NSSelectorFromString("setCategory:withOptions:error:"), with: AVAudioSession.Category.playback, with:  [])

  // Set category without options (<= iOS 9) setCategory(_:)
  AVAudioSession.sharedInstance().perform(NSSelectorFromString("setCategory:error:"), with: AVAudioSession.Category.playback)
}

Workaround 2: Helper class method

Here are the steps how to do it right now if you want some more control over errors

  1. Create a new Objective-C file in my case AudioSessionHelper.m. When prompted if a Bridging Header File should be created, click Yes (If you don't already have one in your project)
  2. Create a new Header file AudioSessionHelper.h
  3. Insert Code
AudioSessionHelper.h
#ifndef AudioSessionHelper_h
#define AudioSessionHelper_h
#import <AVFoundation/AVFoundation.h>

@interface AudioSessionHelper: NSObject
+ (BOOL) setAudioSessionWithError:(NSError **) error;
@end

#endif /* AudioSessionHelper_h */
AudioSessionHelper.m
#import "AudioSessionHelper.h"
#import <Foundation/Foundation.h>

@implementation AudioSessionHelper: NSObject

+ (BOOL) setAudioSessionWithError:(NSError **) error {
    BOOL success = [[AVAudioSession sharedInstance] setCategory:AVAudioSessionCategoryPlayback error:error];
    if (!success && error) {
        return false;
    } else {
        return true;
    }
}
@end
  1. Insert your helper class into Bridging Header File
[PROJECT]-Bridging-Header.h
#import "AudioSessionHelper.h"
  1. Use it in your Swift project
if #available(iOS 10.0, *) {
    try AVAudioSession.sharedInstance().setCategory(.playback, mode: .default, options: [])
} else {
    try AudioSessionHelper.setAudioSession()
}

This is a not beautiful and adds lots of unnecessary code and files to your project, so use it if you urgently want or must use Swift 4.2 on Xcode 10.1 right now. In all other cases you would be better off using Xcode 10.2.


What I do is call setCategory(_:mode:options:). The options: parameter may be omitted, and if you have no mode, you can use a mode of .default.