Agora C++ API Reference for All Platforms
Loading...
Searching...
No Matches
video_config_i.h
1//
2// Agora Media SDK
3//
4// Created by Rao Qi in 2019-05.
5// Copyright (c) 2019 Agora IO. All rights reserved.
6//
7#pragma once
8
9#include <cstdint>
10#include <sstream>
11#include <string>
12
13#include "AgoraBase.h"
14#include "AgoraOptional.h"
15
16#if defined(WEBRTC_WIN)
17#define NEW_LINE "\r\n"
18#else
19#define NEW_LINE "\n"
20#endif
21
22namespace agora {
23namespace rtc {
24
26 public:
27 // do NOT add any default value here
30 void SetAll(const VideoConfigurationEx& change) {
31#define SET_FROM(X) SetFrom(&X, change.X)
32
33 SET_FROM(codec_type);
34 SET_FROM(h265_screen_enable);
35 SET_FROM(frame_width);
36 SET_FROM(frame_height);
37 SET_FROM(frame_rate);
38 SET_FROM(start_bitrate);
39 SET_FROM(target_bitrate);
40 SET_FROM(min_bitrate);
41 SET_FROM(max_bitrate);
42 SET_FROM(actual_max_bitrate);
43 SET_FROM(orientation_mode);
46 SET_FROM(number_of_bframe_temporal_layers);
47 SET_FROM(sps_data);
48 SET_FROM(pps_data);
49 SET_FROM(h264_profile);
50 SET_FROM(adaptive_op_mode);
52 SET_FROM(flexible_mode);
53 SET_FROM(interlayer_pred);
54 SET_FROM(num_of_encoder_cores);
55 SET_FROM(degradation_preference);
56 SET_FROM(fps_down_step);
57 SET_FROM(fps_up_step);
58 SET_FROM(vqc_version);
59 SET_FROM(vqc_force_use_version);
61 //TODO(kefan) these vqc parameters should placed in MediaEngineParameterCollection
62 SET_FROM(vqc_quick_adaptNetwork);
63 SET_FROM(vqc_min_framerate);
67 SET_FROM(vqc_qp_adjust);
68 SET_FROM(vqc_ios_h265_adjust);
69 SET_FROM(vqc_res_min_width);
70 SET_FROM(vqc_res_min_height);
71 SET_FROM(min_qp);
72 SET_FROM(max_qp);
73 SET_FROM(frame_max_size);
74 SET_FROM(fec_fix_rate);
76 SET_FROM(fec_method);
77 SET_FROM(enable_pvc);
79 SET_FROM(enable_pvc_verify);
80 SET_FROM(enable_sr_verify);
81 SET_FROM(sr_verify_type);
82 SET_FROM(color_space_enable);
83 SET_FROM(videoFullrange);
84 SET_FROM(matrixCoefficients);
85 SET_FROM(enable_sr);
86 SET_FROM(sr_type);
87 SET_FROM(save_encode_bitrate);
90
91 SET_FROM(complexity);
92 SET_FROM(denoising_on);
93 SET_FROM(automatic_resize_on);
94 SET_FROM(frame_dropping_on);
95 SET_FROM(has_intra_request);
96 SET_FROM(key_frame_interval);
101 SET_FROM(bitrate_adjust_ratio);
102 SET_FROM(minbitrate_ratio);
104 SET_FROM(h264_qp_thresholds_low);
105 SET_FROM(h264_qp_thresholds_high);
106 SET_FROM(dec_mosreport);
107 SET_FROM(vqa_model_target_fps);
108 SET_FROM(reset_bitrate_ratio);
109 SET_FROM(reset_framerate_ratio);
110 SET_FROM(enable_hw_decoder);
112 SET_FROM(hw_decoder_provider);
113 SET_FROM(decoder_thread_num);
114 SET_FROM(max_hwdec_cosessions);
116 SET_FROM(enable_hw_encoder);
117 SET_FROM(hw_encoder_provider);
120 SET_FROM(hwenc_blacklist);
121 SET_FROM(hwdec_blacklist);
122 SET_FROM(av_enc_codec_type);
123 SET_FROM(av_enc_common_quality);
126 SET_FROM(enable_video_qoe_assess);
127 SET_FROM(h264_hw_min_res_level);
128 SET_FROM(av_enc_video_max_slices);
131 SET_FROM(video_encoder_rc_scene);
134 SET_FROM(vp8_enc_switch);
135 SET_FROM(av1_dec_enable);
136 SET_FROM(h265_dec_enable);
137 SET_FROM(av1_camera_enable);
138 SET_FROM(av1_screen_enable);
139 SET_FROM(av1_feedback_enable);
140 SET_FROM(enc_scc_enable);
144 SET_FROM(minscore_for_swh265enc);
145 SET_FROM(max_hwenc_cosessions);
146 SET_FROM(min_enc_level);
147 SET_FROM(wz265_dec_enable);
148 SET_FROM(vcm_info_event_enable);
149
150 SET_FROM(enable_video_vpr);
151 SET_FROM(video_vpr_init_size);
152 SET_FROM(video_vpr_max_size);
155 SET_FROM(video_vpr_method);
156 SET_FROM(video_vpr_adaptive_thres);
157 SET_FROM(retrans_detect_enable);
158 SET_FROM(use_sent_ts_enable);
160 SET_FROM(video_rotation);
161 SET_FROM(scale_type);
178 SET_FROM(av_dec_output_byte_frame);
180 SET_FROM(av_enc_google_enable);
181 SET_FROM(av_dec_google_enable);
186 SET_FROM(av_hw_dec_skip_by_name);
189 SET_FROM(av_enc_hw_exceptions);
190
191 SET_FROM(av_enc_video_use_a264);
194 SET_FROM(av_enc_video_enable_roi);
195 SET_FROM(roi_max_qp);
196 SET_FROM(roi_qp_offset);
197 SET_FROM(av_enc_vmaf_calc);
198 SET_FROM(av_enc_profiling);
199 SET_FROM(av_enc_param_config);
203
204 SET_FROM(enable_iptos);
205
209 SET_FROM(bFrames);
210 SET_FROM(enable_bframe);
211 SET_FROM(enable_bframe_h265);
212 SET_FROM(bitrate_ceiling_ratio);
213 SET_FROM(video_skip_enable);
214 SET_FROM(av_enc_new_complexity);
217 SET_FROM(key_force_device_score);
219 SET_FROM(use_single_slice_parser);
220 SET_FROM(enable_parser_reject);
221
222 SET_FROM(av_enc_send_sei_alpha);
225 SET_FROM(av_enc_encode_alpha);
228 SET_FROM(fake_enc_error_code);
230
232 SET_FROM(fps_est_window_size_ms);
244 SET_FROM(feedback_mode);
248#undef SET_FROM
249 }
250
251 bool operator==(const VideoConfigurationEx& o) const {
252#define BEGIN_COMPARE() bool b = true
253#define ADD_COMPARE(X) b = (b && (X == o.X))
254#define END_COMPARE()
255
256 BEGIN_COMPARE();
257 ADD_COMPARE(codec_type);
258 ADD_COMPARE(h265_screen_enable);
259 ADD_COMPARE(frame_width);
260 ADD_COMPARE(frame_height);
261 ADD_COMPARE(frame_rate);
262 ADD_COMPARE(start_bitrate);
263 ADD_COMPARE(target_bitrate);
264 ADD_COMPARE(min_bitrate);
265 ADD_COMPARE(orientation_mode);
266 ADD_COMPARE(number_of_temporal_layers);
268 ADD_COMPARE(number_of_bframe_temporal_layers);
269 ADD_COMPARE(sps_data);
270 ADD_COMPARE(pps_data);
271 ADD_COMPARE(h264_profile);
272 ADD_COMPARE(adaptive_op_mode);
273 ADD_COMPARE(number_of_spatial_layers);
274 ADD_COMPARE(flexible_mode);
275 ADD_COMPARE(interlayer_pred);
276 ADD_COMPARE(num_of_encoder_cores);
277 ADD_COMPARE(degradation_preference);
278 ADD_COMPARE(fps_down_step);
279 ADD_COMPARE(fps_up_step);
280 ADD_COMPARE(vqc_version);
281 ADD_COMPARE(vqc_force_use_version);
282 ADD_COMPARE(overuse_detector_version);
283 //TODO(kefan) these vqc parameters should placed in MediaEngineParameterCollection
284 ADD_COMPARE(vqc_quick_adaptNetwork);
285 ADD_COMPARE(vqc_min_framerate);
286 ADD_COMPARE(vqc_settings_by_resolution);
289 ADD_COMPARE(vqc_qp_adjust);
290 ADD_COMPARE(vqc_ios_h265_adjust);
291 ADD_COMPARE(vqc_res_min_width);
292 ADD_COMPARE(vqc_res_min_height);
293 ADD_COMPARE(min_qp);
294 ADD_COMPARE(max_qp);
295 ADD_COMPARE(frame_max_size);
296 ADD_COMPARE(fec_fix_rate);
297 ADD_COMPARE(quick_response_intra_request);
298 ADD_COMPARE(fec_method);
299 ADD_COMPARE(enable_pvc);
300 ADD_COMPARE(pvc_max_support_resolution);
301 ADD_COMPARE(enable_pvc_verify);
302 ADD_COMPARE(enable_sr_verify);
303 ADD_COMPARE(sr_verify_type);
304 ADD_COMPARE(enable_sr);
305 ADD_COMPARE(sr_type);
306 ADD_COMPARE(save_encode_bitrate);
308 ADD_COMPARE(save_encode_bitrate_params);
309
310 ADD_COMPARE(complexity);
311 ADD_COMPARE(denoising_on);
312 ADD_COMPARE(automatic_resize_on);
313 ADD_COMPARE(frame_dropping_on);
314 ADD_COMPARE(has_intra_request);
315 ADD_COMPARE(key_frame_interval);
316 ADD_COMPARE(entropy_coding_mode_flag);
317 ADD_COMPARE(loop_filter_disable_idc);
318 ADD_COMPARE(background_detection_on);
320 ADD_COMPARE(bitrate_adjust_ratio);
321 ADD_COMPARE(minbitrate_ratio);
323 ADD_COMPARE(h264_qp_thresholds_low);
324 ADD_COMPARE(h264_qp_thresholds_high);
325 ADD_COMPARE(dec_mosreport);
326 ADD_COMPARE(vqa_model_target_fps);
327 ADD_COMPARE(reset_bitrate_ratio);
328 ADD_COMPARE(reset_framerate_ratio);
329 ADD_COMPARE(enable_hw_decoder);
330 ADD_COMPARE(enable_background_hw_decode);
331 ADD_COMPARE(hw_decoder_provider);
332 ADD_COMPARE(decoder_thread_num);
333 ADD_COMPARE(max_hwdec_cosessions);
334 ADD_COMPARE(low_stream_enable_hw_encoder);
335 ADD_COMPARE(enable_hw_encoder);
336 ADD_COMPARE(hw_encoder_provider);
337 ADD_COMPARE(av_enc_codec_type);
338 ADD_COMPARE(av_enc_common_quality);
340 ADD_COMPARE(video_render_d3d9_texture);
343 ADD_COMPARE(video_render_vsync_switch);
344 ADD_COMPARE(video_force_texture_to_i420);
349 ADD_COMPARE(enable_video_qoe_assess);
350 ADD_COMPARE(h264_hw_min_res_level);
351 ADD_COMPARE(av_enc_video_max_slices);
352 ADD_COMPARE(video_encoder_rc_limit_value);
354 ADD_COMPARE(video_encoder_rc_scene);
356 ADD_COMPARE(av_sw_enc_dump_frame_info);
357 ADD_COMPARE(vp8_enc_switch);
358 ADD_COMPARE(h265_dec_enable);
359 ADD_COMPARE(av1_dec_enable);
360 ADD_COMPARE(av1_camera_enable);
361 ADD_COMPARE(av1_feedback_enable);
362 ADD_COMPARE(av1_screen_enable);
363 ADD_COMPARE(enc_scc_enable);
366 ADD_COMPARE(color_space_enable);
367 ADD_COMPARE(videoFullrange);
368 ADD_COMPARE(matrixCoefficients);
369 ADD_COMPARE(vcm_info_event_enable);
370
371 ADD_COMPARE(min_enc_level);
372 ADD_COMPARE(minscore_for_swh265enc);
373 ADD_COMPARE(max_hwenc_cosessions);
374 ADD_COMPARE(default_enable_hwenc_win32);
376 ADD_COMPARE(hwenc_blacklist);
377 ADD_COMPARE(hwdec_blacklist);
379 ADD_COMPARE(wz265_dec_enable);
380
381 ADD_COMPARE(enable_video_vpr);
382 ADD_COMPARE(video_vpr_init_size);
383 ADD_COMPARE(video_vpr_max_size);
384 ADD_COMPARE(video_vpr_frozen_ms_thres);
385 ADD_COMPARE(video_vpr_frozen_rate_thres);
386 ADD_COMPARE(video_vpr_method);
387 ADD_COMPARE(video_vpr_adaptive_thres);
388 ADD_COMPARE(av_enc_intra_key_interval);
389 ADD_COMPARE(key_force_device_score);
391 ADD_COMPARE(retrans_detect_enable);
392 ADD_COMPARE(use_sent_ts_enable);
394 ADD_COMPARE(video_rotation);
395 ADD_COMPARE(scale_type);
396 ADD_COMPARE(av_enc_video_use_a264);
397 ADD_COMPARE(av_enc_video_qp_parser_skip);
398 ADD_COMPARE(video_clarity_analysis_flag);
399 ADD_COMPARE(av_enc_video_enable_roi);
400 ADD_COMPARE(roi_max_qp);
401 ADD_COMPARE(roi_qp_offset);
402 ADD_COMPARE(av_enc_vmaf_calc);
403 ADD_COMPARE(av_enc_profiling);
404 ADD_COMPARE(av_enc_param_config);
406 ADD_COMPARE(av_enc_advanced_param_config);
408 ADD_COMPARE(av_enc_video_width_alignment);
412 ADD_COMPARE(av_enc_video_force_alignment);
415 ADD_COMPARE(av_dec_texture_copy_enable);
416 ADD_COMPARE(av_dec_output_byte_frame);
417 ADD_COMPARE(av_dec_output_10bit_frame);
418 ADD_COMPARE(av_enc_google_enable);
419 ADD_COMPARE(av_dec_google_enable);
420 ADD_COMPARE(av_dec_google_dav1d_enable);
422
423 ADD_COMPARE(enable_iptos);
424
427 ADD_COMPARE(min_encode_keyframe_interval);
428 ADD_COMPARE(bFrames);
429 ADD_COMPARE(enable_bframe);
430 ADD_COMPARE(enable_bframe_h265);
431 ADD_COMPARE(video_skip_enable);
432 ADD_COMPARE(av_enc_new_complexity);
433 ADD_COMPARE(av_enc_default_complexity);
434 ADD_COMPARE(use_single_slice_parser);
435 ADD_COMPARE(av_enc_video_hwenc_config);
436 ADD_COMPARE(av_dec_video_hwdec_config);
437 ADD_COMPARE(av_hw_dec_skip_by_name);
438 ADD_COMPARE(av_enc_hw_hevc_exceptions);
439 ADD_COMPARE(av_dec_hw_hevc_exceptions);
440 ADD_COMPARE(av_enc_hw_exceptions);
441 ADD_COMPARE(enable_parser_reject);
443
444 ADD_COMPARE(av_enc_send_sei_alpha);
445 ADD_COMPARE(av_enc_alpha_data_codec_type);
446 ADD_COMPARE(av_enc_alpha_data_scale_mode);
447 ADD_COMPARE(av_enc_encode_alpha);
450 ADD_COMPARE(fake_enc_error_code);
452 ADD_COMPARE(fps_est_window_size_ms);
453 ADD_COMPARE(default_enable_hw_encoder);
455 ADD_COMPARE(frame_glitching_detect_level);
457 ADD_COMPARE(enable_follow_major_stream);
459 ADD_COMPARE(enable_performance_gating);
462 ADD_COMPARE(max_all_intra_encode_time);
464 ADD_COMPARE(feedback_mode);
465 ADD_COMPARE(response_quick_intra_request);
467 ADD_COMPARE(minimum_amf_version_require);
468 END_COMPARE();
469
470#undef BEGIN_COMPARE
471#undef ADD_COMPARE
472#undef END_COMPARE
473 return b;
474 }
475
476 bool operator!=(const VideoConfigurationEx& o) const { return !(*this == o); }
477
478 std::string ToString() const {
479#define ADD_STRING(X) ost << ToStringIfSet(#X, X)
480
481 std::ostringstream ost;
482 ADD_STRING(codec_type);
483 ADD_STRING(h265_screen_enable);
484 ADD_STRING(frame_width);
485 ADD_STRING(frame_height);
486 ADD_STRING(frame_rate);
487 ADD_STRING(start_bitrate);
488 ADD_STRING(target_bitrate);
489 ADD_STRING(min_bitrate);
490 ADD_STRING(max_bitrate);
491 ADD_STRING(actual_max_bitrate);
492 ADD_STRING(orientation_mode);
493 ADD_STRING(number_of_temporal_layers);
495 ADD_STRING(number_of_bframe_temporal_layers);
496 ADD_STRING(sps_data);
497 ADD_STRING(pps_data);
498 ADD_STRING(h264_profile);
499 ADD_STRING(adaptive_op_mode);
500 ADD_STRING(number_of_spatial_layers);
501 ADD_STRING(flexible_mode);
502 ADD_STRING(interlayer_pred);
503 ADD_STRING(num_of_encoder_cores);
504 ADD_STRING(degradation_preference);
505 ADD_STRING(fps_down_step);
506 ADD_STRING(fps_up_step);
507 ADD_STRING(vqc_version);
508 ADD_STRING(vqc_force_use_version);
509 ADD_STRING(overuse_detector_version);
510 //TODO(kefan) these vqc parameters should placed in MediaEngineParameterCollection
511 ADD_STRING(vqc_quick_adaptNetwork);
512 ADD_STRING(vqc_min_framerate);
513 ADD_STRING(vqc_settings_by_resolution);
516 ADD_STRING(vqc_qp_adjust);
517 ADD_STRING(vqc_ios_h265_adjust);
518 ADD_STRING(vqc_res_min_width);
519 ADD_STRING(vqc_res_min_height);
520 ADD_STRING(min_qp);
521 ADD_STRING(max_qp);
522 ADD_STRING(frame_max_size);
523 ADD_STRING(fec_fix_rate);
525 ADD_STRING(fec_method);
526 ADD_STRING(enable_pvc);
527 ADD_STRING(pvc_max_support_resolution);
528 ADD_STRING(enable_pvc_verify);
529 ADD_STRING(enable_sr_verify);
530 ADD_STRING(sr_verify_type);
531 ADD_STRING(enable_sr);
532 ADD_STRING(sr_type);
533
534 ADD_STRING(complexity);
535 ADD_STRING(denoising_on);
536 ADD_STRING(automatic_resize_on);
537 ADD_STRING(frame_dropping_on);
538 ADD_STRING(has_intra_request);
539 ADD_STRING(key_frame_interval);
540 ADD_STRING(entropy_coding_mode_flag);
541 ADD_STRING(loop_filter_disable_idc);
542 ADD_STRING(background_detection_on);
544 ADD_STRING(bitrate_adjust_ratio);
545 ADD_STRING(minbitrate_ratio);
547 ADD_STRING(h264_qp_thresholds_low);
548 ADD_STRING(h264_qp_thresholds_high);
549 ADD_STRING(dec_mosreport);
550 ADD_STRING(vqa_model_target_fps);
551 ADD_STRING(reset_bitrate_ratio);
552 ADD_STRING(reset_framerate_ratio);
553 ADD_STRING(enable_hw_decoder);
554 ADD_STRING(enable_background_hw_decode);
555 ADD_STRING(hw_decoder_provider);
556 ADD_STRING(decoder_thread_num);
557 ADD_STRING(max_hwdec_cosessions);
559 ADD_STRING(enable_hw_encoder);
560 ADD_STRING(hw_encoder_provider);
561 ADD_STRING(av_enc_codec_type);
562 ADD_STRING(av_enc_common_quality);
565 ADD_STRING(enable_video_qoe_assess);
566 ADD_STRING(h264_hw_min_res_level);
567 ADD_STRING(av_enc_video_max_slices);
570 ADD_STRING(video_encoder_rc_scene);
572 ADD_STRING(av_sw_enc_dump_frame_info);
573 ADD_STRING(vp8_enc_switch);
574 ADD_STRING(h265_dec_enable);
575 ADD_STRING(av1_dec_enable);
576 ADD_STRING(av1_camera_enable);
577 ADD_STRING(av1_feedback_enable);
578 ADD_STRING(av1_screen_enable);
579 ADD_STRING(enc_scc_enable);
582 ADD_STRING(save_encode_bitrate);
584 ADD_STRING(save_encode_bitrate_params);
585 ADD_STRING(vcm_info_event_enable);
586
587 ADD_STRING(min_enc_level);
588 ADD_STRING(minscore_for_swh265enc);
589 ADD_STRING(max_hwenc_cosessions);
590 ADD_STRING(default_enable_hwenc_win32);
592 ADD_STRING(hwenc_blacklist);
593 ADD_STRING(hwdec_blacklist);
595
596 ADD_STRING(wz265_dec_enable);
597
598 ADD_STRING(color_space_enable);
599 ADD_STRING(videoFullrange);
600 ADD_STRING(matrixCoefficients);
601
602 ADD_STRING(enable_video_vpr);
603 ADD_STRING(video_vpr_init_size);
604 ADD_STRING(video_vpr_max_size);
605 ADD_STRING(video_vpr_frozen_ms_thres);
606 ADD_STRING(video_vpr_frozen_rate_thres);
607 ADD_STRING(video_vpr_method);
608 ADD_STRING(video_vpr_adaptive_thres);
609 ADD_STRING(retrans_detect_enable);
610 ADD_STRING(use_sent_ts_enable);
612 ADD_STRING(video_rotation);
613 ADD_STRING(scale_type);
614 ADD_STRING(video_render_d3d9_texture);
617 ADD_STRING(video_render_vsync_switch);
618 ADD_STRING(video_force_texture_to_i420);
629 ADD_STRING(av_dec_texture_copy_enable);
630 ADD_STRING(av_dec_output_byte_frame);
631 ADD_STRING(av_dec_output_10bit_frame);
632 ADD_STRING(av_enc_google_enable);
633 ADD_STRING(av_dec_google_enable);
634 ADD_STRING(av_dec_google_dav1d_enable);
636 ADD_STRING(av_dec_video_hwdec_config);
637 ADD_STRING(av_enc_video_hwenc_config);
638 ADD_STRING(av_hw_dec_skip_by_name);
639 ADD_STRING(av_enc_hw_hevc_exceptions);
640 ADD_STRING(av_dec_hw_hevc_exceptions);
641 ADD_STRING(av_enc_hw_exceptions);
642
643 ADD_STRING(av_enc_video_use_a264);
644 ADD_STRING(av_enc_video_qp_parser_skip);
645 ADD_STRING(video_clarity_analysis_flag);
646 ADD_STRING(av_enc_video_enable_roi);
647 ADD_STRING(roi_max_qp);
648 ADD_STRING(roi_qp_offset);
649 ADD_STRING(av_enc_vmaf_calc);
650 ADD_STRING(av_enc_profiling);
651 ADD_STRING(av_enc_param_config);
655
656 ADD_STRING(enable_iptos);
657
661 ADD_STRING(bFrames);
662 ADD_STRING(enable_bframe);
663 ADD_STRING(enable_bframe_h265);
664 ADD_STRING(video_skip_enable);
665 ADD_STRING(av_enc_new_complexity);
666 ADD_STRING(av_enc_default_complexity);
667 ADD_STRING(av_enc_intra_key_interval);
668 ADD_STRING(key_force_device_score);
670 ADD_STRING(use_single_slice_parser);
671 ADD_STRING(enable_parser_reject);
672
674 ADD_STRING(av_enc_send_sei_alpha);
677 ADD_STRING(av_enc_encode_alpha);
680 ADD_STRING(fake_enc_error_code);
682 ADD_STRING(fps_est_window_size_ms);
683 ADD_STRING(default_enable_hw_encoder);
687 ADD_STRING(enable_follow_major_stream);
689 ADD_STRING(enable_performance_gating);
692 ADD_STRING(max_all_intra_encode_time);
694 ADD_STRING(feedback_mode);
697 ADD_STRING(minimum_amf_version_require);
698#undef ADD_STRING
699 std::string ret = ost.str();
700 auto index = ret.rfind(",");
701 if (index != ret.npos) {
702 ret = ret.substr(0, index);
703 ret += NEW_LINE;
704 }
705
706 return "{" NEW_LINE + ret + "}";
707 }
708
721 Optional<uint8_t> (number_of_bframe_temporal_layers);
736 //TODO(kefan) these vqc parameters should placed in MediaEngineParameterCollection
746 Optional<int> (min_qp);
747 Optional<int> (max_qp);
748 Optional<int> (frame_max_size);
752 //h265 dec enable
754 //av1 dec enable
761 // enc scc enable
763 // vp8 enc switch
765
768
776
778
791 // followings are hw setting
792
793 // h264 quality scaler settings
797
800
801 //vqa
804
805 // Specifies whether or not to enable hw decode.
807 // Specifies whether or not to enable background hw decode.
809 // Specifies hw encode provider.
813
814 // Specifies whether or not to enable hw encode.
816 // Specifies hw encode provider.
818 // Specifies the encoding scheme.
820 // Specifies the quality level for encoding.
821 // 0 Minimum quality, smaller output size.
822 // 100 Maximum quality, larger output size.
824 // Specifies the rate control mode.
825 // eAVEncCommonRateControlMode_CBR,
826 // eAVEncCommonRateControlMode_PeakConstrainedVBR,
827 // eAVEncCommonRateControlMode_UnconstrainedVBR,
828 // eAVEncCommonRateControlMode_Quality,
829 // eAVEncCommonRateControlMode_LowDelayVBR,
830 // eAVEncCommonRateControlMode_GlobalVBR,
831 // eAVEncCommonRateControlMode_GlobalLowDelayVBR
838 // Specifies the min resolution level to use h264 hardware encoder
840 // mac slice num for a264, valid only when > 0
842 // rc limit value, it can limit the fluctuation range of the bitrate
847 // software encoder open dump frame info feature, used to investigate questions
856
866 // for intra request
872
880
882 // whether default use a264;
887 // whether open vmaf calc;
891 // whether open video coding profiling
893 // sw encoder param
895 // video resolution auto adjust param
897 // advanced encoder param
899 // screen sharing content type
921 // whether use single slice parser.
927
939
944
957
958 // minor stream config
960 // Specifies whether or not to enable low stream hw encode.
975
976 private:
977 template <class T>
978 std::string ToStringIfSet(const char* key, const Optional<T>& val) const {
979 std::string str;
980 if (val) {
981 str = key;
982 str = "\t\"" + str + "\"";
983 str += ": ";
984 str += std::to_string(*val);
985 str += ",";
986 str += NEW_LINE;
987 }
988 return str;
989 }
990
991 std::string ToStringIfSet(const char* key, const Optional<std::string>& val) const {
992 std::string str;
993 if (val) {
994 str = key;
995 str = "\t\"" + str + "\"";
996 str += ": \"";
997 str += val.value();
998 str += "\",";
999 str += NEW_LINE;
1000 }
1001 return str;
1002 }
1003
1004 std::string ToStringIfSet(const char* key, const Optional<bool>& val) const {
1005 std::string str;
1006 if (val) {
1007 str = key;
1008 str = "\t\"" + str + "\"";
1009 str += ": ";
1010 str += *val ? "true" : "false";
1011 str += ",";
1012 str += NEW_LINE;
1013 }
1014 return str;
1015 }
1016
1017 template <typename T>
1018 static void SetFrom(Optional<T>* s, const Optional<T>& o) {
1019 if (o) {
1020 *s = o;
1021 }
1022 }
1023};
1024
1025} // namespace rtc
1026} // namespace agora
Definition AgoraOptional.h:413
const T & value() const
Definition AgoraOptional.h:542
Definition AgoraExtensions.h:5
Definition AgoraAtomicOps.h:21
Optional< int > target_bitrate
Definition video_config_i.h:715
Optional< int > sr_type
Definition video_config_i.h:855
Optional< bool > use_single_slice_parser
Definition video_config_i.h:922
Optional< std::string > hw_decoder_provider
Definition video_config_i.h:810
Optional< int > frame_rate
Definition video_config_i.h:713
Optional< int > vqc_force_use_version
Definition video_config_i.h:734
Optional< std::string > pps_data
Definition video_config_i.h:723
Optional< int > h264_qp_thresholds_high
Definition video_config_i.h:796
Optional< bool > enable_smooth_enc_codec_change
Definition video_config_i.h:952
Optional< std::string > simulcast_stream_bitrate_string
Definition video_config_i.h:963
Optional< int > degradation_preference
Definition video_config_i.h:730
Optional< int > frame_height
Definition video_config_i.h:712
Optional< bool > h265_dec_enable
Definition video_config_i.h:753
Optional< bool > response_quick_intra_request
Definition video_config_i.h:972
Optional< int > fec_method
Definition video_config_i.h:750
Optional< int32_t > video_vpr_adaptive_thres
Definition video_config_i.h:863
Optional< std::string > vqc_settings_by_resolution
Definition video_config_i.h:739
Optional< bool > enable_bframe_h265
Definition video_config_i.h:947
Optional< bool > video_android_capturer_copy_enable
Definition video_config_i.h:879
Optional< bool > enable_hw_encoder_quickly_start
Definition video_config_i.h:949
Optional< bool > save_encode_bitrate_minor_stream
Definition video_config_i.h:929
Optional< bool > has_intra_request
Definition video_config_i.h:783
Optional< bool > enable_minor_stream_codec_follow_major_stream
Definition video_config_i.h:967
Optional< bool > enable_follow_major_stream
Definition video_config_i.h:964
Optional< bool > video_force_texture_to_i420
Definition video_config_i.h:877
Optional< int > min_bitrate
Definition video_config_i.h:716
Optional< int > h264_profile
Definition video_config_i.h:724
Optional< int > bFrames
Definition video_config_i.h:946
Optional< int32_t > intel_cpu_threshold_mhz
Definition video_config_i.h:835
Optional< int > vqc_min_holdtime_auto_resize_zoomout
Definition video_config_i.h:741
Optional< int > fake_enc_error_code
Definition video_config_i.h:951
Optional< std::string > av_enc_video_hwenc_config
Definition video_config_i.h:905
Optional< int > max_bitrate
Definition video_config_i.h:717
Optional< int > video_switch_soft_decoder_threshold
Definition video_config_i.h:932
Optional< bool > av1_dec_enable
Definition video_config_i.h:755
Optional< bool > video_windows_capture_to_texture
Definition video_config_i.h:878
Optional< int > vqc_res_min_height
Definition video_config_i.h:745
Optional< bool > av_enc_send_sei_alpha
Definition video_config_i.h:940
Optional< bool > vdm_not_override_lua_smallvideo_not_use_hwenc_policy
Definition video_config_i.h:836
Optional< int32_t > key_force_device_score
Definition video_config_i.h:868
Optional< bool > enable_performance_gating
Definition video_config_i.h:966
Optional< int > fec_fix_rate
Definition video_config_i.h:751
Optional< bool > video_skip_enable
Definition video_config_i.h:934
Optional< std::string > minbitrate_ratio
Definition video_config_i.h:790
void SetAll(const VideoConfigurationEx &change)
Definition video_config_i.h:30
Optional< int > av_sw_enc_dump_frame_info
Definition video_config_i.h:848
Optional< int > fps_est_window_size_ms
Definition video_config_i.h:953
Optional< int > num_of_encoder_cores
Definition video_config_i.h:729
Optional< uint8_t > number_of_spatial_layers
Definition video_config_i.h:726
Optional< int32_t > max_all_intra_encode_time
Definition video_config_i.h:969
Optional< bool > enable_video_qoe_assess
Definition video_config_i.h:837
Optional< int > max_hwenc_cosessions
Definition video_config_i.h:770
Optional< bool > video_render_vsync_switch
Definition video_config_i.h:876
Optional< int32_t > video_vpr_frozen_rate_thres
Definition video_config_i.h:861
Optional< bool > enable_change_encoder_profile
Definition video_config_i.h:775
Optional< int32_t > video_vpr_init_size
Definition video_config_i.h:858
Optional< bool > enable_iptos
Definition video_config_i.h:926
Optional< uint32_t > av_enc_codec_type
Definition video_config_i.h:819
Optional< bool > enable_video_vpr
Definition video_config_i.h:857
Optional< int > scale_type
Definition video_config_i.h:871
Optional< int32_t > video_vpr_frozen_ms_thres
Definition video_config_i.h:860
Optional< int > sr_verify_type
Definition video_config_i.h:853
Optional< std::string > hwdec_blacklist
Definition video_config_i.h:774
Optional< int > orientation_mode
Definition video_config_i.h:719
Optional< bool > background_detection_on
Definition video_config_i.h:787
Optional< std::string > av_enc_param_config
Definition video_config_i.h:894
Optional< bool > enable_hw_encoder
Definition video_config_i.h:815
Optional< int > major_stream_encoder_thread_num
Definition video_config_i.h:759
Optional< bool > use_sent_ts_enable
Definition video_config_i.h:865
Optional< int32_t > av_enc_hw_hevc_exceptions
Definition video_config_i.h:908
Optional< bool > enable_nvdia_first
Definition video_config_i.h:833
Optional(number_of_bframe_temporal_layers)
Optional< bool > enable_pvc_verify
Definition video_config_i.h:851
Optional< bool > av_enc_video_use_a264
Definition video_config_i.h:883
Optional< int > quick_response_intra_request
Definition video_config_i.h:749
Optional< int > roi_max_qp
Definition video_config_i.h:885
Optional< bool > save_encode_bitrate
Definition video_config_i.h:928
Optional< int > videoFullrange
Definition video_config_i.h:924
Optional< bool > enc_scc_enable
Definition video_config_i.h:762
Optional< bool > automatic_resize_on
Definition video_config_i.h:781
Optional< bool > initial_hw_encoder_quickly_start
Definition video_config_i.h:950
Optional< uint32_t > av_enc_common_quality
Definition video_config_i.h:823
Optional< int > vqc_ios_h265_adjust
Definition video_config_i.h:743
Optional< bool > frame_dropping_on
Definition video_config_i.h:782
Optional< int32_t > video_vpr_max_size
Definition video_config_i.h:859
Optional< int > video_clarity_analysis_flag
Definition video_config_i.h:889
Optional< bool > color_space_enable
Definition video_config_i.h:923
Optional< int > entropy_coding_mode_flag
Definition video_config_i.h:785
Optional< int32_t > nvdia_cpu_threshold_mhz
Definition video_config_i.h:834
Optional< bool > enable_pvc
Definition video_config_i.h:849
Optional< bool > av_enc_video_force_alignment
Definition video_config_i.h:911
Optional< bool > enable_instant_streaming_mode
Definition video_config_i.h:968
Optional< std::string > save_encode_bitrate_params
Definition video_config_i.h:930
Optional< int > posted_frames_waiting_for_encode
Definition video_config_i.h:788
Optional< int > vqc_version
Definition video_config_i.h:733
Optional< int > vqc_qp_adjust
Definition video_config_i.h:742
Optional< int > video_encoder_rc_scene
Definition video_config_i.h:845
Optional< bool > vp8_enc_switch
Definition video_config_i.h:764
Optional< int > vqc_res_min_width
Definition video_config_i.h:744
Optional< int > interlayer_pred
Definition video_config_i.h:728
Optional< bool > quality_scale_only_on_average_qp
Definition video_config_i.h:794
Optional< int32_t > av_enc_video_height_alignment
Definition video_config_i.h:902
Optional< uint8_t > number_of_temporal_layers
Definition video_config_i.h:720
Optional< int > start_bitrate
Definition video_config_i.h:714
Optional< std::string > hwenc_blacklist
Definition video_config_i.h:773
Optional< bool > av1_feedback_enable
Definition video_config_i.h:757
Optional< bool > default_enable_hw_encoder
Definition video_config_i.h:954
Optional< int32_t > av_dec_hw_hevc_exceptions
Definition video_config_i.h:909
Optional< bool > flexible_mode
Definition video_config_i.h:727
Optional< int32_t > av_enc_video_width_alignment
Definition video_config_i.h:901
Optional< int > vqa_model_target_fps
Definition video_config_i.h:803
Optional< int > use_keyframe_type_from_parser
Definition video_config_i.h:955
Optional< bool > av_enc_profiling
Definition video_config_i.h:892
bool operator==(const VideoConfigurationEx &o) const
Definition video_config_i.h:251
Optional< std::string > video_resolution_auto_adjust_param
Definition video_config_i.h:896
Optional< int > minscore_for_swh265enc
Definition video_config_i.h:769
Optional< bool > av_dec_google_dav1d_enable
Definition video_config_i.h:919
Optional< int32_t > av_enc_video_hdr_width_alignment
Definition video_config_i.h:903
Optional< int32_t > av_enc_video_hdr_height_alignment
Definition video_config_i.h:904
Optional< int > video_encoder_rc_limit_value
Definition video_config_i.h:843
Optional< int > frame_width
Definition video_config_i.h:711
Optional< bool > wz265_dec_enable
Definition video_config_i.h:777
Optional< int > key_frame_interval
Definition video_config_i.h:784
Optional< bool > av_dec_texture_copy_enable
Definition video_config_i.h:914
Optional< int > pvc_max_support_resolution
Definition video_config_i.h:850
Optional< bool > av_enc_encode_alpha
Definition video_config_i.h:943
Optional< int > max_hwdec_cosessions
Definition video_config_i.h:812
Optional< int > dec_mosreport
Definition video_config_i.h:802
Optional< bool > av_enc_new_complexity
Definition video_config_i.h:935
Optional< bool > av_enc_video_enable_dequeue_timewait
Definition video_config_i.h:912
Optional< bool > enable_sr
Definition video_config_i.h:854
Optional< bool > av1_screen_enable
Definition video_config_i.h:758
bool operator!=(const VideoConfigurationEx &o) const
Definition video_config_i.h:476
Optional< bool > vcm_info_event_enable
Definition video_config_i.h:766
Optional< int32_t > video_vpr_method
Definition video_config_i.h:862
Optional< int > roi_qp_offset
Definition video_config_i.h:886
Optional< bool > av_enc_video_adjustment_reset
Definition video_config_i.h:913
Optional< bool > enable_bframe
Definition video_config_i.h:945
Optional< int > vqc_min_holdtime_auto_resize_zoomin
Definition video_config_i.h:740
Optional< int > av_enc_video_max_slices
Definition video_config_i.h:841
Optional< bool > av1_camera_enable
Definition video_config_i.h:756
Optional< std::string > minimum_amf_version_require
Definition video_config_i.h:974
Optional< int > key_frame_interval_intra_request
Definition video_config_i.h:931
Optional< int > encode_failed_fallback_thresh
Definition video_config_i.h:973
Optional< bool > adaptive_op_mode
Definition video_config_i.h:725
Optional< int > fps_up_step
Definition video_config_i.h:732
Optional< uint32_t > hw_encoder_provider
Definition video_config_i.h:817
Optional< std::string > sps_data
Definition video_config_i.h:722
Optional< bool > enable_parser_reject
Definition video_config_i.h:937
Optional< bool > av_enc_google_enable
Definition video_config_i.h:917
Optional< int > minor_stream_encoder_thread_num
Definition video_config_i.h:760
Optional< int > minor_stream_video_encoder_rc_limit_value
Definition video_config_i.h:844
Optional< bool > video_enable_high_definition_strategy
Definition video_config_i.h:881
Optional< int > video_encoder_impair_net_ref_opt
Definition video_config_i.h:846
Optional< bool > enable_sr_verify
Definition video_config_i.h:852
Optional< float > scc_autoframerate_bitrate_ratio
Definition video_config_i.h:970
Optional< int > decoder_thread_num
Definition video_config_i.h:811
Optional< bool > av_enc_video_enable_roi
Definition video_config_i.h:884
Optional< int > actual_max_bitrate
Definition video_config_i.h:718
Optional< int32_t > video_render_buffer_queue_size
Definition video_config_i.h:875
Optional< std::string > bitrate_adjust_ratio
Definition video_config_i.h:789
Optional< int32_t > av_enc_bitrate_adjustment_type
Definition video_config_i.h:869
Optional< int > fps_down_step
Definition video_config_i.h:731
Optional< int > direct_cdn_streaming_h264_profile
Definition video_config_i.h:938
Optional< int > reset_bitrate_ratio
Definition video_config_i.h:798
Optional< float > major_minor_stream_resolution_ratio
Definition video_config_i.h:965
Optional< int32_t > feedback_mode
Definition video_config_i.h:971
Optional< int > overuse_detector_version
Definition video_config_i.h:735
Optional< bool > av_dec_output_10bit_frame
Definition video_config_i.h:916
Optional< int32_t > av_enc_screen_sharing_subclass
Definition video_config_i.h:900
Optional< uint8_t > simulcast_stream_number_of_temporal_layers
Definition video_config_i.h:962
Optional< int > h265_screen_enable
Definition video_config_i.h:710
Optional< int > h264_hw_min_res_level
Definition video_config_i.h:839
Optional< int > min_encode_keyframe_interval
Definition video_config_i.h:933
Optional< int > min_enc_level
Definition video_config_i.h:767
Optional< std::string > bitrate_ceiling_ratio
Definition video_config_i.h:948
Optional< int > reset_framerate_ratio
Definition video_config_i.h:799
Optional< bool > default_enable_hwenc_win32
Definition video_config_i.h:771
Optional< bool > vqc_quick_adaptNetwork
Definition video_config_i.h:737
Optional< int > vqc_min_framerate
Definition video_config_i.h:738
Optional< bool > av_dec_google_enable
Definition video_config_i.h:918
Optional< int > av_enc_alpha_data_scale_mode
Definition video_config_i.h:942
Optional< bool > enable_background_hw_decode
Definition video_config_i.h:808
Optional< bool > enable_minor_stream_intra_request
Definition video_config_i.h:959
Optional< int32_t > av_enc_hw_exceptions
Definition video_config_i.h:910
Optional< std::string > av_dec_video_hwdec_config
Definition video_config_i.h:906
Optional< int > loop_filter_disable_idc
Definition video_config_i.h:786
Optional< bool > allow_qsvhevcenc_for_screenshare
Definition video_config_i.h:772
Optional< std::string > av_enc_advanced_param_config
Definition video_config_i.h:898
Optional< int > matrixCoefficients
Definition video_config_i.h:925
Optional< int > av_enc_alpha_data_codec_type
Definition video_config_i.h:941
Optional< bool > video_render_d3d9_texture
Definition video_config_i.h:873
Optional< int32_t > av_enc_intra_key_interval
Definition video_config_i.h:867
Optional< bool > av_enc_vmaf_calc
Definition video_config_i.h:890
Optional< bool > av_dec_output_byte_frame
Definition video_config_i.h:915
Optional< bool > low_stream_enable_hw_encoder
Definition video_config_i.h:961
std::string ToString() const
Definition video_config_i.h:478
Optional< bool > enable_hw_decoder
Definition video_config_i.h:806
Optional< int > av_dec_output_byte_frame_resolution_product_thres
Definition video_config_i.h:920
Optional< int > codec_type
Definition video_config_i.h:709
Optional< int > frame_glitching_detect_level
Definition video_config_i.h:956
Optional< bool > denoising_on
Definition video_config_i.h:780
Optional< int > h264_qp_thresholds_low
Definition video_config_i.h:795
Optional< int > av_enc_video_qp_parser_skip
Definition video_config_i.h:888
Optional< int > av_enc_default_complexity
Definition video_config_i.h:936
Optional< int > complexity
Definition video_config_i.h:779
Optional< bool > retrans_detect_enable
Definition video_config_i.h:864
Optional< uint32_t > av_enc_common_rate_control_mode
Definition video_config_i.h:832
Optional< std::string > av_hw_dec_skip_by_name
Definition video_config_i.h:907
Optional< int32_t > video_render_d3d9_render_mode
Definition video_config_i.h:874
Optional< int > video_rotation
Definition video_config_i.h:870