Files
platform-external-webrtc/call/adaptation/resource_consumer.h
Henrik Boström b04b2a1719 Initial version of ResourceAdaptationProcessor and friends.
This CL adds Resource, ResourceConsumer, ResourceConsumerConfiguration
and ResourceAdaptationProcessor and implements the algorithm outlined
in
https://docs.google.com/presentation/d/13jyqCWNpIa873iKT6yDuB5Q5ma-c0CvxBpX--0tCclY/edit?usp=sharing.

Simply put, if any resource (such as "CPU") is overusing, the most
expensive consumer (e.g. encoded stream) is adapted one step down.
If all resources are underusing, the least expensive consumer is
adapted one step up.

The current resources, consumers and configurations are all fakes;
this CL has no effect on the current adaptation algorithms used in
practise, but it lays down the foundation for future work in this
area.

Bug: webrtc:11167, webrtc:11168, webrtc:11169
Change-Id: I4054ec7728a52a49e137eee6fa67fa27debd9254
Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/161237
Commit-Queue: Henrik Boström <hbos@webrtc.org>
Reviewed-by: Evan Shrubsole <eshr@google.com>
Reviewed-by: Stefan Holmer <stefan@webrtc.org>
Reviewed-by: Erik Språng <sprang@webrtc.org>
Cr-Commit-Position: refs/heads/master@{#30053}
2019-12-10 15:31:43 +00:00

50 lines
1.6 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_CONSUMER_H_
#define CALL_ADAPTATION_RESOURCE_CONSUMER_H_
#include <string>
namespace webrtc {
class ResourceConsumerConfiguration;
// Something which affects resource consumption. Used by the
// ResourceAdaptationProcessor to calculate which configurations to use.
//
// For example, this could represent an encoder, and valid
// ResourceConsumerConfigurations would be encoder settings. How a consumer
// affects a resource is described by the ResourceConsumerConfiguration.
//
// The functionality provided by the base class is a name and pointer to the
// current configuration. How a consumers and configurations affect real parts
// of the system (like actual encoders) is implementation-specific.
class ResourceConsumer {
public:
ResourceConsumer(std::string name,
ResourceConsumerConfiguration* configuration);
~ResourceConsumer();
std::string name() const;
ResourceConsumerConfiguration* configuration() const;
void SetConfiguration(ResourceConsumerConfiguration* configuration);
std::string ToString() const;
private:
std::string name_;
ResourceConsumerConfiguration* configuration_;
};
} // namespace webrtc
#endif // CALL_ADAPTATION_RESOURCE_CONSUMER_H_