Add watch time metrics for HTML5 media playback.

content/browser/media/media_internals.cc

 // Copyright (c) 2012 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.
 
 #include "content/browser/media/media_internals.h"
 
 #include <stddef.h>
 
 #include <memory>
 #include <utility>
 
 #include "base/macros.h"
 #include "base/metrics/histogram.h"
 #include "base/strings/string16.h"
 #include "base/strings/string_number_conversions.h"
 #include "base/strings/stringprintf.h"
 #include "build/build_config.h"
 #include "content/browser/renderer_host/media/media_stream_manager.h"
 #include "content/public/browser/browser_thread.h"
 #include "content/public/browser/notification_service.h"
 #include "content/public/browser/notification_types.h"
 #include "content/public/browser/render_frame_host.h"
 #include "content/public/browser/render_process_host.h"
 #include "content/public/browser/web_contents.h"
 #include "content/public/browser/web_ui.h"
 #include "media/base/audio_parameters.h"
 #include "media/base/media_log_event.h"
+#include "media/blink/watch_time_reporter.h"
 #include "media/filters/gpu_video_decoder.h"
 
 #if !defined(OS_ANDROID)
 #include "media/filters/decrypting_video_decoder.h"
 #endif
 
 namespace {
 
 static base::LazyInstance<content::MediaInternals>::Leaky g_media_internals =
     LAZY_INSTANCE_INITIALIZER;
@@ skipping 244 matching lines @@
   // Called when a render process is terminated. Reports the pipeline status to
   // UMA for every player associated with the renderer process and then deletes
   // the player state.
   void OnProcessTerminated(int render_process_id);
 
   // Helper function to save the event payload to RendererPlayerMap.
   void SavePlayerState(int render_process_id,
                        const media::MediaLogEvent& event);
 
  private:
+  struct WatchTimeInfo {
+    base::TimeDelta all_watch_time = media::kNoTimestamp;
+    base::TimeDelta mse_watch_time = media::kNoTimestamp;
+    base::TimeDelta eme_watch_time = media::kNoTimestamp;
+    base::TimeDelta src_watch_time = media::kNoTimestamp;
+    base::TimeDelta ac_watch_time = media::kNoTimestamp;
+    base::TimeDelta battery_watch_time = media::kNoTimestamp;
+  };
+
   struct PipelineInfo {
     bool has_pipeline = false;
     media::PipelineStatus last_pipeline_status = media::PIPELINE_OK;
     bool has_audio = false;
     bool has_video = false;
     bool video_dds = false;
     bool video_decoder_changed = false;
     std::string audio_codec_name;
     std::string video_codec_name;
     std::string video_decoder;
+    WatchTimeInfo watch_time_info;
   };
 
   // Helper function to report PipelineStatus associated with a player to UMA.
   void ReportUMAForPipelineStatus(const PipelineInfo& player_info);
 
   // Helper to generate PipelineStatus UMA name for AudioVideo streams.
   std::string GetUMANameForAVStream(const PipelineInfo& player_info);
 
+  // Saves the watch time info from |event| under |key| at |watch_time| if |key|
+  // is present in |event.params|.
+  void MaybeSaveWatchTime(const media::MediaLogEvent& event,
+                          const char* key,
+                          base::TimeDelta* watch_time) {
+    if (!event.params.HasKey(key))
+      return;
+
+    double in_seconds;
+    const bool result =
+        event.params.GetDoubleWithoutPathExpansion(key, &in_seconds);
+    DCHECK(result);
+    *watch_time = base::TimeDelta::FromSecondsD(in_seconds);
+
+    DVLOG(2) << "Saved watch time for " << key << " of " << *watch_time;
+  }
+
   // Key is player id.
   typedef std::map<int, PipelineInfo> PlayerInfoMap;
 
   // Key is renderer id.
   typedef std::map<int, PlayerInfoMap> RendererPlayerMap;
 
   // Stores player information per renderer.
   RendererPlayerMap renderer_info_;
 
   DISALLOW_COPY_AND_ASSIGN(MediaInternalsUMAHandler);
@@ skipping 42 matching lines @@
                                &player_info[event.id].video_decoder);
         if (!previous_video_decoder.empty() &&
             previous_video_decoder != player_info[event.id].video_decoder) {
           player_info[event.id].video_decoder_changed = true;
         }
       }
       if (event.params.HasKey("video_dds")) {
         event.params.GetBoolean("video_dds", &player_info[event.id].video_dds);
       }
       break;
