| OLD | NEW |
| 1 /* | 1 /* |
| 2 * Copyright 2017 The WebRTC project authors. All Rights Reserved. | 2 * Copyright 2017 The WebRTC project authors. All Rights Reserved. |
| 3 * | 3 * |
| 4 * Use of this source code is governed by a BSD-style license | 4 * Use of this source code is governed by a BSD-style license |
| 5 * that can be found in the LICENSE file in the root of the source | 5 * that can be found in the LICENSE file in the root of the source |
| 6 * tree. An additional intellectual property rights grant can be found | 6 * tree. An additional intellectual property rights grant can be found |
| 7 * in the file PATENTS. All contributing project authors may | 7 * in the file PATENTS. All contributing project authors may |
| 8 * be found in the AUTHORS file in the root of the source tree. | 8 * be found in the AUTHORS file in the root of the source tree. |
| 9 */ | 9 */ |
| 10 | 10 |
| 11 #import <Foundation/Foundation.h> | 11 #import <Foundation/Foundation.h> |
| 12 | 12 |
| 13 #import <WebRTC/RTCMacros.h> | 13 #import <WebRTC/RTCMacros.h> |
| 14 | 14 |
| 15 @class RTCVideoFrame; | 15 @class RTCVideoFrame; |
| 16 | 16 |
| 17 NS_ASSUME_NONNULL_BEGIN | 17 NS_ASSUME_NONNULL_BEGIN |
| 18 | 18 |
| 19 /** Represents an encoded frame's type. */ | 19 /** Represents an encoded frame's type. */ |
| 20 typedef NS_ENUM(NSUInteger, RTCFrameType) { | 20 typedef NS_ENUM(NSUInteger, RTCFrameType) { |
| 21 EmptyFrame, | 21 EmptyFrame = 0, |
| 22 VideoFrameKey, | 22 AudioFrameSpeech = 1, |
| 23 VideoFrameDelta, | 23 AudioFrameCN = 2, |
| 24 VideoFrameKey = 3, |
| 25 VideoFrameDelta = 4, |
| 26 }; |
| 27 |
| 28 typedef NS_ENUM(NSUInteger, RTCVideoContentType) { |
| 29 Unspecified, |
| 30 Screenshare, |
| 24 }; | 31 }; |
| 25 | 32 |
| 26 /** Represents an encoded frame. Corresponds to webrtc::EncodedImage. */ | 33 /** Represents an encoded frame. Corresponds to webrtc::EncodedImage. */ |
| 27 RTC_EXPORT | 34 RTC_EXPORT |
| 28 @interface RTCEncodedImage : NSObject | 35 @interface RTCEncodedImage : NSObject |
| 29 | 36 |
| 30 @property(nonatomic, retain) NSData *buffer; | 37 @property(nonatomic, retain) NSData *buffer; |
| 31 @property(nonatomic, assign) int encodedWidth; | 38 @property(nonatomic, assign) int encodedWidth; |
| 32 @property(nonatomic, assign) int encodedHeight; | 39 @property(nonatomic, assign) int encodedHeight; |
| 33 @property(nonatomic, assign) uint32_t timeStamp; | 40 @property(nonatomic, assign) uint32_t timeStamp; |
| 34 @property(nonatomic, assign) long captureTimeMs; | 41 @property(nonatomic, assign) long captureTimeMs; |
| 35 @property(nonatomic, assign) long ntpTimeMs; | 42 @property(nonatomic, assign) long ntpTimeMs; |
| 36 @property(nonatomic, assign) BOOL isTimingFrame; | 43 @property(nonatomic, assign) BOOL isTimingFrame; |
| 37 @property(nonatomic, assign) long encodeStartMs; | 44 @property(nonatomic, assign) long encodeStartMs; |
| 38 @property(nonatomic, assign) long encodeFinishMs; | 45 @property(nonatomic, assign) long encodeFinishMs; |
| 39 @property(nonatomic, assign) RTCFrameType frameType; | 46 @property(nonatomic, assign) RTCFrameType frameType; |
| 40 @property(nonatomic, assign) int rotation; | 47 @property(nonatomic, assign) int rotation; |
| 41 @property(nonatomic, assign) BOOL completeFrame; | 48 @property(nonatomic, assign) BOOL completeFrame; |
| 42 @property(nonatomic, retain) NSNumber *qp; | 49 @property(nonatomic, retain) NSNumber *qp; |
| 50 @property(nonatomic, assign) RTCVideoContentType contentType; |
| 43 | 51 |
| 44 @end | 52 @end |
| 45 | 53 |
| 46 /** Information for header. Corresponds to webrtc::RTPFragmentationHeader. */ | 54 /** Information for header. Corresponds to webrtc::RTPFragmentationHeader. */ |
| 47 RTC_EXPORT | 55 RTC_EXPORT |
| 48 @interface RTCRtpFragmentationHeader : NSObject | 56 @interface RTCRtpFragmentationHeader : NSObject |
| 49 | 57 |
| 50 @property(nonatomic, retain) NSArray<NSNumber *> *fragmentationOffset; | 58 @property(nonatomic, retain) NSArray<NSNumber *> *fragmentationOffset; |
| 51 @property(nonatomic, retain) NSArray<NSNumber *> *fragmentationLength; | 59 @property(nonatomic, retain) NSArray<NSNumber *> *fragmentationLength; |
| 52 @property(nonatomic, retain) NSArray<NSNumber *> *fragmentationTimeDiff; | 60 @property(nonatomic, retain) NSArray<NSNumber *> *fragmentationTimeDiff; |
| 53 @property(nonatomic, retain) NSArray<NSNumber *> *fragmentationPlType; | 61 @property(nonatomic, retain) NSArray<NSNumber *> *fragmentationPlType; |
| 54 | 62 |
| 55 @end | 63 @end |
| 56 | 64 |
| 57 /** Implement this protocol to pass codec specific info from the encoder. | 65 /** Implement this protocol to pass codec specific info from the encoder. |
| 58 * Corresponds to webrtc::CodecSpecificInfo. | 66 * Corresponds to webrtc::CodecSpecificInfo. |
| 59 */ | 67 */ |
| 60 RTC_EXPORT | 68 RTC_EXPORT |
| 61 @protocol RTCCodecSpecificInfo <NSObject> | 69 @protocol RTCCodecSpecificInfo <NSObject> |
| 62 | 70 |
| 63 @end | 71 @end |
| 64 | 72 |
| 65 /** Callback block for encoder. */ | 73 /** Callback block for encoder. */ |
| 66 typedef void (^RTCVideoEncoderCallback)(RTCEncodedImage *frame, | 74 typedef BOOL (^RTCVideoEncoderCallback)(RTCEncodedImage *frame, |
| 67 id<RTCCodecSpecificInfo> info, | 75 id<RTCCodecSpecificInfo> info, |
| 68 RTCRtpFragmentationHeader *header); | 76 RTCRtpFragmentationHeader *header); |
| 69 | 77 |
| 70 /** Callback block for decoder. */ | 78 /** Callback block for decoder. */ |
| 71 typedef void (^RTCVideoDecoderCallback)(RTCVideoFrame *frame); | 79 typedef void (^RTCVideoDecoderCallback)(RTCVideoFrame *frame); |
| 72 | 80 |
| 81 typedef NS_ENUM(NSUInteger, RTCVideoCodecMode) { |
| 82 RealtimeVideo, |
| 83 Screensharing, |
| 84 }; |
| 85 |
| 73 /** Settings for encoder. Corresponds to webrtc::VideoCodec. */ | 86 /** Settings for encoder. Corresponds to webrtc::VideoCodec. */ |
| 74 RTC_EXPORT | 87 RTC_EXPORT |
| 75 @interface RTCVideoEncoderSettings : NSObject | 88 @interface RTCVideoEncoderSettings : NSObject |
| 76 | 89 |
| 77 @property(nonatomic, retain) NSString *name; | 90 @property(nonatomic, retain) NSString *name; |
| 78 | 91 |
| 79 @property(nonatomic, assign) unsigned short width; | 92 @property(nonatomic, assign) unsigned short width; |
| 80 @property(nonatomic, assign) unsigned short height; | 93 @property(nonatomic, assign) unsigned short height; |
| 81 | 94 |
| 82 @property(nonatomic, assign) unsigned int startBitrate; // kilobits/sec. | 95 @property(nonatomic, assign) unsigned int startBitrate; // kilobits/sec. |
| 83 @property(nonatomic, assign) unsigned int maxBitrate; | 96 @property(nonatomic, assign) unsigned int maxBitrate; |
| 84 @property(nonatomic, assign) unsigned int minBitrate; | 97 @property(nonatomic, assign) unsigned int minBitrate; |
| 85 @property(nonatomic, assign) unsigned int targetBitrate; | 98 @property(nonatomic, assign) unsigned int targetBitrate; |
| 86 | 99 |
| 87 @property(nonatomic, assign) uint32_t maxFramerate; | 100 @property(nonatomic, assign) uint32_t maxFramerate; |
| 88 | 101 |
| 89 @property(nonatomic, assign) unsigned int qpMax; | 102 @property(nonatomic, assign) unsigned int qpMax; |
| 103 @property(nonatomic, assign) RTCVideoCodecMode mode; |
| 90 | 104 |
| 91 @end | 105 @end |
| 92 | 106 |
| 93 /** Holds information to identify a codec. Corresponds to cricket::VideoCodec. *
/ | 107 /** Holds information to identify a codec. Corresponds to cricket::VideoCodec. *
/ |
| 94 RTC_EXPORT | 108 RTC_EXPORT |
| 95 @interface RTCVideoCodecInfo : NSObject | 109 @interface RTCVideoCodecInfo : NSObject |
| 96 | 110 |
| 97 - (instancetype)initWithPayload:(int)payload | 111 - (instancetype)initWithPayload:(int)payload |
| 98 name:(NSString *)name | 112 name:(NSString *)name |
| 99 parameters:(NSDictionary<NSString *, NSString *> *)paramete
rs; | 113 parameters:(NSDictionary<NSString *, NSString *> *)paramete
rs; |
| 100 | 114 |
| 101 @property(nonatomic, readonly) int payload; | 115 @property(nonatomic, readonly) int payload; |
| 102 @property(nonatomic, readonly) NSString *name; | 116 @property(nonatomic, readonly) NSString *name; |
| 103 @property(nonatomic, readonly) NSDictionary<NSString *, NSString *> *parameters; | 117 @property(nonatomic, readonly) NSDictionary<NSString *, NSString *> *parameters; |
| 104 | 118 |
| 105 @end | 119 @end |
| 106 | 120 |
| 107 /** Protocol for encoder implementations. */ | 121 /** Protocol for encoder implementations. */ |
| 108 RTC_EXPORT | 122 RTC_EXPORT |
| 109 @protocol RTCVideoEncoder <NSObject> | 123 @protocol RTCVideoEncoder <NSObject> |
| 110 | 124 |
| 111 - (instancetype)initWithCodecInfo:(RTCVideoCodecInfo *)codecInfo; | 125 - (instancetype)initWithCodecInfo:(RTCVideoCodecInfo *)codecInfo; |
| 112 - (void)setCallback:(RTCVideoEncoderCallback)callback; | 126 - (void)setCallback:(RTCVideoEncoderCallback)callback; |
| 113 - (int)initEncodeWithSettings:(RTCVideoEncoderSettings *)settings numberOfCores:
(int)numberOfCores; | 127 - (int)initEncodeWithSettings:(RTCVideoEncoderSettings *)settings numberOfCores:
(int)numberOfCores; |
| 114 - (int)releaseEncode; | 128 - (int)releaseEncode; |
| 115 - (int)encode:(RTCVideoFrame *)frame | 129 - (int)encode:(RTCVideoFrame *)frame |
| 116 codecSpecificInfo:(id<RTCCodecSpecificInfo>)info | 130 codecSpecificInfo:(id<RTCCodecSpecificInfo>)info |
| 117 frameTypes:(NSArray<NSNumber *> *)frameTypes; | 131 frameTypes:(NSArray<NSNumber *> *)frameTypes; |
| 118 - (BOOL)setBitrate:(uint32_t)bitrateKbit framerate:(uint32_t)framerate; | 132 - (int)setBitrate:(uint32_t)bitrateKbit framerate:(uint32_t)framerate; |
| 119 | 133 |
| 120 @end | 134 @end |
| 121 | 135 |
| 122 /** Protocol for decoder implementations. */ | 136 /** Protocol for decoder implementations. */ |
| 123 RTC_EXPORT | 137 RTC_EXPORT |
| 124 @protocol RTCVideoDecoder <NSObject> | 138 @protocol RTCVideoDecoder <NSObject> |
| 125 | 139 |
| 126 - (void)setCallback:(RTCVideoDecoderCallback)callback; | 140 - (void)setCallback:(RTCVideoDecoderCallback)callback; |
| 127 - (int)initDecodeWithSettings:(RTCVideoEncoderSettings *)settings numberOfCores:
(int)numberOfCores; | 141 - (int)initDecodeWithSettings:(RTCVideoEncoderSettings *)settings numberOfCores:
(int)numberOfCores; |
| 128 - (int)releaseDecode; | 142 - (int)releaseDecode; |
| 129 - (int)decode:(RTCEncodedImage *)encodedImage | 143 - (int)decode:(RTCEncodedImage *)encodedImage |
| 130 missingFrames:(BOOL)missingFrames | 144 missingFrames:(BOOL)missingFrames |
| 131 fragmentationHeader:(RTCRtpFragmentationHeader *)fragmentationHeader | 145 fragmentationHeader:(RTCRtpFragmentationHeader *)fragmentationHeader |
| 132 codecSpecificInfo:(__nullable id<RTCCodecSpecificInfo>)info | 146 codecSpecificInfo:(__nullable id<RTCCodecSpecificInfo>)info |
| 133 renderTimeMs:(int64_t)renderTimeMs; | 147 renderTimeMs:(int64_t)renderTimeMs; |
| 134 | 148 |
| 135 @end | 149 @end |
| 136 | 150 |
| 137 NS_ASSUME_NONNULL_END | 151 NS_ASSUME_NONNULL_END |
| OLD | NEW |