Add audible, muted to Tab, c.t.query, c.t.update, and c.t.onUpdated where relevant

chrome/common/extensions/api/tabs.json

 // 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.
 
 [
   {
     "namespace": "tabs",
     "description": "Use the <code>chrome.tabs</code> API to interact with the browser's tab system. You can use this API to create, modify, and rearrange tabs in the browser.",
     "types": [
       {
         "id": "Tab",
         "type": "object",
         "properties": {
           "id": {"type": "integer", "minimum": 0, "optional": true, "description": "The ID of the tab. Tab IDs are unique within a browser session. Under some circumstances a Tab may not be assigned an ID, for example when querying foreign tabs using the $(ref:sessions) API, in which case a session ID may be present."},
           // TODO(kalman): Investigate how this is ending up as -1 (based on window type? a bug?) and whether it should be optional instead.
           "index": {"type": "integer", "minimum": -1, "description": "The zero-based index of the tab within its window."},
           "windowId": {"type": "integer", "minimum": 0, "description": "The ID of the window the tab is contained within."},
           "openerTabId": {"type": "integer", "minimum": 0, "optional": true, "description": "The ID of the tab that opened this tab, if any. This property is only present if the opener tab still exists."},
           "selected": {"type": "boolean", "description": "Whether the tab is selected.", "deprecated": "Please use $(ref:tabs.Tab.highlighted)."},
           "highlighted": {"type": "boolean", "description": "Whether the tab is highlighted."},
           "active": {"type": "boolean", "description": "Whether the tab is active in its window. (Does not necessarily mean the window is focused.)"},
           "pinned": {"type": "boolean", "description": "Whether the tab is pinned."},
+          "audible": {"type": "boolean", "optional": true, "description": "Whether the tab is audible."},

[not at google - send to devlin, 2015/03/10 22:30:08]

Explain the difference between audible and muted, here and below.

[Jared Sohn, 2015/03/16 02:34:29]

Here is my new verbiage (feel free to give feedback for improving it.):

audible: Whether the tab has produced sound over the past couple of seconds (but
it might not be heard if also muted). Equivalent to whether the speaker audio
indicator is showing.

muted: Whether the tab is prevented from playing sound (but hasn't necessarily
recently produced sound). Equivalent to whether the muted audio indicator is
showing.

For now I have not altered the text for the other audible/muted parameters since
this way seems more consistent with the documentation for other properties such
as selected, highlighted, active, and pinned.

[not at google - send to devlin, 2015/03/16 17:47:08]

Perfect.
Perfect.
Thanks.

+          "muted": {"type": "boolean", "optional": true, "description": "Whether the tab is muted."},
           "url": {"type": "string", "optional": true, "description": "The URL the tab is displaying. This property is only present if the extension's manifest includes the <code>\"tabs\"</code> permission."},
           "title": {"type": "string", "optional": true, "optional": true, "description": "The title of the tab. This property is only present if the extension's manifest includes the <code>\"tabs\"</code> permission."},
           "favIconUrl": {"type": "string", "optional": true, "optional": true, "description": "The URL of the tab's favicon. This property is only present if the extension's manifest includes the <code>\"tabs\"</code> permission. It may also be an empty string if the tab is loading."},
           "status": {"type": "string", "optional": true, "description": "Either <em>loading</em> or <em>complete</em>."},
           "incognito": {"type": "boolean", "description": "Whether the tab is in an incognito window."},
           "width": {"type": "integer", "optional": true, "description": "The width of the tab in pixels."},
           "height": {"type": "integer", "optional": true, "description": "The height of the tab in pixels."},
           "sessionId": {"type": "string", "optional": true, "description": "The session ID used to uniquely identify a Tab obtained from the $(ref:sessions) API."}
         }
       },
@@ skipping 326 matching lines @@
               "active": {
                 "type": "boolean",
                 "optional": true,
                 "description": "Whether the tabs are active in their windows."
               },
               "pinned": {
                 "type": "boolean",
                 "optional": true,
                 "description": "Whether the tabs are pinned."
               },
+              "audible": {
+                "type": "boolean",
+                "optional": true,
+                "description": "Whether the tabs are audible."
+              },
+              "muted": {
+                "type": "boolean",
+                "optional": true,
+                "description": "Whether the tabs are muted."
+              },
               "highlighted": {
                 "type": "boolean",
                 "optional": true,
                 "description": "Whether the tabs are highlighted."
               },
               "currentWindow": {
                 "type": "boolean",
                 "optional": true,
                 "description": "Whether the tabs are in the <a href='windows#current-window'>current window</a>."
               },
@@ skipping 128 matching lines @@
                 "deprecated": "Please use <em>highlighted</em>.",
                 "type": "boolean",
                 "optional": true,
                 "description": "Whether the tab should be selected."
               },
               "pinned": {
                 "type": "boolean",
                 "optional": true,
                 "description": "Whether the tab should be pinned."
               },
+              "muted": {
+                "type": "boolean",
+                "optional": true,
+                "description": "Whether the tab should be muted."
+              },
               "openerTabId": {
                 "type": "integer",
                 "minimum": 0,
                 "optional": true,
                 "description": "The ID of the tab that opened this tab. If specified, the opener tab must be in the same window as this tab."
               }
             }
           },
           {
             "type": "function",
@@ skipping 327 matching lines @@
               "url": {
                 "type": "string",
                 "optional": true,
                 "description": "The tab's URL if it has changed."
               },
               "pinned": {
                 "type": "boolean",
                 "optional": true,
                 "description": "The tab's new pinned state."
               },
+              "audible": {
+                "type": "boolean",
+                "optional": true,
+                "description": "The tab's new audible state."
+              },
+              "muted": {
+                "type": "boolean",
+                "optional": true,
+                "description": "The tab's new muted state."
+              },
+              "cause": {

[not at google - send to devlin, 2015/03/10 22:30:08]

I'd rather "mutedCause" because this is muted specific.

[Jared Sohn, 2015/03/16 02:34:29]

I had been debating that; "cause" could be reused if also needed for another
onUpdated message, but perhaps the extra specificity makes this easier to think
about and also makes it more googleable.  Change made here and throughout the
rest of the patch.

+                "type": "string",
+                "optional": true,
+                "description": "When the muted state changes, indicates what caused it ('user', 'capture', or an extension id)."
+              },
               "favIconUrl": {
                 "type": "string",
                 "optional": true,
                 "description": "The tab's new favicon URL."
               }
             }
           },
           {
             "$ref": "Tab",
             "name": "tab",
@@ skipping 208 matching lines @@
             "tabId": {"type": "integer", "minimum": 0},
             "oldZoomFactor": {"type": "number"},
             "newZoomFactor": {"type": "number"},
             "zoomSettings": {"$ref": "ZoomSettings"}
           }
         }]
       }
     ]
   }
 ]