Split avfoundationcapturer classes in separate files.

webrtc/sdk/objc/Framework/Classes/RTCVideoFormatMapper.h

 /*

[magjed_webrtc, 2016/11/17 14:11:31]

I think the name of this class too generic for what it does, I would like to
include 'camera' or 'AVFoundation'. Maybe RTCAVFoundationFormatMapper?

[daniela-webrtc, 2016/11/21 10:14:20]

Done.

  *  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 RTCVideoFormatMapper : NSObject
 
-RTC_EXPORT
-@protocol RTCRtpReceiver <NSObject>
+/**
+ * Maps the list of eligible AVCaptureDeviceFormat to cricket::VideoFormat.
+ *
+ * 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>)getSupportedVideoFormatsForDevice:(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 device The device that will have new device format
+ * @param session The capture session to be configured
+ * @param format The cricket::VideoFormat to be used for retrieving the new AVCaptureDeviceFormat
+ * @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)setFormatForCaptureDevice:(AVCaptureDevice *)device
+                   captureSession:(AVCaptureSession *)session
+                           format:(const cricket::VideoFormat)format;

[kthelgason, 2016/11/21 08:38:14]

suggestion: rename to
setFormat:(format)forCaptureDevice:(device)captureSession:(session)

[daniela-webrtc, 2016/11/21 10:14:20]

Done.

 
 @end
-
-RTC_EXPORT
-@interface RTCRtpReceiver : NSObject <RTCRtpReceiver>
-
-- (instancetype)init NS_UNAVAILABLE;
-
-@end
-
-NS_ASSUME_NONNULL_END