docs(TcgSdk): release 3.12

jeffgaogao · jeffgaogao · commit bad761d5fc9c · 2025-11-19T11:36:41.000+08:00
diff --git a/Doc/Release_Notes_EN-US.md b/Doc/Release_Notes_EN-US.md
@@ -1,5 +1,13 @@
 [中文文档](历史版本.md)
 
+### Version 3.12.0 (2025-11.19)
+Features
+- Added a new uplink video weak network degradation strategy interface to TcrSession. Strategies include: [disabled], [Maintain frame rate], [Maintain resolution], [Balanced].
+- Added uplink resolution, uplink packet loss rate, and uplink encoding bitrate metrics to CLIENT_STATS.
+
+- Bug Fixes
+- Fixed and optimized some known issues.
+
 ### Version 3.11.0 (2025-10.29)
 Features
 - CLIENT_STATS event adds audio and video upstream frame rate data.
diff --git a/Doc/历史版本.md b/Doc/历史版本.md
@@ -1,5 +1,13 @@
 [English document](Release_Notes_EN-US.md)
 
+### Version 3.12.0 (2025-11.19)
+Features
+- TcrSession新增上行视频弱网降级策略接口，可选择【不降级】、【维持帧率】、【维持分辨率】、【平衡】策略
+- CLIENT_STATS新增上行分辨率、上行丢包率、上行编码码率指标
+
+Bug Fixes
+- 修复和优化一些已知问题
+
 ### Version 3.11.0 (2025-10.29)
 Features
 - CLIENT_STATS事件新增音视频上行帧率数据
diff --git a/SDK/TCRSDK.framework/Headers/TcrSession.h b/SDK/TCRSDK.framework/Headers/TcrSession.h
@@ -203,6 +203,24 @@
                   maxBitrate:(int)maxBitrate
                isFrontCamera:(BOOL)isFrontCamera;
 
+/**
+ * Set the local video profile.
+ *
+ * @param width The frame width, range[128, 1920]. Suggested value: 1280.
+ * @param height The frame height, range[128, 1920]. Suggested value: 720.
+ * @param fps The frame rate must be greater than 0 Default value: `30`.
+ * @param minBitrate The minimum bitrate in Kbps. Value range: [1000,15000]. Default value: `1000`.
+ * @param maxBitrate The maximum bitrate in Kbps. Value range: [1000,15000]. Default value: `15000`.
+ * @param degrationPreference Specifies the preferred way the WebRTC layer should handle optimizing bandwidth against quality in constrained-bandwidth situations. The possible values are RTCDegradationPreferenceDisabled, RTCDegradationPreferenceMaintainFramerate, RTCDegradationPreferenceMaintainResolution or RTCDegradationPreferenceBalanced. The default value is RTCDegradationPreferenceBalanced.
+ */
+- (void)setLocalVideoProfile:(int)width
+                      height:(int)height
+                         fps:(int)fps
+                  minBitrate:(int)minBitrate
+                  maxBitrate:(int)maxBitrate
+               isFrontCamera:(BOOL)isFrontCamera
+               degrationPreference:(RTCDegradationPreference)degrationPreference;
+
 /**
  * Set the playing profile of the remote audio.
  *
diff --git a/SDK/TCRSDK.framework/TCRSDK b/SDK/TCRSDK.framework/TCRSDK
diff --git a/TCRSDK.podspec b/TCRSDK.podspec
@@ -1,6 +1,6 @@
 Pod::Spec.new do |spec|
   spec.name         = 'TCRSDK'
-  spec.version      = '3.11.0'
+  spec.version      = '3.12.0'
   spec.license      = { :type => 'MIT' }
   spec.homepage     = 'https://github.com/tencentyun/cloudgame-ios-sdk'
   spec.summary      = 'Tencent Cloud Gaming Software Development Kit for iOS.'
