Add user actions to record media controls interaction.

tools/metrics/actions/actions.xml

 <!--
 Copyright 2014 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.
 -->
 
 <!--
 This file is a comprehensive list of Chrome user actions along with the owner
 and description for each user action. A user action should be tied to an actual
 action taken by a user. It should be logged immediately after a user takes the
@@ skipping 7817 matching lines @@
 <action name="Media.Audible.AddTab">
   <owner>mlamouri@chromium.org</owner>
   <description>A tab became audible.</description>
 </action>
 
 <action name="Media.Audible.RemoveTab">
   <owner>mlamouri@chromium.org</owner>
   <description>A tab is no longer audible.</description>
 </action>
 
+<action name="Media.Controls.Cast">
+  <owner>mlamouri@chromium.org</owner>
+  <description>The user clicked on the cast controls button.</description>
+</action>
+
+<action name="Media.Controls.CastOverlay">
+  <owner>mlamouri@chromium.org</owner>
+  <description>The user clicked on the cast overlay button.</description>
+</action>
+
+<action name="Media.Controls.ClosedCaptionHide">
+  <owner>mlamouri@chromium.org</owner>
+  <description>The user hide the closed caption from the controls.</description>

[Ilya Sherman, 2016/04/13 19:12:12]

nit: s/hide/hid, or possibly "chose to hide" or something like that.

[mlamouri (slow - plz ping), 2016/04/14 15:46:30]

Went with "hid". It's short and clear enough IMO.

+</action>
+
+<action name="Media.Controls.ClosedCaptionShow">
+  <owner>Please list the metric's owners. Add more owner tags as needed.</owner>
+  <description>Please enter the description of the metric.</description>

[Ilya Sherman, 2016/04/13 19:12:13]

Please update :)

[mlamouri (slow - plz ping), 2016/04/14 15:46:30]

That's really odd. I wonder if it was auto-generated because of the typo below.

+</action>
+
+<action name="Media.Controls.ClosedCoptionShow">

[Ilya Sherman, 2016/04/13 19:12:13]

nit: typo -- please merge this into the above.

[mlamouri (slow - plz ping), 2016/04/14 15:46:31]

Done.

+  <owner>mlamouri@chromium.org</owner>
+  <description>
+    The user showed the closed caption from the controls.
+  </description>
+</action>
+
+<action name="Media.Controls.EnterFullscreen">
+  <owner>mlamouri@chromium.org</owner>
+  <description>The user entered fullscreen mode for the controls.</description>

[Ilya Sherman, 2016/04/13 19:12:12]

nit: Did you mean "from the controls"?

[mlamouri (slow - plz ping), 2016/04/14 15:46:31]

Yes :)

+</action>
+
+<action name="Media.Controls.ExitFullscreen">
+  <owner>mlamouri@chromium.org</owner>
+  <description>The user left fullscreen mode for the controls.</description>

[Ilya Sherman, 2016/04/13 19:12:13]

nit: Did you mean "from the controls"?

[mlamouri (slow - plz ping), 2016/04/14 15:46:30]

Did you mean I'm abusing copy-paste? :)

+</action>
+
+<action name="Media.Controls.Mute">
+  <owner>mlamouri@chromium.org</owner>
+  <description>The user muted a media from the controls.</description>

[Ilya Sherman, 2016/04/13 19:12:13]

nit: "a media" -> "a media element" (here and throughout the file)

[mlamouri (slow - plz ping), 2016/04/14 15:46:30]

Done.

+</action>
+
+<action name="Media.Controls.Pause">
+  <owner>mlamouri@chromium.org</owner>
+  <description>The user paused a media from the controls.</description>
+</action>
+
+<action name="Media.Controls.Play">
+  <owner>mlamouri@chromium.org</owner>
+  <description>The user played a media from the controls.</description>
+</action>
+
+<action name="Media.Controls.PlayOverlay">
+  <owner>mlamouri@chromium.org</owner>
+  <description>
+    The user played a media from the play overlay button.
+  </description>
+</action>
+
+<action name="Media.Controls.ScrubbingBegin">
+  <owner>mlamouri@chromium.org</owner>
+  <description>
+    The user started to interact with the control's scrubber.
+  </description>
+</action>
+
+<action name="Media.Controls.ScrubbingEnd">

[Ilya Sherman, 2016/04/13 19:12:12]

I'm not sure that you'll really get much value from separating out scrubbing
begin vs. end, but you're welcome to try if you think it'd be useful.

[mlamouri (slow - plz ping), 2016/04/14 15:46:30]

As said above, I think the time it takes to scrub might correlate with how hard
it is to actually succeed.

[Ilya Sherman, 2016/04/14 20:41:26]

That might be true, but how do you plan to view that time?  The dashboards don't
make duration data very easy to view for user actions, though you could write
custom Dremel queries.  If you're not planning to write the Dremel queries, then
I'd expect the Begin/End split won't give you much actionable data.

+  <owner>mlamouri@chromium.org</owner>
+  <description>
+    The user stopped interacting with the control's scrubber.
+  </description>
+</action>
+
+<action name="Media.Controls.Unmute">
+  <owner>mlamouri@chromium.org</owner>
+  <description>The user unmuted a media from the controls.</description>
+</action>
+
+<action name="Media.Controls.VolumeChangeBegin">
+  <owner>mlamouri@chromium.org</owner>
+  <description>
+    The user started to interact with the control's volume slider.
+  </description>
+</action>
+
+<action name="Media.Controls.VolumeChangeEnd">

[Ilya Sherman, 2016/04/13 19:12:12]

Ditto.

[mlamouri (slow - plz ping), 2016/04/14 15:46:30]

As said above, that one is mostly completeness and consistency.

+  <owner>mlamouri@chromium.org</owner>
+  <description>
+    The user stopped interacting with the control's volume slider.
+  </description>
+</action>
+
 <action name="MediaContextMenu_Controls">
   <owner>Please list the metric's owners. Add more owner tags as needed.</owner>
   <description>Please enter the description of this user action.</description>
 </action>
 
 <action name="MediaContextMenu_Loop">
   <owner>Please list the metric's owners. Add more owner tags as needed.</owner>
   <description>Please enter the description of this user action.</description>
 </action>
 
@@ skipping 6334 matching lines @@
 <action name="webapps.AddShortcut.Manifest">
   <owner>mlamouri@chromium.org</owner>
   <description>
     Shortcut added to the homescreen with a valid Manifest. This action will be
     recorded in addition to AppShortcut, AppShortcutApple and Bookmark actions
     to keep a trend of whether the webapp also add meta tags.
   </description>
 </action>
 
 </actions>