f0eef12e68
This should help debugging when adaptation is or is not happening unexpectedly. Log spam is prevented by not logging if the same result happened to the same resource already and we haven't adapted since then. Bug: webrtc:11616 Change-Id: Ia6c5cc35061d252f1c66f2f2bf3b94d2485498d6 Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/176221 Commit-Queue: Henrik Boström <hbos@webrtc.org> Reviewed-by: Evan Shrubsole <eshr@google.com> Reviewed-by: Harald Alvestrand <hta@webrtc.org> Cr-Commit-Position: refs/heads/master@{#31378}
95 lines
3.1 KiB
C++
95 lines
3.1 KiB
C++
/*
|
|
* Copyright 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.
|
|
*/
|
|
|
|
#ifndef CALL_ADAPTATION_RESOURCE_H_
|
|
#define CALL_ADAPTATION_RESOURCE_H_
|
|
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
#include "absl/types/optional.h"
|
|
#include "api/scoped_refptr.h"
|
|
#include "call/adaptation/video_source_restrictions.h"
|
|
#include "call/adaptation/video_stream_input_state.h"
|
|
#include "rtc_base/ref_count.h"
|
|
#include "rtc_base/task_queue.h"
|
|
|
|
namespace webrtc {
|
|
|
|
class Resource;
|
|
|
|
enum class ResourceUsageState {
|
|
// Action is needed to minimze the load on this resource.
|
|
kOveruse,
|
|
// Increasing the load on this resource is desired, if possible.
|
|
kUnderuse,
|
|
};
|
|
|
|
const char* ResourceUsageStateToString(ResourceUsageState usage_state);
|
|
|
|
class ResourceListener {
|
|
public:
|
|
virtual ~ResourceListener();
|
|
|
|
// Informs the listener of a new measurement of resource usage. This means
|
|
// that |resource->usage_state()| is now up-to-date.
|
|
virtual void OnResourceUsageStateMeasured(
|
|
rtc::scoped_refptr<Resource> resource) = 0;
|
|
};
|
|
|
|
class Resource : public rtc::RefCountInterface {
|
|
public:
|
|
// By default, usage_state() is null until a measurement is made.
|
|
Resource();
|
|
~Resource() override;
|
|
|
|
void Initialize(rtc::TaskQueue* encoder_queue,
|
|
rtc::TaskQueue* resource_adaptation_queue);
|
|
|
|
void SetResourceListener(ResourceListener* listener);
|
|
|
|
absl::optional<ResourceUsageState> usage_state() const;
|
|
void ClearUsageState();
|
|
|
|
// This method allows the Resource to reject a proposed adaptation in the "up"
|
|
// direction if it predicts this would cause overuse of this resource. The
|
|
// default implementation unconditionally returns true (= allowed).
|
|
virtual bool IsAdaptationUpAllowed(
|
|
const VideoStreamInputState& input_state,
|
|
const VideoSourceRestrictions& restrictions_before,
|
|
const VideoSourceRestrictions& restrictions_after,
|
|
rtc::scoped_refptr<Resource> reason_resource) const;
|
|
virtual void OnAdaptationApplied(
|
|
const VideoStreamInputState& input_state,
|
|
const VideoSourceRestrictions& restrictions_before,
|
|
const VideoSourceRestrictions& restrictions_after,
|
|
rtc::scoped_refptr<Resource> reason_resource);
|
|
|
|
virtual std::string name() const = 0;
|
|
|
|
protected:
|
|
rtc::TaskQueue* encoder_queue() const;
|
|
rtc::TaskQueue* resource_adaptation_queue() const;
|
|
|
|
// Updates the usage state and informs all registered listeners.
|
|
void OnResourceUsageStateMeasured(ResourceUsageState usage_state);
|
|
|
|
private:
|
|
rtc::TaskQueue* encoder_queue_;
|
|
rtc::TaskQueue* resource_adaptation_queue_;
|
|
absl::optional<ResourceUsageState> usage_state_
|
|
RTC_GUARDED_BY(resource_adaptation_queue_);
|
|
ResourceListener* listener_ RTC_GUARDED_BY(resource_adaptation_queue_);
|
|
};
|
|
|
|
} // namespace webrtc
|
|
|
|
#endif // CALL_ADAPTATION_RESOURCE_H_
|