Merge pull request #80 from HeraShowFeng/v5.2.7-release

v5.2.7 release

APIDiffs/api-diffs-5.2.7.md

@@ -0,0 +1,17 @@
+# QNRTCKit 5.2.6 to 5.2.7 API Differences
+
+## General Headers
+
+```
+QNMicrophoneAudioTrackDelegate
+```
+- *Added*  method `- (void)microphoneAudioTrack:(QNMicrophoneAudioTrack *)microphoneAudioTrack didFailWithError:(NSError *)error;`
+
+
+```
+QNMicrophoneAudioTrack
+```
+- *Added*  method `@property (nonatomic, weak) id<QNMicrophoneAudioTrackDelegate> microphoneDelegate;`
+- *Added*  method `- (BOOL)startRecording;`
+- *Added*  method `- (BOOL)stopRecording;`
+- *Added*  method `- (void)pushAudioFrame:(const uint8_t*)data dataSize:(uint32_t)dataSize bitsPerSample:(uint32_t)bitsPerSample sampleRate:(uint32_t)sampleRate channels:(uint32_t)channels bigEndian:(bool)bigEndian planar:(bool)planar;`

Pod/iphoneos/QNRTCKit.framework.dSYM/Contents/Info.plist

@@ -13,7 +13,7 @@
 		<key>CFBundleSignature</key>
 		<string>????</string>
 		<key>CFBundleShortVersionString</key>
-		<string>5.2.6</string>
+		<string>5.2.7</string>
 		<key>CFBundleVersion</key>
 		<string>1</string>
 	</dict>

Pod/iphoneos/QNRTCKit.framework/Headers/QNTrack.h

@@ -198,11 +198,50 @@ NS_ASSUME_NONNULL_BEGIN
 
 @end
 
+@class QNMicrophoneAudioTrack;
+@protocol QNMicrophoneAudioTrackDelegate <NSObject>
+
+@optional
+
+/*!
+ * @abstract 麦克风采集运行过程中发生错误会通过该方法回调。
+ *
+ * @since v5.2.7
+ */
+- (void)microphoneAudioTrack:(QNMicrophoneAudioTrack *)microphoneAudioTrack didFailWithError:(NSError *)error;
+
+@end
+
 #pragma mark -- QNMicrophoneAudioTrack
 @interface QNMicrophoneAudioTrack : QNLocalAudioTrack
 
+/*!
+ * @abstract 麦克风 Track 回调代理。
+ *
+ * @since v5.2.7
+ */
+@property (nonatomic, weak) id<QNMicrophoneAudioTrackDelegate> microphoneDelegate;
+
 - (instancetype)init NS_UNAVAILABLE;
 
+/*!
+ * @abstract 开始麦克风采集
+ *
+ * @return 是否调用成功
+ *
+ * @since v5.2.7
+ */
+- (BOOL)startRecording;
+
+/*!
+ * @abstract 停止麦克风采集
+ *
+ * @return 是否调用成功
+ *
+ * @since v5.2.7
+ */
+- (BOOL)stopRecording;
+
 @end
 
 #pragma mark -- QNCustomAudioTrack
@@ -254,7 +293,28 @@ NS_ASSUME_NONNULL_BEGIN
  */
 - (void)pushAudioBuffer:(AudioBuffer *)audioBuffer asbd:(AudioStreamBasicDescription *)asbd;
 
-
+/*!
+ * @abstract 导入音频数据
+ *
+ * @discussion 支持的音频数据格式为：PCM 格式
+ *
+ * @warning 音频数据的格式信息，请务必对应实际数据信息传入
+ *
+ * @param data PCM 裸数据
+ *
+ * @param bitsPerSample 位宽
+ *
+ * @param sampleRate 采样率
+ *
+ * @param channels 声道数
+ *
+ * @param bigEndian 是否是大端，默认是小端
+ *
+ * @param planar 是否是平面结构，双声道模式下，默认是 packed
+ *
+ * @since v5.2.7
+ */
+- (void)pushAudioFrame:(const uint8_t*)data dataSize:(uint32_t)dataSize bitsPerSample:(uint32_t)bitsPerSample sampleRate:(uint32_t)sampleRate channels:(uint32_t)channels bigEndian:(bool)bigEndian planar:(bool)planar;
 @end
 
 #pragma mark -- QNLocalVideoTrackDelegate

Pod/universal/QNRTCKit.framework.dSYM/Contents/Info.plist

@@ -13,7 +13,7 @@
 		<key>CFBundleSignature</key>
 		<string>????</string>
 		<key>CFBundleShortVersionString</key>
