Make tab audible and muted states and cause available for an extension API

chrome/browser/ui/tabs/tab_utils.h

Index: chrome/browser/ui/tabs/tab_utils.h
diff --git a/chrome/browser/ui/tabs/tab_utils.h b/chrome/browser/ui/tabs/tab_utils.h
index 4480a41609f149cbc48f01466975e4358718eaa5..4f8aa93ebb76a63f1c086170ae56ab2bdd6edb1d 100644
--- a/chrome/browser/ui/tabs/tab_utils.h
+++ b/chrome/browser/ui/tabs/tab_utils.h
@@ -5,10 +5,12 @@
 #ifndef CHROME_BROWSER_UI_TABS_TAB_UTILS_H_
 #define CHROME_BROWSER_UI_TABS_TAB_UTILS_H_
 
+#include <string>
 #include <vector>
 
 #include "base/memory/scoped_ptr.h"
 #include "base/strings/string16.h"
+#include "content/public/browser/web_contents_user_data.h"
 
 class TabStripModel;
 
@@ -33,6 +35,11 @@ enum TabMediaState {
 
 namespace chrome {
 
+// String to indicate reason for muted state change (user, capture, extension
+// id, or empty string)
+const char kMutedToggleCauseUser[] = "user";

[miu, 2015/02/19 20:02:44]

These should be in tab_utils.cc.  Then, declare them in the header file here as:

  extern const char kMutedToggleCauseUser[];
  extern const char kMutedToggleCauseCapture[];

See the following for examples of how this works:
https://code.google.com/p/chromium/codesearch#chromium/src/chrome/common/chro...

+const char kMutedToggleCauseCapture[] = "auto-forced for capture";
+
 // Logic to determine which components (i.e., close button, favicon, and media
 // indicator) of a tab should be shown, given current state.  |capacity|
 // specifies how many components can be shown, given available tab width.
@@ -99,7 +106,12 @@ bool CanToggleAudioMute(content::WebContents* contents);
 
 // Indicates/Sets whether all audio output from |contents| is muted.
 bool IsTabAudioMuted(content::WebContents* contents);
-void SetTabAudioMuted(content::WebContents* contents, bool mute);
+void SetTabAudioMuted(content::WebContents* contents,
+                      bool mute,
+                      const std::string& cause);
+
+// Get cause of mute (extensionid, kMutedToggleCause constant, or empty string)
+const std::string& GetTabAudioMutedCause(content::WebContents* contents);
 
 // Returns true if the tabs at the |indices| in |tab_strip| are all muted.
 bool AreAllTabsMuted(const TabStripModel& tab_strip,