/* * Copyright (c) 2022 The WebRTC project authors. All Rights Reserved. * * Use of this source code is governed by a BSD-style license * that can be found in the LICENSE file in the root of the source * tree. An additional intellectual property rights grant can be found * in the file PATENTS. All contributing project authors may * be found in the AUTHORS file in the root of the source tree. */ #include #include #include #include "absl/flags/flag.h" #include "absl/functional/any_invocable.h" #include "api/test/metrics/global_metrics_logger_and_exporter.h" #include "api/units/data_rate.h" #include "api/units/frequency.h" #include "api/video/resolution.h" #include "api/video_codecs/builtin_video_decoder_factory.h" #include "api/video_codecs/builtin_video_encoder_factory.h" #if defined(WEBRTC_ANDROID) #include "modules/video_coding/codecs/test/android_codec_factory_helper.h" #endif #include "rtc_base/logging.h" #include "test/gtest.h" #include "test/test_flags.h" #include "test/testsupport/file_utils.h" #include "test/video_codec_tester.h" ABSL_FLAG(bool, dump_decoder_input, false, "Dump decoder input."); ABSL_FLAG(bool, dump_decoder_output, false, "Dump decoder output."); ABSL_FLAG(bool, dump_encoder_input, false, "Dump encoder input."); ABSL_FLAG(bool, dump_encoder_output, false, "Dump encoder output."); namespace webrtc { namespace test { namespace { using ::testing::Combine; using ::testing::Values; using VideoSourceSettings = VideoCodecTester::VideoSourceSettings; using EncodingSettings = VideoCodecTester::EncodingSettings; using VideoCodecStats = VideoCodecTester::VideoCodecStats; using Filter = VideoCodecStats::Filter; using PacingMode = VideoCodecTester::PacingSettings::PacingMode; struct VideoInfo { std::string name; Resolution resolution; Frequency framerate; }; const VideoInfo kFourPeople_1280x720_30 = { .name = "FourPeople_1280x720_30", .resolution = {.width = 1280, .height = 720}, .framerate = Frequency::Hertz(30)}; static constexpr Frequency k90kHz = Frequency::Hertz(90000); std::unique_ptr CreateEncoderFactory(std::string impl) { if (impl == "builtin") { return CreateBuiltinVideoEncoderFactory(); } #if defined(WEBRTC_ANDROID) InitializeAndroidObjects(); return CreateAndroidEncoderFactory(); #else return nullptr; #endif } std::unique_ptr CreateDecoderFactory(std::string impl) { if (impl == "builtin") { return CreateBuiltinVideoDecoderFactory(); } #if defined(WEBRTC_ANDROID) InitializeAndroidObjects(); return CreateAndroidDecoderFactory(); #else return nullptr; #endif } std::string TestOutputPath() { std::string output_path = OutputPath() + ::testing::UnitTest::GetInstance()->current_test_info()->name(); std::string output_dir = DirName(output_path); bool result = CreateDir(output_dir); RTC_CHECK(result) << "Cannot create " << output_dir; return output_path; } } // namespace std::unique_ptr RunEncodeDecodeTest( std::string codec_type, std::string codec_impl, const VideoInfo& video_info, const std::map& encoding_settings) { VideoSourceSettings source_settings{ .file_path = ResourcePath(video_info.name, "yuv"), .resolution = video_info.resolution, .framerate = video_info.framerate}; const SdpVideoFormat& sdp_video_format = encoding_settings.begin()->second.sdp_video_format; std::unique_ptr encoder_factory = CreateEncoderFactory(codec_impl); if (!encoder_factory ->QueryCodecSupport(sdp_video_format, /*scalability_mode=*/absl::nullopt) .is_supported) { RTC_LOG(LS_WARNING) << "No encoder for video format " << sdp_video_format.ToString(); return nullptr; } std::unique_ptr decoder_factory = CreateDecoderFactory(codec_impl); if (!decoder_factory ->QueryCodecSupport(sdp_video_format, /*reference_scaling=*/false) .is_supported) { decoder_factory = CreateDecoderFactory("builtin"); if (!decoder_factory ->QueryCodecSupport(sdp_video_format, /*reference_scaling=*/false) .is_supported) { RTC_LOG(LS_WARNING) << "No decoder for video format " << sdp_video_format.ToString(); return nullptr; } } std::string output_path = TestOutputPath(); VideoCodecTester::EncoderSettings encoder_settings; encoder_settings.pacing_settings.mode = codec_impl == "builtin" ? PacingMode::kNoPacing : PacingMode::kRealTime; if (absl::GetFlag(FLAGS_dump_encoder_input)) { encoder_settings.encoder_input_base_path = output_path + "_enc_input"; } if (absl::GetFlag(FLAGS_dump_encoder_output)) { encoder_settings.encoder_output_base_path = output_path + "_enc_output"; } VideoCodecTester::DecoderSettings decoder_settings; decoder_settings.pacing_settings.mode = codec_impl == "builtin" ? PacingMode::kNoPacing : PacingMode::kRealTime; if (absl::GetFlag(FLAGS_dump_decoder_input)) { decoder_settings.decoder_input_base_path = output_path + "_dec_input"; } if (absl::GetFlag(FLAGS_dump_decoder_output)) { decoder_settings.decoder_output_base_path = output_path + "_dec_output"; } return VideoCodecTester::RunEncodeDecodeTest( source_settings, encoder_factory.get(), decoder_factory.get(), encoder_settings, decoder_settings, encoding_settings); } std::unique_ptr RunEncodeTest( std::string codec_type, std::string codec_impl, const VideoInfo& video_info, const std::map& encoding_settings) { VideoSourceSettings source_settings{ .file_path = ResourcePath(video_info.name, "yuv"), .resolution = video_info.resolution, .framerate = video_info.framerate}; const SdpVideoFormat& sdp_video_format = encoding_settings.begin()->second.sdp_video_format; std::unique_ptr encoder_factory = CreateEncoderFactory(codec_impl); if (!encoder_factory ->QueryCodecSupport(sdp_video_format, /*scalability_mode=*/absl::nullopt) .is_supported) { RTC_LOG(LS_WARNING) << "No encoder for video format " << sdp_video_format.ToString(); return nullptr; } std::string output_path = TestOutputPath(); VideoCodecTester::EncoderSettings encoder_settings; encoder_settings.pacing_settings.mode = codec_impl == "builtin" ? PacingMode::kNoPacing : PacingMode::kRealTime; if (absl::GetFlag(FLAGS_dump_encoder_input)) { encoder_settings.encoder_input_base_path = output_path + "_enc_input"; } if (absl::GetFlag(FLAGS_dump_encoder_output)) { encoder_settings.encoder_output_base_path = output_path + "_enc_output"; } return VideoCodecTester::RunEncodeTest(source_settings, encoder_factory.get(), encoder_settings, encoding_settings); } class SpatialQualityTest : public ::testing::TestWithParam>> { public: static std::string TestParamsToString( const ::testing::TestParamInfo& info) { auto [codec_type, codec_impl, video_info, coding_settings] = info.param; auto [width, height, framerate_fps, bitrate_kbps, psnr] = coding_settings; return std::string(codec_type + codec_impl + video_info.name + std::to_string(width) + "x" + std::to_string(height) + "p" + std::to_string(static_cast(1000 * framerate_fps)) + "mhz" + std::to_string(bitrate_kbps) + "kbps"); } }; TEST_P(SpatialQualityTest, SpatialQuality) { auto [codec_type, codec_impl, video_info, coding_settings] = GetParam(); auto [width, height, framerate_fps, bitrate_kbps, expected_min_psnr] = coding_settings; int duration_s = 10; int num_frames = duration_s * framerate_fps; std::map frames_settings = VideoCodecTester::CreateEncodingSettings( codec_type, /*scalability_mode=*/"L1T1", width, height, {bitrate_kbps}, framerate_fps, num_frames); std::unique_ptr stats = RunEncodeDecodeTest(codec_type, codec_impl, video_info, frames_settings); VideoCodecStats::Stream stream; if (stats != nullptr) { stream = stats->Aggregate(Filter{}); if (absl::GetFlag(FLAGS_webrtc_quick_perf_test)) { EXPECT_GE(stream.psnr.y.GetAverage(), expected_min_psnr); } } stream.LogMetrics( GetGlobalMetricsLogger(), ::testing::UnitTest::GetInstance()->current_test_info()->name(), /*metadata=*/ {{"video_name", video_info.name}, {"codec_type", codec_type}, {"codec_impl", codec_impl}}); } INSTANTIATE_TEST_SUITE_P( All, SpatialQualityTest, Combine(Values("AV1", "VP9", "VP8", "H264", "H265"), #if defined(WEBRTC_ANDROID) Values("builtin", "mediacodec"), #else Values("builtin"), #endif Values(kFourPeople_1280x720_30), Values(std::make_tuple(320, 180, 30, 32, 28), std::make_tuple(320, 180, 30, 64, 30), std::make_tuple(320, 180, 30, 128, 33), std::make_tuple(320, 180, 30, 256, 36), std::make_tuple(640, 360, 30, 128, 31), std::make_tuple(640, 360, 30, 256, 33), std::make_tuple(640, 360, 30, 384, 35), std::make_tuple(640, 360, 30, 512, 36), std::make_tuple(1280, 720, 30, 256, 32), std::make_tuple(1280, 720, 30, 512, 34), std::make_tuple(1280, 720, 30, 1024, 37), std::make_tuple(1280, 720, 30, 2048, 39))), SpatialQualityTest::TestParamsToString); class BitrateAdaptationTest : public ::testing::TestWithParam< std::tuple>> { public: static std::string TestParamsToString( const ::testing::TestParamInfo& info) { auto [codec_type, codec_impl, video_info, bitrate_kbps] = info.param; return std::string(codec_type + codec_impl + video_info.name + std::to_string(bitrate_kbps.first) + "kbps" + std::to_string(bitrate_kbps.second) + "kbps"); } }; TEST_P(BitrateAdaptationTest, BitrateAdaptation) { auto [codec_type, codec_impl, video_info, bitrate_kbps] = GetParam(); int duration_s = 10; // Duration of fixed rate interval. int num_frames = static_cast(duration_s * video_info.framerate.hertz()); std::map encoding_settings = VideoCodecTester::CreateEncodingSettings( codec_type, /*scalability_mode=*/"L1T1", /*width=*/640, /*height=*/360, {bitrate_kbps.first}, /*framerate_fps=*/30, num_frames); uint32_t initial_timestamp_rtp = encoding_settings.rbegin()->first + k90kHz / Frequency::Hertz(30); std::map encoding_settings2 = VideoCodecTester::CreateEncodingSettings( codec_type, /*scalability_mode=*/"L1T1", /*width=*/640, /*height=*/360, {bitrate_kbps.second}, /*framerate_fps=*/30, num_frames, initial_timestamp_rtp); encoding_settings.merge(encoding_settings2); std::unique_ptr stats = RunEncodeTest(codec_type, codec_impl, video_info, encoding_settings); VideoCodecStats::Stream stream; if (stats != nullptr) { stream = stats->Aggregate({.min_timestamp_rtp = initial_timestamp_rtp}); if (absl::GetFlag(FLAGS_webrtc_quick_perf_test)) { EXPECT_NEAR(stream.bitrate_mismatch_pct.GetAverage(), 0, 10); EXPECT_NEAR(stream.framerate_mismatch_pct.GetAverage(), 0, 10); } } stream.LogMetrics( GetGlobalMetricsLogger(), ::testing::UnitTest::GetInstance()->current_test_info()->name(), /*metadata=*/ {{"codec_type", codec_type}, {"codec_impl", codec_impl}, {"video_name", video_info.name}, {"rate_profile", std::to_string(bitrate_kbps.first) + "," + std::to_string(bitrate_kbps.second)}}); } INSTANTIATE_TEST_SUITE_P(All, BitrateAdaptationTest, Combine(Values("AV1", "VP9", "VP8", "H264", "H265"), #if defined(WEBRTC_ANDROID) Values("builtin", "mediacodec"), #else Values("builtin"), #endif Values(kFourPeople_1280x720_30), Values(std::pair(1024, 512), std::pair(512, 1024))), BitrateAdaptationTest::TestParamsToString); class FramerateAdaptationTest : public ::testing::TestWithParam>> { public: static std::string TestParamsToString( const ::testing::TestParamInfo& info) { auto [codec_type, codec_impl, video_info, framerate_fps] = info.param; return std::string( codec_type + codec_impl + video_info.name + std::to_string(static_cast(1000 * framerate_fps.first)) + "mhz" + std::to_string(static_cast(1000 * framerate_fps.second)) + "mhz"); } }; TEST_P(FramerateAdaptationTest, FramerateAdaptation) { auto [codec_type, codec_impl, video_info, framerate_fps] = GetParam(); int duration_s = 10; // Duration of fixed rate interval. std::map encoding_settings = VideoCodecTester::CreateEncodingSettings( codec_type, /*scalability_mode=*/"L1T1", /*width=*/640, /*height=*/360, /*layer_bitrates_kbps=*/{512}, framerate_fps.first, static_cast(duration_s * framerate_fps.first)); uint32_t initial_timestamp_rtp = encoding_settings.rbegin()->first + k90kHz / Frequency::Hertz(framerate_fps.first); std::map encoding_settings2 = VideoCodecTester::CreateEncodingSettings( codec_type, /*scalability_mode=*/"L1T1", /*width=*/640, /*height=*/360, /*layer_bitrates_kbps=*/{512}, framerate_fps.second, static_cast(duration_s * framerate_fps.second), initial_timestamp_rtp); encoding_settings.merge(encoding_settings2); std::unique_ptr stats = RunEncodeTest(codec_type, codec_impl, video_info, encoding_settings); VideoCodecStats::Stream stream; if (stats != nullptr) { stream = stats->Aggregate({.min_timestamp_rtp = initial_timestamp_rtp}); if (absl::GetFlag(FLAGS_webrtc_quick_perf_test)) { EXPECT_NEAR(stream.bitrate_mismatch_pct.GetAverage(), 0, 10); EXPECT_NEAR(stream.framerate_mismatch_pct.GetAverage(), 0, 10); } } stream.LogMetrics( GetGlobalMetricsLogger(), ::testing::UnitTest::GetInstance()->current_test_info()->name(), /*metadata=*/ {{"codec_type", codec_type}, {"codec_impl", codec_impl}, {"video_name", video_info.name}, {"rate_profile", std::to_string(framerate_fps.first) + "," + std::to_string(framerate_fps.second)}}); } INSTANTIATE_TEST_SUITE_P(All, FramerateAdaptationTest, Combine(Values("AV1", "VP9", "VP8", "H264", "H265"), #if defined(WEBRTC_ANDROID) Values("builtin", "mediacodec"), #else Values("builtin"), #endif Values(kFourPeople_1280x720_30), Values(std::pair(30, 15), std::pair(15, 30))), FramerateAdaptationTest::TestParamsToString); } // namespace test } // namespace webrtc