1 // Copyright 2013 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
5 // AVFoundation API is only introduced in Mac OS X > 10.6, and there is only one
6 // build of Chromium, so the (potential) linking with AVFoundation has to happen
7 // in runtime. For this to be clean, an AVFoundationGlue class is defined to try
8 // and load these AVFoundation system libraries. If it succeeds, subsequent
9 // clients can use AVFoundation via the rest of the classes declared in this
12 #ifndef MEDIA_VIDEO_CAPTURE_MAC_AVFOUNDATION_GLUE_H_
13 #define MEDIA_VIDEO_CAPTURE_MAC_AVFOUNDATION_GLUE_H_
15 #import <Foundation/Foundation.h>
17 #include "base/basictypes.h"
18 #include "media/base/media_export.h"
19 #import "media/video/capture/mac/coremedia_glue.h"
21 class MEDIA_EXPORT AVFoundationGlue {
23 // This method returns true if the OS version supports AVFoundation and the
24 // AVFoundation bundle could be loaded correctly, or false otherwise.
25 static bool IsAVFoundationSupported();
27 static NSBundle const* AVFoundationBundle();
29 static void* AVFoundationLibraryHandle();
31 // Originally coming from AVCaptureDevice.h but in global namespace.
32 static NSString* AVCaptureDeviceWasConnectedNotification();
33 static NSString* AVCaptureDeviceWasDisconnectedNotification();
35 // Originally coming from AVMediaFormat.h but in global namespace.
36 static NSString* AVMediaTypeVideo();
37 static NSString* AVMediaTypeAudio();
38 static NSString* AVMediaTypeMuxed();
40 // Originally from AVCaptureSession.h but in global namespace.
41 static NSString* AVCaptureSessionRuntimeErrorNotification();
42 static NSString* AVCaptureSessionDidStopRunningNotification();
43 static NSString* AVCaptureSessionErrorKey();
45 // Originally from AVVideoSettings.h but in global namespace.
46 static NSString* AVVideoScalingModeKey();
47 static NSString* AVVideoScalingModeResizeAspectFill();
49 static Class AVCaptureSessionClass();
50 static Class AVCaptureVideoDataOutputClass();
53 DISALLOW_IMPLICIT_CONSTRUCTORS(AVFoundationGlue);
56 // Originally AVCaptureDevice and coming from AVCaptureDevice.h
58 @interface CrAVCaptureDevice : NSObject
60 - (BOOL)hasMediaType:(NSString*)mediaType;
61 - (NSString*)uniqueID;
62 - (NSString*)localizedName;
65 - (int32_t)transportType;
69 // Originally AVCaptureDeviceFormat and coming from AVCaptureDevice.h.
71 @interface CrAVCaptureDeviceFormat : NSObject
73 - (CoreMediaGlue::CMFormatDescriptionRef)formatDescription;
74 - (NSArray*)videoSupportedFrameRateRanges;
78 // Originally AVFrameRateRange and coming from AVCaptureDevice.h.
80 @interface CrAVFrameRateRange : NSObject
82 - (Float64)maxFrameRate;
87 @interface CrAVCaptureInput // Originally from AVCaptureInput.h.
91 @interface CrAVCaptureOutput // Originally from AVCaptureOutput.h.
94 // Originally AVCaptureSession and coming from AVCaptureSession.h.
96 @interface CrAVCaptureSession : NSObject
99 - (void)addInput:(CrAVCaptureInput*)input;
100 - (void)removeInput:(CrAVCaptureInput*)input;
101 - (void)addOutput:(CrAVCaptureOutput*)output;
102 - (void)removeOutput:(CrAVCaptureOutput*)output;
104 - (void)startRunning;
109 // Originally AVCaptureConnection and coming from AVCaptureSession.h.
111 @interface CrAVCaptureConnection : NSObject
113 - (BOOL)isVideoMinFrameDurationSupported;
114 - (void)setVideoMinFrameDuration:(CoreMediaGlue::CMTime)minFrameRate;
115 - (BOOL)isVideoMaxFrameDurationSupported;
116 - (void)setVideoMaxFrameDuration:(CoreMediaGlue::CMTime)maxFrameRate;
120 // Originally AVCaptureDeviceInput and coming from AVCaptureInput.h.
122 @interface CrAVCaptureDeviceInput : CrAVCaptureInput
126 // Originally AVCaptureVideoDataOutputSampleBufferDelegate from
127 // AVCaptureOutput.h.
128 @protocol CrAVCaptureVideoDataOutputSampleBufferDelegate <NSObject>
132 - (void)captureOutput:(CrAVCaptureOutput*)captureOutput
133 didOutputSampleBuffer:(CoreMediaGlue::CMSampleBufferRef)sampleBuffer
134 fromConnection:(CrAVCaptureConnection*)connection;
138 // Originally AVCaptureVideoDataOutput and coming from AVCaptureOutput.h.
140 @interface CrAVCaptureVideoDataOutput : CrAVCaptureOutput
142 - (oneway void)release;
143 - (void)setSampleBufferDelegate:(id)sampleBufferDelegate
144 queue:(dispatch_queue_t)sampleBufferCallbackQueue;
146 - (void)setVideoSettings:(NSDictionary*)videoSettings;
147 - (NSDictionary*)videoSettings;
148 - (CrAVCaptureConnection*)connectionWithMediaType:(NSString*)mediaType;
152 // Class to provide access to class methods of AVCaptureDevice.
154 @interface AVCaptureDeviceGlue : NSObject
158 + (CrAVCaptureDevice*)deviceWithUniqueID:(NSString*)deviceUniqueID;
162 // Class to provide access to class methods of AVCaptureDeviceInput.
164 @interface AVCaptureDeviceInputGlue : NSObject
166 + (CrAVCaptureDeviceInput*)deviceInputWithDevice:(CrAVCaptureDevice*)device
167 error:(NSError**)outError;
171 #endif // MEDIA_VIDEO_CAPTURE_MAC_AVFOUNDATION_GLUE_H_