-		<string>5.2.6</string>
+		<string>5.2.7</string>
 		<key>CFBundleVersion</key>
 		<string>1</string>
 	</dict>

Pod/universal/QNRTCKit.framework/Headers/QNTrack.h

@@ -198,11 +198,50 @@ NS_ASSUME_NONNULL_BEGIN
 
 @end
 
+@class QNMicrophoneAudioTrack;
+@protocol QNMicrophoneAudioTrackDelegate <NSObject>
+
+@optional
+
+/*!
+ * @abstract 麦克风采集运行过程中发生错误会通过该方法回调。
+ *
+ * @since v5.2.7
+ */
+- (void)microphoneAudioTrack:(QNMicrophoneAudioTrack *)microphoneAudioTrack didFailWithError:(NSError *)error;
+
+@end
+
 #pragma mark -- QNMicrophoneAudioTrack
 @interface QNMicrophoneAudioTrack : QNLocalAudioTrack
 
+/*!
+ * @abstract 麦克风 Track 回调代理。
+ *
+ * @since v5.2.7
+ */
+@property (nonatomic, weak) id<QNMicrophoneAudioTrackDelegate> microphoneDelegate;
+
 - (instancetype)init NS_UNAVAILABLE;
 
+/*!
+ * @abstract 开始麦克风采集
+ *
+ * @return 是否调用成功
+ *
+ * @since v5.2.7
+ */
+- (BOOL)startRecording;
+
+/*!
+ * @abstract 停止麦克风采集
+ *
+ * @return 是否调用成功
+ *
+ * @since v5.2.7
+ */
+- (BOOL)stopRecording;
+
 @end
 
 #pragma mark -- QNCustomAudioTrack
@@ -254,7 +293,28 @@ NS_ASSUME_NONNULL_BEGIN
  */
 - (void)pushAudioBuffer:(AudioBuffer *)audioBuffer asbd:(AudioStreamBasicDescription *)asbd;
 
-
+/*!
+ * @abstract 导入音频数据
+ *
+ * @discussion 支持的音频数据格式为：PCM 格式
+ *
+ * @warning 音频数据的格式信息，请务必对应实际数据信息传入
+ *
+ * @param data PCM 裸数据
+ *
+ * @param bitsPerSample 位宽
+ *
+ * @param sampleRate 采样率
+ *
+ * @param channels 声道数
+ *
+ * @param bigEndian 是否是大端，默认是小端
+ *
+ * @param planar 是否是平面结构，双声道模式下，默认是 packed
+ *
+ * @since v5.2.7
+ */
+- (void)pushAudioFrame:(const uint8_t*)data dataSize:(uint32_t)dataSize bitsPerSample:(uint32_t)bitsPerSample sampleRate:(uint32_t)sampleRate channels:(uint32_t)channels bigEndian:(bool)bigEndian planar:(bool)planar;
 @end
 
 #pragma mark -- QNLocalVideoTrackDelegate

QNRTC-API-Examples/Podfile

@@ -1,5 +1,5 @@
 # Uncomment the next line to define a global platform for your project
-# platform :ios, '9.0'
+# platform :ios, '11.0'
 
 target 'Api-Examples-iOS' do
   # Comment the next line if you don't want to use dynamic frameworks

QNRTC-API-Examples/Podfile.lock

@@ -1,8 +1,8 @@
 PODS:
   - Masonry (1.1.0)
-  - QNRTCKit-iOS (5.2.6):
-    - QNRTCKit-iOS/Core (= 5.2.6)
-  - QNRTCKit-iOS/Core (5.2.6)
+  - QNRTCKit-iOS (5.2.7):
+    - QNRTCKit-iOS/Core (= 5.2.7)
+  - QNRTCKit-iOS/Core (5.2.7)
 
 DEPENDENCIES:
   - Masonry (= 1.1.0)
@@ -18,8 +18,8 @@ EXTERNAL SOURCES:
 
 SPEC CHECKSUMS:
   Masonry: 678fab65091a9290e40e2832a55e7ab731aad201
-  QNRTCKit-iOS: 8a3fe030639f0be630bf811a3b3bb8fb190c2692
+  QNRTCKit-iOS: c3ceac7cf62c755bbd1d05af5cb98b171b1c4581
 
-PODFILE CHECKSUM: c720700c5f736c56079e4fdd029795870c4a4043
+PODFILE CHECKSUM: e7771e20c9aac4bcb5ef9d2b4aa243675bd09687
 
 COCOAPODS: 1.12.1