Files
AudioSessionManager/AudioSessionManager.h

98 lines
3.0 KiB
Objective-C

//
// AudioSessionManager.h
//
// This module routes audio output depending on device availability using the
// following priorities: bluetooth, wired headset, speaker.
//
// It also notifies interested listeners of audio change events (optional).
//
// Copyright 2011 Jawbone Inc.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
//
#import <Foundation/Foundation.h>
#import <AVFoundation/AVFoundation.h>
extern NSString *kAudioSessionManagerMode_Record;
extern NSString *kAudioSessionManagerMode_Playback;
extern NSString *kAudioSessionManagerDevice_Headset;
extern NSString *kAudioSessionManagerDevice_Bluetooth;
extern NSString *kAudioSessionManagerDevice_Phone;
extern NSString *kAudioSessionManagerDevice_Speaker;
@interface AudioSessionManager : NSObject
/**
The current audio route.
Valid values at this time are:
- kAudioSessionManagerDevice_Bluetooth
- kAudioSessionManagerDevice_Headset
- kAudioSessionManagerDevice_Phone
- kAudioSessionManagerDevice_Speaker
*/
@property (nonatomic, assign) NSString *audioRoute;
/**
Returns YES if a wired headset is available.
*/
@property (nonatomic, readonly) BOOL headsetDeviceAvailable;
/**
Returns YES if a bluetooth device is available.
*/
@property (nonatomic, readonly) BOOL bluetoothDeviceAvailable;
/**
Returns YES if the device's earpiece is available (always true for now).
*/
@property (nonatomic, readonly) BOOL phoneDeviceAvailable;
/**
Returns YES if the device's speakerphone is available (always true for now).
*/
@property (nonatomic, readonly) BOOL speakerDeviceAvailable;
/**
Returns a list of the available audio devices. Valid values at this time are:
- kAudioSessionManagerDevice_Bluetooth
- kAudioSessionManagerDevice_Headset
- kAudioSessionManagerDevice_Phone
- kAudioSessionManagerDevice_Speaker
*/
@property (nonatomic, readonly) NSArray *availableAudioDevices;
/**
Returns the AudioSessionManager singleton, creating it if it does not already exist.
*/
+ (AudioSessionManager *)sharedInstance;
/**
Switch between recording and playback modes. Returns NO if the mode change failed.
@param value must be kAudioSessionManagerMode_Record or kAudioSessionManagerMode_Playback
*/
- (BOOL)changeMode:(NSString *)value;
/**
Initialize by detecting all available devices and selecting one based on the following priority:
- bluetooth
- headset
- speaker
*/
- (void)start;
@end