Split avfoundationcapturer classes in separate files.

webrtc/sdk/objc/Framework/Classes/RTCAVFoundationFormatMapper.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.
  */
 
+#import <AVFoundation/AVFoundation.h>
 #import <Foundation/Foundation.h>
 
-#import <WebRTC/RTCMacros.h>
-#import <WebRTC/RTCMediaStreamTrack.h>
-#import <WebRTC/RTCRtpParameters.h>
+#include "webrtc/media/base/videocapturer.h"
 
-NS_ASSUME_NONNULL_BEGIN
+/**
+ * Helper class that encapsulates the mapping between cricket::VideoFormat and
+ * AVCaptureDeviceFormat.
+ */
+@interface RTCAVFoundationFormatMapper : NSObject
 
-RTC_EXPORT
-@protocol RTCRtpReceiver <NSObject>
+/**
+ * Maps the list of eligible AVCaptureDeviceFormat to cricket::VideoFormat.

[magjed_webrtc, 2016/11/21 10:59:46]

nit: I think we should move some of these comments to the implementation in
RTCAVFoundationFormatMapper.mm. For example, we don't need to mention
AVCaptureDeviceFormat in the public function comments since they are not part of
the interface and having to deal with that type is what we encapsulate and
abstract away with this class. I think we can make the comments here more
concise if we focus only on what the caller has to care about. Something like
this:

"Returns the set of eligible formats for the given device as
cricket::VideoFormats.

The returned set is a filtered subset of all the formats from the provided
device. The filtering is
based on pixel color format and framerate (for performance reasons).
...
+
(std::set<cricket::VideoFormat>)supportedVideoFormatsForDevice:(AVCaptureDevice
*)device;"


"Set new capture format for the provided session and device.

The provided format must be one of the formats returned from
supportedVideoFormatsForDevice.
...
+ (BOOL)setFormat:(const cricket::VideoFormat)format
...
"

[daniela-webrtc, 2016/11/21 13:24:56]

Done.

+ *
+ * The list of eligible formats for the provided device is filtered list
+ * of all formats the device has.
+ * The filtering is based on submedia type and framerate (for performance reasons).
+ * This list of eligible AVCaptureDeviceFormat is then mapped onto set of cricket::VideoFormat.
+ * @param device the capture device to be used
+ * @return set of cricket::VideoFormat instances that map to the eligible formats for the device
+ */
++ (std::set<cricket::VideoFormat>)supportedVideoFormatsForDevice:(AVCaptureDevice *)device;
 
-/** A unique identifier for this receiver. */
-@property(nonatomic, readonly) NSString *receiverId;
-
-/** The currently active RTCRtpParameters, as defined in
- *  https://www.w3.org/TR/webrtc/#idl-def-RTCRtpParameters.
+/**
+ * Configures the provided capture session by setting new AVCaptureDeviceFormat to the device.
  *
- *  The WebRTC specification only defines RTCRtpParameters in terms of senders,
- *  but this API also applies them to receivers, similar to ORTC:
- *  http://ortc.org/wp-content/uploads/2016/03/ortc.html#rtcrtpparameters*.
+ * The new device format is object from the list of eligible formats that maps to the
+ * provided cricket::VideoFormat parameter.
+ * The list of eligible formats for the provided device is filtered list
+ * of all formats the device has.
+ * The filtering is based on submedia type and framerate (for performance reasons).
+ * The configuration of the session might not be successful if
+ * the device fails to lock for configuration or
+ * the new device format cannot be set as active format for the device.
+ * @param format The cricket::VideoFormat to be used for retrieving the new AVCaptureDeviceFormat
+ * @param device The device that will have new device format
+ * @param session The capture session to be configured
+ * @return YES if the session configuration was successful. No otherwise
  */
-@property(nonatomic, readonly) RTCRtpParameters *parameters;
-
-/** The RTCMediaStreamTrack associated with the receiver.
- *  Note: reading this property returns a new instance of
- *  RTCMediaStreamTrack. Use isEqual: instead of == to compare
- *  RTCMediaStreamTrack instances.
- */
-@property(nonatomic, readonly) RTCMediaStreamTrack *track;
-
++ (BOOL)setFormat:(const cricket::VideoFormat)format
+ forCaptureDevice:(AVCaptureDevice *)device
+   captureSession:(AVCaptureSession *)session;
 @end
-
-RTC_EXPORT
-@interface RTCRtpReceiver : NSObject <RTCRtpReceiver>
-
-- (instancetype)init NS_UNAVAILABLE;
-
-@end
-
-NS_ASSUME_NONNULL_END