| OLD | NEW |
| 1 /* | 1 /* |
| 2 * Copyright (c) 2013 The WebRTC project authors. All Rights Reserved. | 2 * Copyright (c) 2013 The WebRTC project authors. All Rights Reserved. |
| 3 * | 3 * |
| 4 * Use of this source code is governed by a BSD-style license | 4 * Use of this source code is governed by a BSD-style license |
| 5 * that can be found in the LICENSE file in the root of the source | 5 * that can be found in the LICENSE file in the root of the source |
| 6 * tree. An additional intellectual property rights grant can be found | 6 * tree. An additional intellectual property rights grant can be found |
| 7 * in the file PATENTS. All contributing project authors may | 7 * in the file PATENTS. All contributing project authors may |
| 8 * be found in the AUTHORS file in the root of the source tree. | 8 * be found in the AUTHORS file in the root of the source tree. |
| 9 */ | 9 */ |
| 10 | 10 |
| 11 #ifndef WEBRTC_VIDEO_OVERUSE_FRAME_DETECTOR_H_ | 11 #ifndef WEBRTC_VIDEO_OVERUSE_FRAME_DETECTOR_H_ |
| 12 #define WEBRTC_VIDEO_OVERUSE_FRAME_DETECTOR_H_ | 12 #define WEBRTC_VIDEO_OVERUSE_FRAME_DETECTOR_H_ |
| 13 | 13 |
| 14 #include <list> | 14 #include <list> |
| 15 #include <memory> | 15 #include <memory> |
| 16 | 16 |
| 17 #include "webrtc/base/analytics/exp_filter.h" | 17 #include "webrtc/base/analytics/exp_filter.h" |
| 18 #include "webrtc/base/constructormagic.h" | 18 #include "webrtc/base/constructormagic.h" |
| 19 #include "webrtc/base/optional.h" | 19 #include "webrtc/base/optional.h" |
| 20 #include "webrtc/base/sequenced_task_checker.h" | 20 #include "webrtc/base/sequenced_task_checker.h" |
| 21 #include "webrtc/base/task_queue.h" | 21 #include "webrtc/base/task_queue.h" |
| 22 #include "webrtc/base/thread_annotations.h" | 22 #include "webrtc/base/thread_annotations.h" |
| 23 #include "webrtc/modules/video_coding/utility/quality_scaler.h" |
| 23 | 24 |
| 24 namespace webrtc { | 25 namespace webrtc { |
| 25 | 26 |
| 26 class Clock; | 27 class Clock; |
| 27 class EncodedFrameObserver; | 28 class EncodedFrameObserver; |
| 28 class VideoFrame; | 29 class VideoFrame; |
| 29 | 30 |
| 30 // CpuOveruseObserver is called when a system overuse is detected and | |
| 31 // VideoEngine cannot keep up the encoding frequency. | |
| 32 class CpuOveruseObserver { | |
| 33 public: | |
| 34 // Called as soon as an overuse is detected. | |
| 35 virtual void OveruseDetected() = 0; | |
| 36 // Called periodically when the system is not overused any longer. | |
| 37 virtual void NormalUsage() = 0; | |
| 38 | |
| 39 protected: | |
| 40 virtual ~CpuOveruseObserver() {} | |
| 41 }; | |
| 42 | |
| 43 struct CpuOveruseOptions { | 31 struct CpuOveruseOptions { |
| 44 CpuOveruseOptions(); | 32 CpuOveruseOptions(); |
| 45 | 33 |
| 46 int low_encode_usage_threshold_percent; // Threshold for triggering underuse. | 34 int low_encode_usage_threshold_percent; // Threshold for triggering underuse. |
| 47 int high_encode_usage_threshold_percent; // Threshold for triggering overuse. | 35 int high_encode_usage_threshold_percent; // Threshold for triggering overuse. |
| 48 // General settings. | 36 // General settings. |
| 49 int frame_timeout_interval_ms; // The maximum allowed interval between two | 37 int frame_timeout_interval_ms; // The maximum allowed interval between two |
| 50 // frames before resetting estimations. | 38 // frames before resetting estimations. |
| 51 int min_frame_samples; // The minimum number of frames required. | 39 int min_frame_samples; // The minimum number of frames required. |
| 52 int min_process_count; // The number of initial process times required before | 40 int min_process_count; // The number of initial process times required before |
| (...skipping 19 matching lines...) Expand all Loading... |
| 72 | 60 |
| 73 // Use to detect system overuse based on the send-side processing time of | 61 // Use to detect system overuse based on the send-side processing time of |
| 74 // incoming frames. All methods must be called on a single task queue but it can | 62 // incoming frames. All methods must be called on a single task queue but it can |
| 75 // be created and destroyed on an arbitrary thread. | 63 // be created and destroyed on an arbitrary thread. |
| 76 // OveruseFrameDetector::StartCheckForOveruse must be called to periodically | 64 // OveruseFrameDetector::StartCheckForOveruse must be called to periodically |
| 77 // check for overuse. | 65 // check for overuse. |
| 78 class OveruseFrameDetector { | 66 class OveruseFrameDetector { |
| 79 public: | 67 public: |
| 80 OveruseFrameDetector(Clock* clock, | 68 OveruseFrameDetector(Clock* clock, |
| 81 const CpuOveruseOptions& options, | 69 const CpuOveruseOptions& options, |
| 82 CpuOveruseObserver* overuse_observer, | 70 ScalingObserverInterface* overuse_observer, |
| 83 EncodedFrameObserver* encoder_timing_, | 71 EncodedFrameObserver* encoder_timing_, |
| 84 CpuOveruseMetricsObserver* metrics_observer); | 72 CpuOveruseMetricsObserver* metrics_observer); |
| 85 ~OveruseFrameDetector(); | 73 ~OveruseFrameDetector(); |
| 86 | 74 |
| 87 // Start to periodically check for overuse. | 75 // Start to periodically check for overuse. |
| 88 void StartCheckForOveruse(); | 76 void StartCheckForOveruse(); |
| 89 | 77 |
| 90 // StopCheckForOveruse must be called before destruction if | 78 // StopCheckForOveruse must be called before destruction if |
| 91 // StartCheckForOveruse has been called. | 79 // StartCheckForOveruse has been called. |
| 92 void StopCheckForOveruse(); | 80 void StopCheckForOveruse(); |
| (...skipping 31 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 124 | 112 |
| 125 void ResetAll(int num_pixels); | 113 void ResetAll(int num_pixels); |
| 126 | 114 |
| 127 rtc::SequencedTaskChecker task_checker_; | 115 rtc::SequencedTaskChecker task_checker_; |
| 128 // Owned by the task queue from where StartCheckForOveruse is called. | 116 // Owned by the task queue from where StartCheckForOveruse is called. |
| 129 CheckOveruseTask* check_overuse_task_; | 117 CheckOveruseTask* check_overuse_task_; |
| 130 | 118 |
| 131 const CpuOveruseOptions options_; | 119 const CpuOveruseOptions options_; |
| 132 | 120 |
| 133 // Observer getting overuse reports. | 121 // Observer getting overuse reports. |
| 134 CpuOveruseObserver* const observer_; | 122 ScalingObserverInterface* const observer_; |
| 135 EncodedFrameObserver* const encoder_timing_; | 123 EncodedFrameObserver* const encoder_timing_; |
| 136 | 124 |
| 137 // Stats metrics. | 125 // Stats metrics. |
| 138 CpuOveruseMetricsObserver* const metrics_observer_; | 126 CpuOveruseMetricsObserver* const metrics_observer_; |
| 139 rtc::Optional<CpuOveruseMetrics> metrics_ GUARDED_BY(task_checker_); | 127 rtc::Optional<CpuOveruseMetrics> metrics_ GUARDED_BY(task_checker_); |
| 140 Clock* const clock_; | 128 Clock* const clock_; |
| 141 | 129 |
| 142 int64_t num_process_times_ GUARDED_BY(task_checker_); | 130 int64_t num_process_times_ GUARDED_BY(task_checker_); |
| 143 | 131 |
| 144 int64_t last_capture_time_ms_ GUARDED_BY(task_checker_); | 132 int64_t last_capture_time_ms_ GUARDED_BY(task_checker_); |
| (...skipping 12 matching lines...) Expand all Loading... |
| 157 // allocs)? | 145 // allocs)? |
| 158 const std::unique_ptr<SendProcessingUsage> usage_ GUARDED_BY(task_checker_); | 146 const std::unique_ptr<SendProcessingUsage> usage_ GUARDED_BY(task_checker_); |
| 159 std::list<FrameTiming> frame_timing_ GUARDED_BY(task_checker_); | 147 std::list<FrameTiming> frame_timing_ GUARDED_BY(task_checker_); |
| 160 | 148 |
| 161 RTC_DISALLOW_COPY_AND_ASSIGN(OveruseFrameDetector); | 149 RTC_DISALLOW_COPY_AND_ASSIGN(OveruseFrameDetector); |
| 162 }; | 150 }; |
| 163 | 151 |
| 164 } // namespace webrtc | 152 } // namespace webrtc |
| 165 | 153 |
| 166 #endif // WEBRTC_VIDEO_OVERUSE_FRAME_DETECTOR_H_ | 154 #endif // WEBRTC_VIDEO_OVERUSE_FRAME_DETECTOR_H_ |
| OLD | NEW |