/* * Copyright (c) 2019 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 "test/pc/e2e/test_peer.h" #include #include "absl/memory/memory.h" #include "absl/types/optional.h" #include "api/rtc_event_log/rtc_event_log_factory.h" #include "api/scoped_refptr.h" #include "api/task_queue/default_task_queue_factory.h" #include "api/task_queue/task_queue_factory.h" #include "api/video_codecs/builtin_video_decoder_factory.h" #include "api/video_codecs/builtin_video_encoder_factory.h" #include "media/engine/webrtc_media_engine.h" #include "media/engine/webrtc_media_engine_defaults.h" #include "modules/audio_device/include/audio_device.h" #include "modules/audio_processing/aec_dump/aec_dump_factory.h" #include "modules/audio_processing/include/audio_processing.h" #include "p2p/client/basic_port_allocator.h" #include "rtc_base/location.h" #include "test/pc/e2e/echo/echo_emulation.h" #include "test/testsupport/copy_to_file_audio_capturer.h" namespace webrtc { namespace webrtc_pc_e2e { namespace { using RemotePeerAudioConfig = ::webrtc::webrtc_pc_e2e::TestPeer::RemotePeerAudioConfig; using AudioConfig = ::webrtc::webrtc_pc_e2e::PeerConnectionE2EQualityTestFixture::AudioConfig; using EchoEmulationConfig = ::webrtc::webrtc_pc_e2e:: PeerConnectionE2EQualityTestFixture::EchoEmulationConfig; constexpr int16_t kGeneratedAudioMaxAmplitude = 32000; constexpr int kDefaultSamplingFrequencyInHz = 48000; // Sets mandatory entities in injectable components like |pcf_dependencies| // and |pc_dependencies| if they are omitted. Also setup required // dependencies, that won't be specially provided by factory and will be just // transferred to peer connection creation code. void SetMandatoryEntities(InjectableComponents* components) { RTC_DCHECK(components->pcf_dependencies); RTC_DCHECK(components->pc_dependencies); // Setup required peer connection factory dependencies. if (components->pcf_dependencies->task_queue_factory == nullptr) { components->pcf_dependencies->task_queue_factory = CreateDefaultTaskQueueFactory(); } if (components->pcf_dependencies->call_factory == nullptr) { components->pcf_dependencies->call_factory = webrtc::CreateCallFactory(); } if (components->pcf_dependencies->event_log_factory == nullptr) { components->pcf_dependencies->event_log_factory = std::make_unique( components->pcf_dependencies->task_queue_factory.get()); } } class TestPeerComponents { public: TestPeerComponents(std::unique_ptr components, const Params& params, MockPeerConnectionObserver* observer, VideoQualityAnalyzerInjectionHelper* video_analyzer_helper, rtc::Thread* signaling_thread, absl::optional remote_audio_config, double bitrate_multiplier, absl::optional echo_emulation_config, rtc::TaskQueue* task_queue) : audio_config_opt_(params.audio_config), observer_(observer), video_analyzer_helper_(video_analyzer_helper), signaling_thread_(signaling_thread), remote_audio_config_(std::move(remote_audio_config)), bitrate_multiplier_(bitrate_multiplier), echo_emulation_config_(std::move(echo_emulation_config)) { for (auto& video_config : params.video_configs) { // Stream label should be set by fixture implementation here. RTC_DCHECK(video_config.stream_label); bool res = stream_required_spatial_index_ .insert({*video_config.stream_label, video_config.simulcast_config ? absl::optional(video_config.simulcast_config ->target_spatial_index) : absl::nullopt}) .second; RTC_DCHECK(res) << "Duplicate video_config.stream_label=" << *video_config.stream_label; } // Create audio processing, that will be used to create media engine that // then will be added into peer connection. See CreateMediaEngine(...). audio_processing_ = webrtc::AudioProcessingBuilder().Create(); if (params.aec_dump_path) { audio_processing_->AttachAecDump( AecDumpFactory::Create(*params.aec_dump_path, -1, task_queue)); } // Create peer connection factory. PeerConnectionFactoryDependencies pcf_deps = CreatePCFDependencies( std::move(components->pcf_dependencies), components->network_thread); peer_connection_factory_ = CreateModularPeerConnectionFactory(std::move(pcf_deps)); // Create peer connection. PeerConnectionDependencies pc_deps = CreatePCDependencies(std::move(components->pc_dependencies)); peer_connection_ = peer_connection_factory_->CreatePeerConnection( params.rtc_configuration, std::move(pc_deps)); peer_connection_->SetBitrate(params.bitrate_params); } rtc::scoped_refptr peer_connection_factory() const { return peer_connection_factory_; } rtc::scoped_refptr peer_connection() const { return peer_connection_; } rtc::scoped_refptr audio_processing() const { return audio_processing_; } private: // Creates PeerConnectionFactoryDependencies objects, providing entities // from InjectableComponents::PeerConnectionFactoryComponents and also // creating entities, that are required for correct injection of media quality // analyzers. PeerConnectionFactoryDependencies CreatePCFDependencies( std::unique_ptr pcf_dependencies, rtc::Thread* network_thread) { PeerConnectionFactoryDependencies pcf_deps; pcf_deps.network_thread = network_thread; pcf_deps.signaling_thread = signaling_thread_; pcf_deps.media_engine = CreateMediaEngine(pcf_dependencies.get()); pcf_deps.call_factory = std::move(pcf_dependencies->call_factory); pcf_deps.event_log_factory = std::move(pcf_dependencies->event_log_factory); pcf_deps.task_queue_factory = std::move(pcf_dependencies->task_queue_factory); if (pcf_dependencies->fec_controller_factory != nullptr) { pcf_deps.fec_controller_factory = std::move(pcf_dependencies->fec_controller_factory); } if (pcf_dependencies->network_controller_factory != nullptr) { pcf_deps.network_controller_factory = std::move(pcf_dependencies->network_controller_factory); } if (pcf_dependencies->media_transport_factory != nullptr) { pcf_deps.media_transport_factory = std::move(pcf_dependencies->media_transport_factory); } if (pcf_dependencies->neteq_factory != nullptr) { pcf_deps.neteq_factory = std::move(pcf_dependencies->neteq_factory); } return pcf_deps; } std::unique_ptr CreateMediaEngine( PeerConnectionFactoryComponents* pcf_dependencies) { cricket::MediaEngineDependencies media_deps; media_deps.task_queue_factory = pcf_dependencies->task_queue_factory.get(); media_deps.adm = CreateAudioDeviceModule(media_deps.task_queue_factory); media_deps.audio_processing = audio_processing_; media_deps.video_encoder_factory = CreateVideoEncoderFactory(pcf_dependencies); media_deps.video_decoder_factory = CreateVideoDecoderFactory(pcf_dependencies); webrtc::SetMediaEngineDefaults(&media_deps); return cricket::CreateMediaEngine(std::move(media_deps)); } rtc::scoped_refptr CreateAudioDeviceModule( TaskQueueFactory* task_queue_factory) { std::unique_ptr renderer = CreateAudioRenderer(remote_audio_config_); std::unique_ptr capturer = CreateAudioCapturer(audio_config_opt_); RTC_DCHECK(renderer); RTC_DCHECK(capturer); // Setup echo emulation if required. if (echo_emulation_config_) { capturer = std::make_unique( std::move(capturer), *echo_emulation_config_); renderer = std::make_unique( std::move(renderer), static_cast(capturer.get())); } // Setup input stream dumping if required. if (audio_config_opt_ && audio_config_opt_->input_dump_file_name) { capturer = std::make_unique( std::move(capturer), audio_config_opt_->input_dump_file_name.value()); } return TestAudioDeviceModule::Create(task_queue_factory, std::move(capturer), std::move(renderer), /*speed=*/1.f); } std::unique_ptr CreateAudioRenderer( const absl::optional& config) { if (!config) { // Return default renderer because we always require some renderer. return TestAudioDeviceModule::CreateDiscardRenderer( kDefaultSamplingFrequencyInHz); } if (config->output_file_name) { return TestAudioDeviceModule::CreateBoundedWavFileWriter( config->output_file_name.value(), config->sampling_frequency_in_hz); } return TestAudioDeviceModule::CreateDiscardRenderer( config->sampling_frequency_in_hz); } std::unique_ptr CreateAudioCapturer( const absl::optional& audio_config) { if (!audio_config) { // If we have no audio config we still need to provide some audio device. // In such case use generated capturer. Despite of we provided audio here, // in test media setup audio stream won't be added into peer connection. return TestAudioDeviceModule::CreatePulsedNoiseCapturer( kGeneratedAudioMaxAmplitude, kDefaultSamplingFrequencyInHz); } switch (audio_config->mode) { case AudioConfig::Mode::kGenerated: return TestAudioDeviceModule::CreatePulsedNoiseCapturer( kGeneratedAudioMaxAmplitude, audio_config->sampling_frequency_in_hz); case AudioConfig::Mode::kFile: RTC_DCHECK(audio_config->input_file_name); return TestAudioDeviceModule::CreateWavFileReader( audio_config->input_file_name.value(), /*repeat=*/true); } } std::unique_ptr CreateVideoEncoderFactory( PeerConnectionFactoryComponents* pcf_dependencies) { std::unique_ptr video_encoder_factory; if (pcf_dependencies->video_encoder_factory != nullptr) { video_encoder_factory = std::move(pcf_dependencies->video_encoder_factory); } else { video_encoder_factory = CreateBuiltinVideoEncoderFactory(); } return video_analyzer_helper_->WrapVideoEncoderFactory( std::move(video_encoder_factory), bitrate_multiplier_, stream_required_spatial_index_); } std::unique_ptr CreateVideoDecoderFactory( PeerConnectionFactoryComponents* pcf_dependencies) { std::unique_ptr video_decoder_factory; if (pcf_dependencies->video_decoder_factory != nullptr) { video_decoder_factory = std::move(pcf_dependencies->video_decoder_factory); } else { video_decoder_factory = CreateBuiltinVideoDecoderFactory(); } return video_analyzer_helper_->WrapVideoDecoderFactory( std::move(video_decoder_factory)); } // Creates PeerConnectionDependencies objects, providing entities // from InjectableComponents::PeerConnectionComponents. PeerConnectionDependencies CreatePCDependencies( std::unique_ptr pc_dependencies) { PeerConnectionDependencies pc_deps(observer_); auto port_allocator = std::make_unique( pc_dependencies->network_manager); // This test does not support TCP int flags = cricket::PORTALLOCATOR_DISABLE_TCP; port_allocator->set_flags(port_allocator->flags() | flags); pc_deps.allocator = std::move(port_allocator); if (pc_dependencies->async_resolver_factory != nullptr) { pc_deps.async_resolver_factory = std::move(pc_dependencies->async_resolver_factory); } if (pc_dependencies->cert_generator != nullptr) { pc_deps.cert_generator = std::move(pc_dependencies->cert_generator); } if (pc_dependencies->tls_cert_verifier != nullptr) { pc_deps.tls_cert_verifier = std::move(pc_dependencies->tls_cert_verifier); } if (pc_dependencies->ice_transport_factory != nullptr) { pc_deps.ice_transport_factory = std::move(pc_dependencies->ice_transport_factory); } return pc_deps; } rtc::scoped_refptr peer_connection_factory_; rtc::scoped_refptr peer_connection_; rtc::scoped_refptr audio_processing_; std::map> stream_required_spatial_index_; absl::optional audio_config_opt_; MockPeerConnectionObserver* observer_; VideoQualityAnalyzerInjectionHelper* video_analyzer_helper_; rtc::Thread* signaling_thread_; absl::optional remote_audio_config_; double bitrate_multiplier_; absl::optional echo_emulation_config_; }; } // namespace absl::optional TestPeer::CreateRemoteAudioConfig( absl::optional config) { if (!config) { return absl::nullopt; } return RemotePeerAudioConfig(config.value()); } std::unique_ptr TestPeer::CreateTestPeer( std::unique_ptr components, std::unique_ptr params, std::vector> video_generators, std::unique_ptr observer, VideoQualityAnalyzerInjectionHelper* video_analyzer_helper, rtc::Thread* signaling_thread, absl::optional remote_audio_config, double bitrate_multiplier, absl::optional echo_emulation_config, rtc::TaskQueue* task_queue) { RTC_DCHECK(components); RTC_DCHECK(params); RTC_DCHECK_EQ(params->video_configs.size(), video_generators.size()); SetMandatoryEntities(components.get()); params->rtc_configuration.sdp_semantics = SdpSemantics::kUnifiedPlan; TestPeerComponents tpc(std::move(components), *params, observer.get(), video_analyzer_helper, signaling_thread, std::move(remote_audio_config), bitrate_multiplier, echo_emulation_config, task_queue); return absl::WrapUnique(new TestPeer( tpc.peer_connection_factory(), tpc.peer_connection(), std::move(observer), std::move(params), std::move(video_generators), tpc.audio_processing())); } bool TestPeer::AddIceCandidates( std::vector> candidates) { bool success = true; for (auto& candidate : candidates) { if (!pc()->AddIceCandidate(candidate.get())) { std::string candidate_str; bool res = candidate->ToString(&candidate_str); RTC_CHECK(res); RTC_LOG(LS_ERROR) << "Failed to add ICE candidate, candidate_str=" << candidate_str; success = false; } else { remote_ice_candidates_.push_back(std::move(candidate)); } } return success; } TestPeer::TestPeer( rtc::scoped_refptr pc_factory, rtc::scoped_refptr pc, std::unique_ptr observer, std::unique_ptr params, std::vector> video_generators, rtc::scoped_refptr audio_processing) : PeerConnectionWrapper::PeerConnectionWrapper(std::move(pc_factory), std::move(pc), std::move(observer)), params_(std::move(params)), video_generators_(std::move(video_generators)), audio_processing_(audio_processing) {} } // namespace webrtc_pc_e2e } // namespace webrtc