d2930c6c2b
This CL is part of the Call-Level Adaptation Processing design doc: https://docs.google.com/document/d/1ZyC26yOCknrrcYa839ZWLxD6o6Gig5A3lVTh4E41074/edit?usp=sharing By pushing VideoAdaptationCounters updates on VideoSourceRestrictions changes, alongside the Resource* that triggered the adaptation, we are able to update |active_counts_| without an explicit dependency on the VideoStreamAdapter. This allows a future CL to split up "processor" logic from "video stream encoder resource and active counts" logic, which will ultimately be necessary in order to do processing on a "processing queue" and encoder and stats logic on the "encoder queue". If the restrictions got cleared by an API call (ResetVideoSourceRestrictions() or SetDegradationPreference()) we pass null as the "reason_resource". This allows is to clear the active_counts_, and the code that invokes OnVideoSourceRestrictionsUpdated() does not have to be aware of active_counts_ (needed to split the processor module in two). Bug: webrtc:11172 Change-Id: Icab6d5121c0ebd27d2a00f1bffc8191f8f05f562 Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/173000 Commit-Queue: Henrik Boström <hbos@webrtc.org> Reviewed-by: Ilya Nikolaevskiy <ilnik@webrtc.org> Reviewed-by: Evan Shrubsole <eshr@google.com> Cr-Commit-Position: refs/heads/master@{#31103}
58 lines
2.2 KiB
C++
58 lines
2.2 KiB
C++
/*
|
|
* Copyright 2020 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.
|
|
*/
|
|
|
|
#ifndef CALL_ADAPTATION_RESOURCE_ADAPTATION_PROCESSOR_INTERFACE_H_
|
|
#define CALL_ADAPTATION_RESOURCE_ADAPTATION_PROCESSOR_INTERFACE_H_
|
|
|
|
#include "absl/types/optional.h"
|
|
#include "api/rtp_parameters.h"
|
|
#include "api/video/video_adaptation_counters.h"
|
|
#include "api/video/video_frame.h"
|
|
#include "call/adaptation/encoder_settings.h"
|
|
#include "call/adaptation/resource.h"
|
|
#include "call/adaptation/video_source_restrictions.h"
|
|
|
|
namespace webrtc {
|
|
|
|
// The listener is responsible for carrying out the reconfiguration of the video
|
|
// source such that the VideoSourceRestrictions are fulfilled.
|
|
class ResourceAdaptationProcessorListener {
|
|
public:
|
|
virtual ~ResourceAdaptationProcessorListener();
|
|
|
|
// The |restrictions| are filtered by degradation preference but not the
|
|
// |adaptation_counters|, which are currently only reported for legacy stats
|
|
// calculation purposes.
|
|
virtual void OnVideoSourceRestrictionsUpdated(
|
|
VideoSourceRestrictions restrictions,
|
|
const VideoAdaptationCounters& adaptation_counters,
|
|
const Resource* reason) = 0;
|
|
};
|
|
|
|
// Responsible for reconfiguring encoded streams based on resource consumption,
|
|
// such as scaling down resolution or frame rate when CPU is overused. This
|
|
// interface is meant to be injectable into VideoStreamEncoder.
|
|
class ResourceAdaptationProcessorInterface {
|
|
public:
|
|
virtual ~ResourceAdaptationProcessorInterface();
|
|
|
|
virtual void StartResourceAdaptation(
|
|
ResourceAdaptationProcessorListener* adaptation_listener) = 0;
|
|
virtual void StopResourceAdaptation() = 0;
|
|
// The resource must out-live the module.
|
|
virtual void AddResource(Resource* resource) = 0;
|
|
virtual void SetDegradationPreference(
|
|
DegradationPreference degradation_preference) = 0;
|
|
};
|
|
|
|
} // namespace webrtc
|
|
|
|
#endif // CALL_ADAPTATION_RESOURCE_ADAPTATION_PROCESSOR_INTERFACE_H_
|