-
+ public abstract int setRemoteRenderTargetFps(int targetFps);
-
-
+ - (int)setRemoteRenderTargetFps:(int)targetFps;
+ virtual int setRemoteRenderTargetFps(int targetFps) = 0;
diff --git a/dita/RTC-NG/API/api_irtcengine_startscreencapturebydisplayid.dita b/dita/RTC-NG/API/api_irtcengine_startscreencapturebydisplayid.dita
index a60de8c5707..a910e52c60f 100644
--- a/dita/RTC-NG/API/api_irtcengine_startscreencapturebydisplayid.dita
+++ b/dita/RTC-NG/API/api_irtcengine_startscreencapturebydisplayid.dita
@@ -19,7 +19,7 @@
regionRect:(CGRect)regionRect
captureParams:(AgoraScreenCaptureParameters *_Nonnull)captureParams;
- virtual int startScreenCaptureByDisplayId(uint32_t displayId, const Rectangle& regionRect,
+ virtual int startScreenCaptureByDisplayId(int64_t displayId, const Rectangle& regionRect,
const ScreenCaptureParameters& captureParams) = 0;
UFUNCTION(BlueprintCallable, Category = "Agora|IRtcEngine")
diff --git a/dita/RTC-NG/API/class_videoencoderconfiguration.dita b/dita/RTC-NG/API/class_videoencoderconfiguration.dita
index c05e0a09590..b844d174ef4 100644
--- a/dita/RTC-NG/API/class_videoencoderconfiguration.dita
+++ b/dita/RTC-NG/API/class_videoencoderconfiguration.dita
@@ -80,6 +80,7 @@
}
}
public enum COMPRESSION_PREFERENCE {
+ PREFER_COMPRESSION_AUTO(-1),
PREFER_LOW_LATENCY(0),
PREFER_QUALITY(1);
private int value;
@@ -102,11 +103,12 @@
}
public AdvanceOptions() {
this.encodingPreference = ENCODING_PREFERENCE.PREFER_AUTO;
- this.compressionPreference = COMPRESSION_PREFERENCE.PREFER_LOW_LATENCY;
+ this.compressionPreference = COMPRESSION_PREFERENCE.PREFER_COMPRESSION_AUTO;
this.encodeAlpha = false;
}
}
public enum DEGRADATION_PREFERENCE {
+ MAINTAIN_AUTO(-1),
MAINTAIN_QUALITY(0),
MAINTAIN_FRAMERATE(1),
MAINTAIN_BALANCED(2),
@@ -153,7 +155,6 @@
VIDEO_CODEC_H264(2),
VIDEO_CODEC_H265(3),
VIDEO_CODEC_GENERIC(6),
- VIDEO_CODEC_GENERIC_H264(7),
VIDEO_CODEC_AV1(12),
VIDEO_CODEC_VP9(13),
VIDEO_CODEC_GENERIC_JPEG(20);
@@ -187,10 +188,10 @@
this.bitrate = STANDARD_BITRATE;
this.minBitrate = DEFAULT_MIN_BITRATE;
this.orientationMode = ORIENTATION_MODE.ORIENTATION_MODE_ADAPTIVE;
- this.degradationPrefer = DEGRADATION_PREFERENCE.MAINTAIN_QUALITY;
+ this.degradationPrefer = DEGRADATION_PREFERENCE.MAINTAIN_AUTO;
this.mirrorMode = MIRROR_MODE_TYPE.MIRROR_MODE_DISABLED;
this.advanceOptions = new AdvanceOptions(
- ENCODING_PREFERENCE.PREFER_AUTO, COMPRESSION_PREFERENCE.PREFER_LOW_LATENCY, false);
+ ENCODING_PREFERENCE.PREFER_AUTO, COMPRESSION_PREFERENCE.PREFER_COMPRESSION_AUTO, false);
this.codecType = VIDEO_CODEC_TYPE.VIDEO_CODEC_NONE;
}
public VideoEncoderConfiguration(VideoDimensions dimensions, FRAME_RATE frameRate, int bitrate,
@@ -201,10 +202,10 @@
this.bitrate = bitrate;
this.minBitrate = DEFAULT_MIN_BITRATE;
this.orientationMode = orientationMode;
- this.degradationPrefer = DEGRADATION_PREFERENCE.MAINTAIN_QUALITY;
+ this.degradationPrefer = DEGRADATION_PREFERENCE.MAINTAIN_AUTO;
this.mirrorMode = MIRROR_MODE_TYPE.MIRROR_MODE_DISABLED;
this.advanceOptions = new AdvanceOptions(
- ENCODING_PREFERENCE.PREFER_AUTO, COMPRESSION_PREFERENCE.PREFER_LOW_LATENCY, false);
+ ENCODING_PREFERENCE.PREFER_AUTO, COMPRESSION_PREFERENCE.PREFER_COMPRESSION_AUTO, false);
this.codecType = VIDEO_CODEC_TYPE.VIDEO_CODEC_NONE;
}
public VideoEncoderConfiguration(VideoDimensions dimensions, FRAME_RATE frameRate, int bitrate,
@@ -215,10 +216,10 @@
this.bitrate = bitrate;
this.minBitrate = DEFAULT_MIN_BITRATE;
this.orientationMode = orientationMode;
- this.degradationPrefer = DEGRADATION_PREFERENCE.MAINTAIN_QUALITY;
+ this.degradationPrefer = DEGRADATION_PREFERENCE.MAINTAIN_AUTO;
this.mirrorMode = mirrorMode;
this.advanceOptions = new AdvanceOptions(
- ENCODING_PREFERENCE.PREFER_AUTO, COMPRESSION_PREFERENCE.PREFER_LOW_LATENCY, false);
+ ENCODING_PREFERENCE.PREFER_AUTO, COMPRESSION_PREFERENCE.PREFER_COMPRESSION_AUTO, false);
this.codecType = VIDEO_CODEC_TYPE.VIDEO_CODEC_NONE;
}
public VideoEncoderConfiguration(
@@ -229,10 +230,10 @@
this.bitrate = bitrate;
this.minBitrate = DEFAULT_MIN_BITRATE;
this.orientationMode = orientationMode;
- this.degradationPrefer = DEGRADATION_PREFERENCE.MAINTAIN_QUALITY;
+ this.degradationPrefer = DEGRADATION_PREFERENCE.MAINTAIN_AUTO;
this.mirrorMode = MIRROR_MODE_TYPE.MIRROR_MODE_DISABLED;
this.advanceOptions = new AdvanceOptions(
- ENCODING_PREFERENCE.PREFER_AUTO, COMPRESSION_PREFERENCE.PREFER_LOW_LATENCY, false);
+ ENCODING_PREFERENCE.PREFER_AUTO, COMPRESSION_PREFERENCE.PREFER_COMPRESSION_AUTO, false);
this.codecType = VIDEO_CODEC_TYPE.VIDEO_CODEC_NONE;
}
public VideoEncoderConfiguration(int width, int height, FRAME_RATE frameRate, int bitrate,
@@ -243,10 +244,10 @@
this.bitrate = bitrate;
this.minBitrate = DEFAULT_MIN_BITRATE;
this.orientationMode = orientationMode;
- this.degradationPrefer = DEGRADATION_PREFERENCE.MAINTAIN_QUALITY;
+ this.degradationPrefer = DEGRADATION_PREFERENCE.MAINTAIN_AUTO;
this.mirrorMode = mirrorMode;
this.advanceOptions = new AdvanceOptions(
- ENCODING_PREFERENCE.PREFER_AUTO, COMPRESSION_PREFERENCE.PREFER_LOW_LATENCY, false);
+ ENCODING_PREFERENCE.PREFER_AUTO, COMPRESSION_PREFERENCE.PREFER_COMPRESSION_AUTO, false);
this.codecType = VIDEO_CODEC_TYPE.VIDEO_CODEC_NONE;
}
}
@@ -301,9 +302,9 @@
bitrate(b),
minBitrate(DEFAULT_MIN_BITRATE),
orientationMode(m),
- degradationPreference(MAINTAIN_QUALITY),
+ degradationPreference(MAINTAIN_AUTO),
mirrorMode(mirror),
- advanceOptions(PREFER_AUTO, PREFER_LOW_LATENCY, false) {}
+ advanceOptions(PREFER_AUTO, PREFER_COMPRESSION_AUTO, false) {}
VideoEncoderConfiguration(int width, int height, int f, int b, ORIENTATION_MODE m, VIDEO_MIRROR_MODE_TYPE mirror = VIDEO_MIRROR_MODE_DISABLED)
: codecType(VIDEO_CODEC_NONE),
dimensions(width, height),
@@ -311,19 +312,19 @@
bitrate(b),
minBitrate(DEFAULT_MIN_BITRATE),
orientationMode(m),
- degradationPreference(MAINTAIN_QUALITY),
+ degradationPreference(MAINTAIN_AUTO),
mirrorMode(mirror),
- advanceOptions(PREFER_AUTO, PREFER_LOW_LATENCY, false) {}
+ advanceOptions(PREFER_AUTO, PREFER_COMPRESSION_AUTO, false) {}
VideoEncoderConfiguration(const VideoEncoderConfiguration& config)
- : codecType(config.codecType),
- dimensions(config.dimensions),
- frameRate(config.frameRate),
- bitrate(config.bitrate),
- minBitrate(config.minBitrate),
- orientationMode(config.orientationMode),
- degradationPreference(config.degradationPreference),
- mirrorMode(config.mirrorMode),
- advanceOptions(config.advanceOptions) {}
+ : codecType(config.codecType),
+ dimensions(config.dimensions),
+ frameRate(config.frameRate),
+ bitrate(config.bitrate),
+ minBitrate(config.minBitrate),
+ orientationMode(config.orientationMode),
+ degradationPreference(config.degradationPreference),
+ mirrorMode(config.mirrorMode),
+ advanceOptions(config.advanceOptions) {}
VideoEncoderConfiguration()
: codecType(VIDEO_CODEC_NONE),
dimensions(FRAME_WIDTH_960, FRAME_HEIGHT_540),
@@ -331,9 +332,9 @@
bitrate(STANDARD_BITRATE),
minBitrate(DEFAULT_MIN_BITRATE),
orientationMode(ORIENTATION_MODE_ADAPTIVE),
- degradationPreference(MAINTAIN_QUALITY),
+ degradationPreference(MAINTAIN_AUTO),
mirrorMode(VIDEO_MIRROR_MODE_DISABLED),
- advanceOptions(PREFER_AUTO, PREFER_LOW_LATENCY, false) {}
+ advanceOptions(PREFER_AUTO, PREFER_COMPRESSION_AUTO, false) {}
VideoEncoderConfiguration& operator=(const VideoEncoderConfiguration& rhs) {
if (this == &rhs) return *this;
codecType = rhs.codecType;
diff --git a/dita/RTC-NG/API/enum_compressionpreference.dita b/dita/RTC-NG/API/enum_compressionpreference.dita
index 8dc8df4cdaf..c9289ccea9d 100644
--- a/dita/RTC-NG/API/enum_compressionpreference.dita
+++ b/dita/RTC-NG/API/enum_compressionpreference.dita
@@ -15,17 +15,17 @@
枚举值
-
+
+
+ -1:（默认）自动模式。SDK 会根据你设置的视频场景，自动选择 或 ；并在网络状态发生变化时，自动在 和 之间切换，以获得最佳的用户体验。
+
+
0: 低延时偏好。SDK 会对视频帧进行压缩处理，以降低延时。该偏好适用于流畅性优先且允许画质降低的场景。
-
-
- 1:（默认）高质量偏好。SDK 会对视频帧进行压缩处理，同时保持视频质量。该偏好适用于画质优先的场景。
-
-
+ 1:（默认）高质量偏好。SDK 会对视频帧进行压缩处理，同时保持视频质量。该偏好适用于画质优先的场景。