[Video] Record the results of background video optimization checks.

media/blink/webmediaplayer_impl.h

 // Copyright 2013 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef MEDIA_BLINK_WEBMEDIAPLAYER_IMPL_H_
 #define MEDIA_BLINK_WEBMEDIAPLAYER_IMPL_H_
 
 #include <stdint.h>
 
 #include <memory>
@@ skipping 440 matching lines @@
   // Return the pipeline media duration or the value overridden by tests.
   base::TimeDelta GetPipelineMediaDuration() const;
 
   void ReportTimeFromForegroundToFirstFrame(base::TimeTicks foreground_time,
                                             base::TimeTicks new_frame_time);
 
   // Records |duration| to the appropriate metric based on whether we're
   // handling a src= or MSE based playback.
   void RecordUnderflowDuration(base::TimeDelta duration);
 
+  // Indicates why ShouldPauseVideoWhenHidden() or
+  // ShouldDisableVideoWhenHidden() failed or succeeded for metrics recording.
+  // Must be in sync with the MediaBackgroundOptimizationCandidacyResult enum
+  // in histograms.xml.
+  enum BackgroundOptimizationResult {
+    // Was optimized because shorter than the threshold.
+    SUCCESS_FOR_DURATION,
+    // Was optimized because keyframe distance is shorter than the threshold.
+    SUCCESS_FOR_KEYFRAME_DISTANCE,
+    // Was optimized because it doesn't have audio ignoring the threshold.
+    SUCCESS_FOR_VIDEO_ONLY,
+    // Wasn't optimized because keyframe distance is too big.
+    FAIL_FOR_KEYFRAME_DISTANCE,
+    // Wasn't optimized because is being played remotely.
+    FAIL_FOR_REMOTE,
+    // Wasn't optimized because is a streaming video.
+    FAIL_FOR_STREAMING,
+
+    // Must be the last item and set to the previous item's value.
+    RESULT_MAX = FAIL_FOR_STREAMING
+  };
+
+  // Reports the result of each background optimization check.
+  // Figures the right bucket based on whether the video has audio or not.
+  void ReportBackgroundOptimizationResult(
+      BackgroundOptimizationResult result) const;
+
   blink::WebLocalFrame* frame_;
 
   // The playback state last reported to |delegate_|, to avoid setting duplicate
   // states.
   // TODO(sandersd): The delegate should be implementing deduplication.
   DelegateState delegate_state_;
   bool delegate_has_audio_;
 
   blink::WebMediaPlayer::NetworkState network_state_;
   blink::WebMediaPlayer::ReadyState ready_state_;
@@ skipping 249 matching lines @@
   base::TimeDelta last_uploaded_frame_timestamp_;
 
   base::CancelableCallback<void(base::TimeTicks)> frame_time_report_cb_;
 
   DISALLOW_COPY_AND_ASSIGN(WebMediaPlayerImpl);
 };
 
 }  // namespace media
 
 #endif  // MEDIA_BLINK_WEBMEDIAPLAYER_IMPL_H_