+    case media::MediaLogEvent::Type::WATCH_TIME_UPDATE: {
+      DVLOG(2) << "Processing watch time update.";
+      WatchTimeInfo& wti = player_info[event.id].watch_time_info;
+      MaybeSaveWatchTime(event,
+                         media::WatchTimeReporter::kHistogramAudioVideoAll,
+                         &wti.all_watch_time);
+      MaybeSaveWatchTime(event,
+                         media::WatchTimeReporter::kHistogramAudioVideoMse,
+                         &wti.mse_watch_time);
+      MaybeSaveWatchTime(event,
+                         media::WatchTimeReporter::kHistogramAudioVideoEme,
+                         &wti.eme_watch_time);
+      MaybeSaveWatchTime(event,
+                         media::WatchTimeReporter::kHistogramAudioVideoSrc,
+                         &wti.src_watch_time);
+      MaybeSaveWatchTime(event,
+                         media::WatchTimeReporter::kHistogramAudioVideoBattery,
+                         &wti.battery_watch_time);
+      MaybeSaveWatchTime(event,
+                         media::WatchTimeReporter::kHistogramAudioVideoAc,
+                         &wti.ac_watch_time);
+      break;
+    }
     default:
       break;
   }
   return;
 }
 
 std::string MediaInternals::MediaInternalsUMAHandler::GetUMANameForAVStream(
     const PipelineInfo& player_info) {
   DCHECK_CURRENTLY_ON(BrowserThread::UI);
   static const char kPipelineUmaPrefix[] = "Media.PipelineStatus.AudioVideo.";
@@ skipping 57 matching lines @@
     UMA_HISTOGRAM_ENUMERATION("Media.PipelineStatus.Unsupported",
                               player_info.last_pipeline_status,
                               media::PIPELINE_STATUS_MAX + 1);
   }
   // Report whether video decoder fallback happened, but only if a video decoder
   // was reported.
   if (!player_info.video_decoder.empty()) {
     UMA_HISTOGRAM_BOOLEAN("Media.VideoDecoderFallback",
                           player_info.video_decoder_changed);
   }
+
+// Use a macro instead of a function so we can use the histogram macro (which
+// checks that the uma name is a static value).
+#define MAYBE_RECORD_WATCH_TIME(uma_name, watch_time)                  \
+  if (player_info.watch_time_info.watch_time != media::kNoTimestamp) { \
+    UMA_HISTOGRAM_LONG_TIMES(media::WatchTimeReporter::uma_name,       \
+                             player_info.watch_time_info.watch_time);  \
+  }
+
+  MAYBE_RECORD_WATCH_TIME(kHistogramAudioVideoAll, all_watch_time);
+  MAYBE_RECORD_WATCH_TIME(kHistogramAudioVideoMse, mse_watch_time);
+  MAYBE_RECORD_WATCH_TIME(kHistogramAudioVideoEme, eme_watch_time);
+  MAYBE_RECORD_WATCH_TIME(kHistogramAudioVideoSrc, src_watch_time);
+  MAYBE_RECORD_WATCH_TIME(kHistogramAudioVideoBattery, battery_watch_time);
+  MAYBE_RECORD_WATCH_TIME(kHistogramAudioVideoAc, ac_watch_time);
+#undef MAYBE_RECORD_WATCH_TIME
 }
 
 void MediaInternals::MediaInternalsUMAHandler::OnProcessTerminated(
     int render_process_id) {
   DCHECK_CURRENTLY_ON(BrowserThread::UI);
 
   auto players_it = renderer_info_.find(render_process_id);
   if (players_it == renderer_info_.end())
     return;
   auto it = players_it->second.begin();
@@ skipping 63 matching lines @@
 
   *update = SerializeUpdate("media.onMediaEvent", &dict);
   return true;
 }
 
 void MediaInternals::OnMediaEvents(
     int render_process_id, const std::vector<media::MediaLogEvent>& events) {
   DCHECK_CURRENTLY_ON(BrowserThread::UI);
   // Notify observers that |event| has occurred.
   for (const auto& event : events) {
-    if (CanUpdate()) {
-      base::string16 update;
-      if (ConvertEventToUpdate(render_process_id, event, &update))
-        SendUpdate(update);
+    // Some events should not be recorded in the UI.
+    if (event.type != media::MediaLogEvent::Type::WATCH_TIME_UPDATE) {
+      if (CanUpdate()) {
+        base::string16 update;
+        if (ConvertEventToUpdate(render_process_id, event, &update))
+          SendUpdate(update);
+      }
+      SaveEvent(render_process_id, event);
     }
-
-    SaveEvent(render_process_id, event);
     uma_handler_->SavePlayerState(render_process_id, event);
   }
 }
 
 void MediaInternals::AddUpdateCallback(const UpdateCallback& callback) {
   DCHECK_CURRENTLY_ON(BrowserThread::UI);
   update_callbacks_.push_back(callback);
 
   base::AutoLock auto_lock(lock_);
   can_update_ = true;
@@ skipping 156 matching lines @@
           audio_streams_cached_data_.GetDictionary(cache_key, &existing_dict));
       existing_dict->MergeDictionary(value);
     }
   }
 
   if (CanUpdate())
     SendUpdate(SerializeUpdate(function, value));
 }
 
 }  // namespace content