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);
187 SET_FROM(av_hw_dec_skip_by_name);
188 SET_FROM(av_hw_enc_skip_by_name);
191 SET_FROM(av_enc_hw_exceptions);
192
193 SET_FROM(av_enc_video_use_a264);
200 SET_FROM(av_enc_video_enable_roi);
201 SET_FROM(roi_max_qp);
202 SET_FROM(roi_qp_offset);
203 SET_FROM(av_enc_vmaf_calc);
204 SET_FROM(av_enc_profiling);
205 SET_FROM(av_enc_param_config);
207 SET_FROM(video_quality_guarantee);
210
211 SET_FROM(enable_iptos);
212
216 SET_FROM(bFrames);
217 SET_FROM(enable_bframe);
218 SET_FROM(enable_bframe_h265);
219 SET_FROM(bitrate_ceiling_ratio);
220 SET_FROM(video_skip_enable);
221 SET_FROM(av_enc_new_complexity);
224 SET_FROM(key_force_device_score);
226 SET_FROM(use_single_slice_parser);
227 SET_FROM(enable_parser_reject);
228
229 SET_FROM(av_enc_send_sei_alpha);
232 SET_FROM(av_enc_encode_alpha);
235 SET_FROM(fake_enc_error_code);
237
239 SET_FROM(fps_est_window_size_ms);
252 SET_FROM(feedback_mode);
259#undef SET_FROM
260 }
261
262 bool operator==(const VideoConfigurationEx& o) const {
263#define BEGIN_COMPARE() bool b = true
264#define ADD_COMPARE(X) b = (b && (X == o.X))
265#define END_COMPARE()
266
267 BEGIN_COMPARE();
268 ADD_COMPARE(codec_type);
269 ADD_COMPARE(h265_screen_enable);
270 ADD_COMPARE(frame_width);
271 ADD_COMPARE(frame_height);
272 ADD_COMPARE(frame_rate);
273 ADD_COMPARE(start_bitrate);
274 ADD_COMPARE(target_bitrate);
275 ADD_COMPARE(min_bitrate);
276 ADD_COMPARE(orientation_mode);
277 ADD_COMPARE(number_of_temporal_layers);
279 ADD_COMPARE(number_of_bframe_temporal_layers);
280 ADD_COMPARE(sps_data);
281 ADD_COMPARE(pps_data);
282 ADD_COMPARE(h264_profile);
283 ADD_COMPARE(adaptive_op_mode);
284 ADD_COMPARE(number_of_spatial_layers);
285 ADD_COMPARE(flexible_mode);
286 ADD_COMPARE(interlayer_pred);
287 ADD_COMPARE(num_of_encoder_cores);
288 ADD_COMPARE(degradation_preference);
289 ADD_COMPARE(fps_down_step);
290 ADD_COMPARE(fps_up_step);
291 ADD_COMPARE(vqc_version);
292 ADD_COMPARE(vqc_force_use_version);
293 ADD_COMPARE(overuse_detector_version);
294 //TODO(kefan) these vqc parameters should placed in MediaEngineParameterCollection
295 ADD_COMPARE(vqc_quick_adaptNetwork);
296 ADD_COMPARE(vqc_min_framerate);
297 ADD_COMPARE(vqc_settings_by_resolution);
300 ADD_COMPARE(vqc_qp_adjust);
301 ADD_COMPARE(vqc_ios_h265_adjust);
302 ADD_COMPARE(vqc_res_min_width);
303 ADD_COMPARE(vqc_res_min_height);
304 ADD_COMPARE(min_qp);
305 ADD_COMPARE(max_qp);
306 ADD_COMPARE(frame_max_size);
307 ADD_COMPARE(fec_fix_rate);
308 ADD_COMPARE(quick_response_intra_request);
309 ADD_COMPARE(fec_method);
310 ADD_COMPARE(enable_pvc);
311 ADD_COMPARE(pvc_max_support_resolution);
312 ADD_COMPARE(enable_pvc_verify);
313 ADD_COMPARE(enable_sr_verify);
314 ADD_COMPARE(sr_verify_type);
315 ADD_COMPARE(enable_sr);
316 ADD_COMPARE(sr_type);
317 ADD_COMPARE(save_encode_bitrate);
319 ADD_COMPARE(save_encode_bitrate_params);
320
321 ADD_COMPARE(complexity);
322 ADD_COMPARE(denoising_on);
323 ADD_COMPARE(automatic_resize_on);
324 ADD_COMPARE(frame_dropping_on);
325 ADD_COMPARE(has_intra_request);
326 ADD_COMPARE(key_frame_interval);
327 ADD_COMPARE(entropy_coding_mode_flag);
328 ADD_COMPARE(loop_filter_disable_idc);
329 ADD_COMPARE(background_detection_on);
331 ADD_COMPARE(bitrate_adjust_ratio);
332 ADD_COMPARE(minbitrate_ratio);
334 ADD_COMPARE(h264_qp_thresholds_low);
335 ADD_COMPARE(h264_qp_thresholds_high);
336 ADD_COMPARE(dec_mosreport);
337 ADD_COMPARE(vqa_model_target_fps);
338 ADD_COMPARE(reset_bitrate_ratio);
339 ADD_COMPARE(reset_framerate_ratio);
340 ADD_COMPARE(enable_hw_decoder);
341 ADD_COMPARE(enable_background_hw_decode);
342 ADD_COMPARE(hw_decoder_provider);
343 ADD_COMPARE(decoder_thread_num);
344 ADD_COMPARE(max_hwdec_cosessions);
345 ADD_COMPARE(low_stream_enable_hw_encoder);
346 ADD_COMPARE(enable_hw_encoder);
347 ADD_COMPARE(hw_encoder_provider);
348 ADD_COMPARE(av_enc_codec_type);
349 ADD_COMPARE(av_enc_common_quality);
351 ADD_COMPARE(video_render_d3d9_texture);
354 ADD_COMPARE(video_render_vsync_switch);
355 ADD_COMPARE(video_force_texture_to_i420);
360 ADD_COMPARE(enable_video_qoe_assess);
361 ADD_COMPARE(h264_hw_min_res_level);
362 ADD_COMPARE(av_enc_video_max_slices);
363 ADD_COMPARE(video_encoder_rc_limit_value);
365 ADD_COMPARE(video_encoder_rc_scene);
367 ADD_COMPARE(av_sw_enc_dump_frame_info);
368 ADD_COMPARE(vp8_enc_switch);
369 ADD_COMPARE(h265_dec_enable);
370 ADD_COMPARE(av1_dec_enable);
371 ADD_COMPARE(av1_camera_enable);
372 ADD_COMPARE(av1_feedback_enable);
373 ADD_COMPARE(av1_screen_enable);
374 ADD_COMPARE(enc_scc_enable);
377 ADD_COMPARE(color_space_enable);
378 ADD_COMPARE(videoFullrange);
379 ADD_COMPARE(matrixCoefficients);
380 ADD_COMPARE(vcm_info_event_enable);
381
382 ADD_COMPARE(min_enc_level);
383 ADD_COMPARE(minscore_for_swh265enc);
384 ADD_COMPARE(max_hwenc_cosessions);
385 ADD_COMPARE(default_enable_hwenc_win32);
387 ADD_COMPARE(hwenc_blacklist);
388 ADD_COMPARE(hwdec_blacklist);
390 ADD_COMPARE(wz265_dec_enable);
391
392 ADD_COMPARE(enable_video_vpr);
393 ADD_COMPARE(video_vpr_init_size);
394 ADD_COMPARE(video_vpr_max_size);
395 ADD_COMPARE(video_vpr_frozen_ms_thres);
396 ADD_COMPARE(video_vpr_frozen_rate_thres);
397 ADD_COMPARE(video_vpr_method);
398 ADD_COMPARE(video_vpr_adaptive_thres);
399 ADD_COMPARE(av_enc_intra_key_interval);
400 ADD_COMPARE(key_force_device_score);
402 ADD_COMPARE(retrans_detect_enable);
403 ADD_COMPARE(use_sent_ts_enable);
405 ADD_COMPARE(video_rotation);
406 ADD_COMPARE(scale_type);
407 ADD_COMPARE(av_enc_video_use_a264);
408 ADD_COMPARE(av_enc_video_qp_parser_skip);
409 ADD_COMPARE(video_clarity_analysis_flag);
414 ADD_COMPARE(av_enc_video_enable_roi);
415 ADD_COMPARE(roi_max_qp);
416 ADD_COMPARE(roi_qp_offset);
417 ADD_COMPARE(av_enc_vmaf_calc);
418 ADD_COMPARE(av_enc_profiling);
419 ADD_COMPARE(av_enc_param_config);
421 ADD_COMPARE(video_quality_guarantee);
422 ADD_COMPARE(av_enc_advanced_param_config);
424 ADD_COMPARE(av_enc_video_width_alignment);
428 ADD_COMPARE(av_enc_video_force_alignment);
431 ADD_COMPARE(av_dec_texture_copy_enable);
432 ADD_COMPARE(av_dec_output_byte_frame);
433 ADD_COMPARE(av_dec_output_10bit_frame);
434 ADD_COMPARE(av_enc_google_enable);
435 ADD_COMPARE(av_dec_google_enable);
436 ADD_COMPARE(av_dec_google_dav1d_enable);
439
440 ADD_COMPARE(enable_iptos);
441
444 ADD_COMPARE(min_encode_keyframe_interval);
445 ADD_COMPARE(bFrames);
446 ADD_COMPARE(enable_bframe);
447 ADD_COMPARE(enable_bframe_h265);
448 ADD_COMPARE(video_skip_enable);
449 ADD_COMPARE(av_enc_new_complexity);
450 ADD_COMPARE(av_enc_default_complexity);
451 ADD_COMPARE(use_single_slice_parser);
452 ADD_COMPARE(av_enc_video_hwenc_config);
453 ADD_COMPARE(av_dec_video_hwdec_config);
454 ADD_COMPARE(av_hw_dec_skip_by_name);
455 ADD_COMPARE(av_hw_enc_skip_by_name);
456 ADD_COMPARE(av_enc_hw_hevc_exceptions);
457 ADD_COMPARE(av_dec_hw_hevc_exceptions);
458 ADD_COMPARE(av_enc_hw_exceptions);
459 ADD_COMPARE(enable_parser_reject);
461
462 ADD_COMPARE(av_enc_send_sei_alpha);
463 ADD_COMPARE(av_enc_alpha_data_codec_type);
464 ADD_COMPARE(av_enc_alpha_data_scale_mode);
465 ADD_COMPARE(av_enc_encode_alpha);
468 ADD_COMPARE(fake_enc_error_code);
470 ADD_COMPARE(fps_est_window_size_ms);
471 ADD_COMPARE(default_enable_hw_encoder);
473 ADD_COMPARE(frame_glitching_detect_level);
475 ADD_COMPARE(enable_follow_major_stream);
477 ADD_COMPARE(enable_performance_gating);
481 ADD_COMPARE(max_all_intra_encode_time);
483 ADD_COMPARE(feedback_mode);
484 ADD_COMPARE(response_quick_intra_request);
486 ADD_COMPARE(minimum_amf_version_require);
487 ADD_COMPARE(vtenc_default_pixel_format);
490 END_COMPARE();
491
492#undef BEGIN_COMPARE
493#undef ADD_COMPARE
494#undef END_COMPARE
495 return b;
496 }
497
498 bool operator!=(const VideoConfigurationEx& o) const { return !(*this == o); }
499
500 std::string ToString() const {
501#define ADD_STRING(X) ost << ToStringIfSet(#X, X)
502
503 std::ostringstream ost;
504 ADD_STRING(codec_type);
505 ADD_STRING(h265_screen_enable);
506 ADD_STRING(frame_width);
507 ADD_STRING(frame_height);
508 ADD_STRING(frame_rate);
509 ADD_STRING(start_bitrate);
510 ADD_STRING(target_bitrate);
511 ADD_STRING(min_bitrate);
512 ADD_STRING(max_bitrate);
513 ADD_STRING(actual_max_bitrate);
514 ADD_STRING(orientation_mode);
515 ADD_STRING(number_of_temporal_layers);
517 ADD_STRING(number_of_bframe_temporal_layers);
518 ADD_STRING(sps_data);
519 ADD_STRING(pps_data);
520 ADD_STRING(h264_profile);
521 ADD_STRING(adaptive_op_mode);
522 ADD_STRING(number_of_spatial_layers);
523 ADD_STRING(flexible_mode);
524 ADD_STRING(interlayer_pred);
525 ADD_STRING(num_of_encoder_cores);
526 ADD_STRING(degradation_preference);
527 ADD_STRING(fps_down_step);
528 ADD_STRING(fps_up_step);
529 ADD_STRING(vqc_version);
530 ADD_STRING(vqc_force_use_version);
531 ADD_STRING(overuse_detector_version);
532 //TODO(kefan) these vqc parameters should placed in MediaEngineParameterCollection
533 ADD_STRING(vqc_quick_adaptNetwork);
534 ADD_STRING(vqc_min_framerate);
535 ADD_STRING(vqc_settings_by_resolution);
538 ADD_STRING(vqc_qp_adjust);
539 ADD_STRING(vqc_ios_h265_adjust);
540 ADD_STRING(vqc_res_min_width);
541 ADD_STRING(vqc_res_min_height);
542 ADD_STRING(min_qp);
543 ADD_STRING(max_qp);
544 ADD_STRING(frame_max_size);
545 ADD_STRING(fec_fix_rate);
547 ADD_STRING(fec_method);
548 ADD_STRING(enable_pvc);
549 ADD_STRING(pvc_max_support_resolution);
550 ADD_STRING(enable_pvc_verify);
551 ADD_STRING(enable_sr_verify);
552 ADD_STRING(sr_verify_type);
553 ADD_STRING(enable_sr);
554 ADD_STRING(sr_type);
555
556 ADD_STRING(complexity);
557 ADD_STRING(denoising_on);
558 ADD_STRING(automatic_resize_on);
559 ADD_STRING(frame_dropping_on);
560 ADD_STRING(has_intra_request);
561 ADD_STRING(key_frame_interval);
562 ADD_STRING(entropy_coding_mode_flag);
563 ADD_STRING(loop_filter_disable_idc);
564 ADD_STRING(background_detection_on);
566 ADD_STRING(bitrate_adjust_ratio);
567 ADD_STRING(minbitrate_ratio);
569 ADD_STRING(h264_qp_thresholds_low);
570 ADD_STRING(h264_qp_thresholds_high);
571 ADD_STRING(dec_mosreport);
572 ADD_STRING(vqa_model_target_fps);
573 ADD_STRING(reset_bitrate_ratio);
574 ADD_STRING(reset_framerate_ratio);
575 ADD_STRING(enable_hw_decoder);
576 ADD_STRING(enable_background_hw_decode);
577 ADD_STRING(hw_decoder_provider);
578 ADD_STRING(decoder_thread_num);
579 ADD_STRING(max_hwdec_cosessions);
581 ADD_STRING(enable_hw_encoder);
582 ADD_STRING(hw_encoder_provider);
583 ADD_STRING(av_enc_codec_type);
584 ADD_STRING(av_enc_common_quality);
587 ADD_STRING(enable_video_qoe_assess);
588 ADD_STRING(h264_hw_min_res_level);
589 ADD_STRING(av_enc_video_max_slices);
592 ADD_STRING(video_encoder_rc_scene);
594 ADD_STRING(av_sw_enc_dump_frame_info);
595 ADD_STRING(vp8_enc_switch);
596 ADD_STRING(h265_dec_enable);
597 ADD_STRING(av1_dec_enable);
598 ADD_STRING(av1_camera_enable);
599 ADD_STRING(av1_feedback_enable);
600 ADD_STRING(av1_screen_enable);
601 ADD_STRING(enc_scc_enable);
604 ADD_STRING(save_encode_bitrate);
606 ADD_STRING(save_encode_bitrate_params);
607 ADD_STRING(vcm_info_event_enable);
608
609 ADD_STRING(min_enc_level);
610 ADD_STRING(minscore_for_swh265enc);
611 ADD_STRING(max_hwenc_cosessions);
612 ADD_STRING(default_enable_hwenc_win32);
614 ADD_STRING(hwenc_blacklist);
615 ADD_STRING(hwdec_blacklist);
617
618 ADD_STRING(wz265_dec_enable);
619
620 ADD_STRING(color_space_enable);
621 ADD_STRING(videoFullrange);
622 ADD_STRING(matrixCoefficients);
623
624 ADD_STRING(enable_video_vpr);
625 ADD_STRING(video_vpr_init_size);
626 ADD_STRING(video_vpr_max_size);
627 ADD_STRING(video_vpr_frozen_ms_thres);
628 ADD_STRING(video_vpr_frozen_rate_thres);
629 ADD_STRING(video_vpr_method);
630 ADD_STRING(video_vpr_adaptive_thres);
631 ADD_STRING(retrans_detect_enable);
632 ADD_STRING(use_sent_ts_enable);
634 ADD_STRING(video_rotation);
635 ADD_STRING(scale_type);
636 ADD_STRING(video_render_d3d9_texture);
639 ADD_STRING(video_render_vsync_switch);
640 ADD_STRING(video_force_texture_to_i420);
651 ADD_STRING(av_dec_texture_copy_enable);
652 ADD_STRING(av_dec_output_byte_frame);
653 ADD_STRING(av_dec_output_10bit_frame);
654 ADD_STRING(av_enc_google_enable);
655 ADD_STRING(av_dec_google_enable);
656 ADD_STRING(av_dec_google_dav1d_enable);
659 ADD_STRING(av_dec_video_hwdec_config);
660 ADD_STRING(av_enc_video_hwenc_config);
661 ADD_STRING(av_hw_dec_skip_by_name);
662 ADD_STRING(av_hw_enc_skip_by_name);
663 ADD_STRING(av_enc_hw_hevc_exceptions);
664 ADD_STRING(av_dec_hw_hevc_exceptions);
665 ADD_STRING(av_enc_hw_exceptions);
666
667 ADD_STRING(av_enc_video_use_a264);
668 ADD_STRING(av_enc_video_qp_parser_skip);
669 ADD_STRING(video_clarity_analysis_flag);
674 ADD_STRING(av_enc_video_enable_roi);
675 ADD_STRING(roi_max_qp);
676 ADD_STRING(roi_qp_offset);
677 ADD_STRING(av_enc_vmaf_calc);
678 ADD_STRING(av_enc_profiling);
679 ADD_STRING(av_enc_param_config);
681 ADD_STRING(video_quality_guarantee);
684
685 ADD_STRING(enable_iptos);
686
690 ADD_STRING(bFrames);
691 ADD_STRING(enable_bframe);
692 ADD_STRING(enable_bframe_h265);
693 ADD_STRING(video_skip_enable);
694 ADD_STRING(av_enc_new_complexity);
695 ADD_STRING(av_enc_default_complexity);
696 ADD_STRING(av_enc_intra_key_interval);
697 ADD_STRING(key_force_device_score);
699 ADD_STRING(use_single_slice_parser);
700 ADD_STRING(enable_parser_reject);
701
703 ADD_STRING(av_enc_send_sei_alpha);
706 ADD_STRING(av_enc_encode_alpha);
709 ADD_STRING(fake_enc_error_code);
711 ADD_STRING(fps_est_window_size_ms);
712 ADD_STRING(default_enable_hw_encoder);
716 ADD_STRING(enable_follow_major_stream);
718 ADD_STRING(enable_performance_gating);
722 ADD_STRING(max_all_intra_encode_time);
724 ADD_STRING(feedback_mode);
727 ADD_STRING(minimum_amf_version_require);
728 ADD_STRING(vtenc_default_pixel_format);
731#undef ADD_STRING
732 std::string ret = ost.str();
733 auto index = ret.rfind(",");
734 if (index != ret.npos) {
735 ret = ret.substr(0, index);
736 ret += NEW_LINE;
737 }
738
739 return "{" NEW_LINE + ret + "}";
740 }
741
754 Optional<uint8_t> (number_of_bframe_temporal_layers);
769 //TODO(kefan) these vqc parameters should placed in MediaEngineParameterCollection
779 Optional<int> (min_qp);
780 Optional<int> (max_qp);
781 Optional<int> (frame_max_size);
785 //h265 dec enable
787 //av1 dec enable
794 // enc scc enable
796 // vp8 enc switch
798
801
809
811
824 // followings are hw setting
825
826 // h264 quality scaler settings
830
833
834 //vqa
837
838 // Specifies whether or not to enable hw decode.
840 // Specifies whether or not to enable background hw decode.
842 // Specifies hw encode provider.
846
847 // Specifies whether or not to enable hw encode.
849 // Specifies hw encode provider.
851 // Specifies the encoding scheme.
853 // Specifies the quality level for encoding.
854 // 0 Minimum quality, smaller output size.
855 // 100 Maximum quality, larger output size.
857 // Specifies the rate control mode.
858 // eAVEncCommonRateControlMode_CBR,
859 // eAVEncCommonRateControlMode_PeakConstrainedVBR,
860 // eAVEncCommonRateControlMode_UnconstrainedVBR,
861 // eAVEncCommonRateControlMode_Quality,
862 // eAVEncCommonRateControlMode_LowDelayVBR,
863 // eAVEncCommonRateControlMode_GlobalVBR,
864 // eAVEncCommonRateControlMode_GlobalLowDelayVBR
871 // Specifies the min resolution level to use h264 hardware encoder
873 // mac slice num for a264, valid only when > 0
875 // rc limit value, it can limit the fluctuation range of the bitrate
880 // software encoder open dump frame info feature, used to investigate questions
889
899 // for intra request
905
913
915 // whether default use a264;
920 // whether open vmaf calc;
928 // whether open video coding profiling
930 // sw encoder param
932 // video resolution auto adjust param
935 // advanced encoder param
937 // screen sharing content type
961 // whether use single slice parser.
967
979
984
997
998 // minor stream config
1000 // Specifies whether or not to enable low stream hw encode.
1019
1020 private:
1021 template <class T>
1022 std::string ToStringIfSet(const char* key, const Optional<T>& val) const {
1023 std::string str;
1024 if (val) {
1025 str = key;
1026 str = "\t\"" + str + "\"";
1027 str += ": ";
1028 str += std::to_string(*val);
1029 str += ",";
1030 str += NEW_LINE;
1031 }
1032 return str;
1033 }
1034
1035 std::string ToStringIfSet(const char* key, const Optional<std::string>& val) const {
1036 std::string str;
1037 if (val) {
1038 str = key;
1039 str = "\t\"" + str + "\"";
1040 str += ": \"";
1041 str += val.value();
1042 str += "\",";
1043 str += NEW_LINE;
1044 }
1045 return str;
1046 }
1047
1048 std::string ToStringIfSet(const char* key, const Optional<bool>& val) const {
1049 std::string str;
1050 if (val) {
1051 str = key;
1052 str = "\t\"" + str + "\"";
1053 str += ": ";
1054 str += *val ? "true" : "false";
1055 str += ",";
1056 str += NEW_LINE;
1057 }
1058 return str;
1059 }
1060
1061 template <typename T>
1062 static void SetFrom(Optional<T>* s, const Optional<T>& o) {
1063 if (o) {
1064 *s = o;
1065 }
1066 }
1067};
1068
1069} // namespace rtc
1070} // 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:748
Optional< int > sr_type
Definition video_config_i.h:888
Optional< bool > use_single_slice_parser
Definition video_config_i.h:962
Optional< std::string > hw_decoder_provider
Definition video_config_i.h:843
Optional< int > frame_rate
Definition video_config_i.h:746
Optional< int > vqc_force_use_version
Definition video_config_i.h:767
Optional< std::string > pps_data
Definition video_config_i.h:756
Optional< int > h264_qp_thresholds_high
Definition video_config_i.h:829
Optional< bool > enable_smooth_enc_codec_change
Definition video_config_i.h:992
Optional< std::string > simulcast_stream_bitrate_string
Definition video_config_i.h:1003
Optional< int > degradation_preference
Definition video_config_i.h:763
Optional< bool > enable_hw_decoder_reset_cropping
Definition video_config_i.h:960
Optional< int > frame_height
Definition video_config_i.h:745
Optional< bool > h265_dec_enable
Definition video_config_i.h:786
Optional< bool > response_quick_intra_request
Definition video_config_i.h:1013
Optional< int > fec_method
Definition video_config_i.h:783
Optional< int32_t > video_vpr_adaptive_thres
Definition video_config_i.h:896
Optional< std::string > vqc_settings_by_resolution
Definition video_config_i.h:772
Optional< bool > enable_bframe_h265
Definition video_config_i.h:987
Optional< bool > video_android_capturer_copy_enable
Definition video_config_i.h:912
Optional< bool > enable_hw_encoder_quickly_start
Definition video_config_i.h:989
Optional< bool > save_encode_bitrate_minor_stream
Definition video_config_i.h:969
Optional< bool > has_intra_request
Definition video_config_i.h:816
Optional< bool > enable_minor_stream_codec_follow_major_stream
Definition video_config_i.h:1007
Optional< bool > enable_follow_major_stream
Definition video_config_i.h:1004
Optional< std::string > av_hw_enc_skip_by_name
Definition video_config_i.h:946
Optional< bool > video_force_texture_to_i420
Definition video_config_i.h:910
Optional< std::string > video_quality_guarantee
Definition video_config_i.h:934
Optional< int > min_bitrate
Definition video_config_i.h:749
Optional< int > h264_profile
Definition video_config_i.h:757
Optional< int > bFrames
Definition video_config_i.h:986
Optional< int32_t > intel_cpu_threshold_mhz
Definition video_config_i.h:868
Optional< int > vqc_min_holdtime_auto_resize_zoomout
Definition video_config_i.h:774
Optional< int > fake_enc_error_code
Definition video_config_i.h:991
Optional< std::string > av_enc_video_hwenc_config
Definition video_config_i.h:943
Optional< int > max_bitrate
Definition video_config_i.h:750
Optional< int > video_switch_soft_decoder_threshold
Definition video_config_i.h:972
Optional< bool > av1_dec_enable
Definition video_config_i.h:788
Optional< bool > video_windows_capture_to_texture
Definition video_config_i.h:911
Optional< int > vqc_res_min_height
Definition video_config_i.h:778
Optional< bool > av_enc_send_sei_alpha
Definition video_config_i.h:980
Optional< bool > vdm_not_override_lua_smallvideo_not_use_hwenc_policy
Definition video_config_i.h:869
Optional< int32_t > key_force_device_score
Definition video_config_i.h:901
Optional< bool > enable_performance_gating
Definition video_config_i.h:1006
Optional< int > fec_fix_rate
Definition video_config_i.h:784
Optional< bool > video_skip_enable
Definition video_config_i.h:974
Optional< std::string > minbitrate_ratio
Definition video_config_i.h:823
void SetAll(const VideoConfigurationEx &change)
Definition video_config_i.h:30
Optional< int > av_sw_enc_dump_frame_info
Definition video_config_i.h:881
Optional< int > fps_est_window_size_ms
Definition video_config_i.h:993
Optional< int > num_of_encoder_cores
Definition video_config_i.h:762
Optional< uint8_t > number_of_spatial_layers
Definition video_config_i.h:759
Optional< int32_t > max_all_intra_encode_time
Definition video_config_i.h:1010
Optional< bool > enable_video_qoe_assess
Definition video_config_i.h:870
Optional< int > max_hwenc_cosessions
Definition video_config_i.h:803
Optional< bool > video_render_vsync_switch
Definition video_config_i.h:909
Optional< int32_t > video_vpr_frozen_rate_thres
Definition video_config_i.h:894
Optional< bool > enable_change_encoder_profile
Definition video_config_i.h:808
Optional< int32_t > video_vpr_init_size
Definition video_config_i.h:891
Optional< int > video_clarity_analysis_max_map_size
Definition video_config_i.h:923
Optional< bool > enable_iptos
Definition video_config_i.h:966
Optional< uint32_t > av_enc_codec_type
Definition video_config_i.h:852
Optional< bool > enable_video_vpr
Definition video_config_i.h:890
Optional< int > vtenc_default_pixel_format
Definition video_config_i.h:1016
Optional< int > scale_type
Definition video_config_i.h:904
Optional< int32_t > video_vpr_frozen_ms_thres
Definition video_config_i.h:893
Optional< int > sr_verify_type
Definition video_config_i.h:886
Optional< std::string > hwdec_blacklist
Definition video_config_i.h:807
Optional< int > orientation_mode
Definition video_config_i.h:752
Optional< bool > background_detection_on
Definition video_config_i.h:820
Optional< std::string > av_enc_param_config
Definition video_config_i.h:931
Optional< bool > enable_hw_encoder
Definition video_config_i.h:848
Optional< int > major_stream_encoder_thread_num
Definition video_config_i.h:792
Optional< bool > use_sent_ts_enable
Definition video_config_i.h:898
Optional< int32_t > av_enc_hw_hevc_exceptions
Definition video_config_i.h:947
Optional< bool > enable_nvdia_first
Definition video_config_i.h:866
Optional(number_of_bframe_temporal_layers)
Optional< bool > enable_pvc_verify
Definition video_config_i.h:884
Optional< bool > av_enc_video_use_a264
Definition video_config_i.h:916
Optional< int > quick_response_intra_request
Definition video_config_i.h:782
Optional< int > roi_max_qp
Definition video_config_i.h:918
Optional< bool > save_encode_bitrate
Definition video_config_i.h:968
Optional< int > videoFullrange
Definition video_config_i.h:964
Optional< bool > enc_scc_enable
Definition video_config_i.h:795
Optional< bool > automatic_resize_on
Definition video_config_i.h:814
Optional< bool > initial_hw_encoder_quickly_start
Definition video_config_i.h:990
Optional< uint32_t > av_enc_common_quality
Definition video_config_i.h:856
Optional< int > vqc_ios_h265_adjust
Definition video_config_i.h:776
Optional< bool > frame_dropping_on
Definition video_config_i.h:815
Optional< bool > encoder_skip_color_space_override_if_present_enable
Definition video_config_i.h:1017
Optional< int32_t > video_vpr_max_size
Definition video_config_i.h:892
Optional< int > video_clarity_analysis_flag
Definition video_config_i.h:922
Optional< bool > color_space_enable
Definition video_config_i.h:963
Optional< int > entropy_coding_mode_flag
Definition video_config_i.h:818
Optional< int32_t > nvdia_cpu_threshold_mhz
Definition video_config_i.h:867
Optional< bool > enable_pvc
Definition video_config_i.h:882
Optional< bool > av_enc_video_force_alignment
Definition video_config_i.h:950
Optional< bool > enable_instant_streaming_mode
Definition video_config_i.h:1009
Optional< std::string > save_encode_bitrate_params
Definition video_config_i.h:970
Optional< int > posted_frames_waiting_for_encode
Definition video_config_i.h:821
Optional< int > vqc_version
Definition video_config_i.h:766
Optional< int > vqc_qp_adjust
Definition video_config_i.h:775
Optional< int > video_encoder_rc_scene
Definition video_config_i.h:878
Optional< bool > vp8_enc_switch
Definition video_config_i.h:797
Optional< int > vqc_res_min_width
Definition video_config_i.h:777
Optional< int > interlayer_pred
Definition video_config_i.h:761
Optional< bool > quality_scale_only_on_average_qp
Definition video_config_i.h:827
Optional< int32_t > av_enc_video_height_alignment
Definition video_config_i.h:940
Optional< uint8_t > number_of_temporal_layers
Definition video_config_i.h:753
Optional< int > start_bitrate
Definition video_config_i.h:747
Optional< std::string > hwenc_blacklist
Definition video_config_i.h:806
Optional< bool > av1_feedback_enable
Definition video_config_i.h:790
Optional< bool > default_enable_hw_encoder
Definition video_config_i.h:994
Optional< int32_t > av_dec_hw_hevc_exceptions
Definition video_config_i.h:948
Optional< bool > flexible_mode
Definition video_config_i.h:760
Optional< int32_t > av_enc_video_width_alignment
Definition video_config_i.h:939
Optional< int > vqa_model_target_fps
Definition video_config_i.h:836
Optional< int > use_keyframe_type_from_parser
Definition video_config_i.h:995
Optional< bool > av_enc_profiling
Definition video_config_i.h:929
bool operator==(const VideoConfigurationEx &o) const
Definition video_config_i.h:262
Optional< std::string > video_resolution_auto_adjust_param
Definition video_config_i.h:933
Optional< int > minscore_for_swh265enc
Definition video_config_i.h:802
Optional< bool > av_dec_google_dav1d_enable
Definition video_config_i.h:958
Optional< int32_t > av_enc_video_hdr_width_alignment
Definition video_config_i.h:941
Optional< int32_t > av_enc_video_hdr_height_alignment
Definition video_config_i.h:942
Optional< int > video_encoder_rc_limit_value
Definition video_config_i.h:876
Optional< int > frame_width
Definition video_config_i.h:744
Optional< bool > wz265_dec_enable
Definition video_config_i.h:810
Optional< int > key_frame_interval
Definition video_config_i.h:817
Optional< bool > av_dec_texture_copy_enable
Definition video_config_i.h:953
Optional< int > pvc_max_support_resolution
Definition video_config_i.h:883
Optional< bool > av_enc_encode_alpha
Definition video_config_i.h:983
Optional< int > max_hwdec_cosessions
Definition video_config_i.h:845
Optional< int > dec_mosreport
Definition video_config_i.h:835
Optional< bool > av_enc_new_complexity
Definition video_config_i.h:975
Optional< bool > av_enc_video_enable_dequeue_timewait
Definition video_config_i.h:951
Optional< bool > enable_sr
Definition video_config_i.h:887
Optional< bool > av1_screen_enable
Definition video_config_i.h:791
bool operator!=(const VideoConfigurationEx &o) const
Definition video_config_i.h:498
Optional< bool > vcm_info_event_enable
Definition video_config_i.h:799
Optional< int32_t > video_vpr_method
Definition video_config_i.h:895
Optional< int > roi_qp_offset
Definition video_config_i.h:919
Optional< bool > av_enc_video_adjustment_reset
Definition video_config_i.h:952
Optional< bool > enable_bframe
Definition video_config_i.h:985
Optional< int > vqc_min_holdtime_auto_resize_zoomin
Definition video_config_i.h:773
Optional< int > av_enc_video_max_slices
Definition video_config_i.h:874
Optional< bool > av1_camera_enable
Definition video_config_i.h:789
Optional< std::string > minimum_amf_version_require
Definition video_config_i.h:1015
Optional< int > key_frame_interval_intra_request
Definition video_config_i.h:971
Optional< int > encode_failed_fallback_thresh
Definition video_config_i.h:1014
Optional< int > video_clarity_analysis_max_list_size
Definition video_config_i.h:924
Optional< bool > adaptive_op_mode
Definition video_config_i.h:758
Optional< int > fps_up_step
Definition video_config_i.h:765
Optional< uint32_t > hw_encoder_provider
Definition video_config_i.h:850
Optional< std::string > sps_data
Definition video_config_i.h:755
Optional< bool > enable_parser_reject
Definition video_config_i.h:977
Optional< bool > av_enc_google_enable
Definition video_config_i.h:956
Optional< int > minor_stream_encoder_thread_num
Definition video_config_i.h:793
Optional< int > minor_stream_video_encoder_rc_limit_value
Definition video_config_i.h:877
Optional< bool > video_enable_high_definition_strategy
Definition video_config_i.h:914
Optional< int > video_encoder_impair_net_ref_opt
Definition video_config_i.h:879
Optional< bool > enable_sr_verify
Definition video_config_i.h:885
Optional< float > scc_autoframerate_bitrate_ratio
Definition video_config_i.h:1011
Optional< int > decoder_thread_num
Definition video_config_i.h:844
Optional< bool > av_enc_video_enable_roi
Definition video_config_i.h:917
Optional< int > actual_max_bitrate
Definition video_config_i.h:751
Optional< int32_t > video_render_buffer_queue_size
Definition video_config_i.h:908
Optional< std::string > bitrate_adjust_ratio
Definition video_config_i.h:822
Optional< int32_t > av_enc_bitrate_adjustment_type
Definition video_config_i.h:902
Optional< int > fps_down_step
Definition video_config_i.h:764
Optional< int > direct_cdn_streaming_h264_profile
Definition video_config_i.h:978
Optional< int > reset_bitrate_ratio
Definition video_config_i.h:831
Optional< float > major_minor_stream_resolution_ratio
Definition video_config_i.h:1005
Optional< int32_t > feedback_mode
Definition video_config_i.h:1012
Optional< int > intra_request_keyframe_received_timeout_ms
Definition video_config_i.h:1018
Optional< int > overuse_detector_version
Definition video_config_i.h:768
Optional< bool > av_dec_output_10bit_frame
Definition video_config_i.h:955
Optional< int32_t > av_enc_screen_sharing_subclass
Definition video_config_i.h:938
Optional< uint8_t > simulcast_stream_number_of_temporal_layers
Definition video_config_i.h:1002
Optional< int > h265_screen_enable
Definition video_config_i.h:743
Optional< int > h264_hw_min_res_level
Definition video_config_i.h:872
Optional< int > min_encode_keyframe_interval
Definition video_config_i.h:973
Optional< int > min_enc_level
Definition video_config_i.h:800
Optional< int > video_clarity_analysis_max_time_range
Definition video_config_i.h:925
Optional< std::string > bitrate_ceiling_ratio
Definition video_config_i.h:988
Optional< int > reset_framerate_ratio
Definition video_config_i.h:832
Optional< bool > default_enable_hwenc_win32
Definition video_config_i.h:804
Optional< bool > vqc_quick_adaptNetwork
Definition video_config_i.h:770
Optional< int > vqc_min_framerate
Definition video_config_i.h:771
Optional< bool > av_dec_google_enable
Definition video_config_i.h:957
Optional< int > av_enc_alpha_data_scale_mode
Definition video_config_i.h:982
Optional< bool > enable_background_hw_decode
Definition video_config_i.h:841
Optional< bool > enable_minor_stream_intra_request
Definition video_config_i.h:999
Optional< int32_t > av_enc_hw_exceptions
Definition video_config_i.h:949
Optional< std::string > av_dec_video_hwdec_config
Definition video_config_i.h:944
Optional< int > loop_filter_disable_idc
Definition video_config_i.h:819
Optional< bool > allow_qsvhevcenc_for_screenshare
Definition video_config_i.h:805
Optional< std::string > av_enc_advanced_param_config
Definition video_config_i.h:936
Optional< int > matrixCoefficients
Definition video_config_i.h:965
Optional< int > av_enc_alpha_data_codec_type
Definition video_config_i.h:981
Optional< bool > video_render_d3d9_texture
Definition video_config_i.h:906
Optional< int32_t > av_enc_intra_key_interval
Definition video_config_i.h:900
Optional< bool > av_enc_vmaf_calc
Definition video_config_i.h:927
Optional< int > video_clarity_analysis_score_threshold
Definition video_config_i.h:926
Optional< bool > av_dec_output_byte_frame
Definition video_config_i.h:954
Optional< bool > low_stream_enable_hw_encoder
Definition video_config_i.h:1001
std::string ToString() const
Definition video_config_i.h:500
Optional< bool > enable_hw_decoder
Definition video_config_i.h:839
Optional< int > av_dec_output_byte_frame_resolution_product_thres
Definition video_config_i.h:959
Optional< int > codec_type
Definition video_config_i.h:742
Optional< int > frame_glitching_detect_level
Definition video_config_i.h:996
Optional< bool > denoising_on
Definition video_config_i.h:813
Optional< bool > enable_simulcast_stream_codec_follow_major_stream
Definition video_config_i.h:1008
Optional< int > h264_qp_thresholds_low
Definition video_config_i.h:828
Optional< int > av_enc_video_qp_parser_skip
Definition video_config_i.h:921
Optional< int > av_enc_default_complexity
Definition video_config_i.h:976
Optional< int > complexity
Definition video_config_i.h:812
Optional< bool > retrans_detect_enable
Definition video_config_i.h:897
Optional< uint32_t > av_enc_common_rate_control_mode
Definition video_config_i.h:865
Optional< std::string > av_hw_dec_skip_by_name
Definition video_config_i.h:945
Optional< int32_t > video_render_d3d9_render_mode
Definition video_config_i.h:907
Optional< int > video_rotation
Definition video_config_i.h:903