| /* |
| * 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 <utility> |
| |
| #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<RtcEventLogFactory>( |
| components->pcf_dependencies->task_queue_factory.get()); |
| } |
| } |
| |
| class TestPeerComponents { |
| public: |
| TestPeerComponents(std::unique_ptr<InjectableComponents> components, |
| const Params& params, |
| MockPeerConnectionObserver* observer, |
| VideoQualityAnalyzerInjectionHelper* video_analyzer_helper, |
| rtc::Thread* signaling_thread, |
| absl::optional<RemotePeerAudioConfig> remote_audio_config, |
| double bitrate_multiplier, |
| absl::optional<EchoEmulationConfig> 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<int>(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<PeerConnectionFactoryInterface> peer_connection_factory() |
| const { |
| return peer_connection_factory_; |
| } |
| rtc::scoped_refptr<PeerConnectionInterface> peer_connection() const { |
| return peer_connection_; |
| } |
| rtc::scoped_refptr<AudioProcessing> 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<PeerConnectionFactoryComponents> 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); |
| } |
| |
| return pcf_deps; |
| } |
| |
| std::unique_ptr<cricket::MediaEngineInterface> 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<AudioDeviceModule> CreateAudioDeviceModule( |
| TaskQueueFactory* task_queue_factory) { |
| std::unique_ptr<TestAudioDeviceModule::Renderer> renderer = |
| CreateAudioRenderer(remote_audio_config_); |
| std::unique_ptr<TestAudioDeviceModule::Capturer> capturer = |
| CreateAudioCapturer(audio_config_opt_); |
| RTC_DCHECK(renderer); |
| RTC_DCHECK(capturer); |
| |
| // Setup echo emulation if required. |
| if (echo_emulation_config_) { |
| capturer = std::make_unique<EchoEmulatingCapturer>( |
| std::move(capturer), *echo_emulation_config_); |
| renderer = std::make_unique<EchoEmulatingRenderer>( |
| std::move(renderer), |
| static_cast<EchoEmulatingCapturer*>(capturer.get())); |
| } |
| |
| // Setup input stream dumping if required. |
| if (audio_config_opt_ && audio_config_opt_->input_dump_file_name) { |
| capturer = std::make_unique<test::CopyToFileAudioCapturer>( |
| 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<TestAudioDeviceModule::Renderer> CreateAudioRenderer( |
| const absl::optional<RemotePeerAudioConfig>& 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<TestAudioDeviceModule::Capturer> CreateAudioCapturer( |
| const absl::optional<AudioConfig>& 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<VideoEncoderFactory> CreateVideoEncoderFactory( |
| PeerConnectionFactoryComponents* pcf_dependencies) { |
| std::unique_ptr<VideoEncoderFactory> 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<VideoDecoderFactory> CreateVideoDecoderFactory( |
| PeerConnectionFactoryComponents* pcf_dependencies) { |
| std::unique_ptr<VideoDecoderFactory> 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<PeerConnectionComponents> pc_dependencies) { |
| PeerConnectionDependencies pc_deps(observer_); |
| |
| auto port_allocator = std::make_unique<cricket::BasicPortAllocator>( |
| 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); |
| } |
| return pc_deps; |
| } |
| |
| rtc::scoped_refptr<PeerConnectionFactoryInterface> peer_connection_factory_; |
| rtc::scoped_refptr<PeerConnectionInterface> peer_connection_; |
| rtc::scoped_refptr<AudioProcessing> audio_processing_; |
| |
| std::map<std::string, absl::optional<int>> stream_required_spatial_index_; |
| absl::optional<AudioConfig> audio_config_opt_; |
| MockPeerConnectionObserver* observer_; |
| VideoQualityAnalyzerInjectionHelper* video_analyzer_helper_; |
| rtc::Thread* signaling_thread_; |
| absl::optional<RemotePeerAudioConfig> remote_audio_config_; |
| double bitrate_multiplier_; |
| absl::optional<EchoEmulationConfig> echo_emulation_config_; |
| }; |
| |
| } // namespace |
| |
| absl::optional<RemotePeerAudioConfig> TestPeer::CreateRemoteAudioConfig( |
| absl::optional<AudioConfig> config) { |
| if (!config) { |
| return absl::nullopt; |
| } |
| return RemotePeerAudioConfig(config.value()); |
| } |
| |
| std::unique_ptr<TestPeer> TestPeer::CreateTestPeer( |
| std::unique_ptr<InjectableComponents> components, |
| std::unique_ptr<Params> params, |
| std::unique_ptr<MockPeerConnectionObserver> observer, |
| VideoQualityAnalyzerInjectionHelper* video_analyzer_helper, |
| rtc::Thread* signaling_thread, |
| absl::optional<RemotePeerAudioConfig> remote_audio_config, |
| double bitrate_multiplier, |
| absl::optional<EchoEmulationConfig> echo_emulation_config, |
| rtc::TaskQueue* task_queue) { |
| RTC_DCHECK(components); |
| RTC_DCHECK(params); |
| 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), tpc.audio_processing())); |
| } |
| |
| bool TestPeer::AddIceCandidates( |
| std::vector<std::unique_ptr<IceCandidateInterface>> 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<PeerConnectionFactoryInterface> pc_factory, |
| rtc::scoped_refptr<PeerConnectionInterface> pc, |
| std::unique_ptr<MockPeerConnectionObserver> observer, |
| std::unique_ptr<Params> params, |
| rtc::scoped_refptr<AudioProcessing> audio_processing) |
| : PeerConnectionWrapper::PeerConnectionWrapper(std::move(pc_factory), |
| std::move(pc), |
| std::move(observer)), |
| params_(std::move(params)), |
| audio_processing_(audio_processing) {} |
| |
| } // namespace webrtc_pc_e2e |
| } // namespace webrtc |