Desktop Capture API: Pass Audio Selection Information To Javascript

chrome/common/extensions/api/desktop_capture.json

 // 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.
 
 [
   {
     "namespace": "desktopCapture",
     "description": "Desktop Capture API that can be used to capture content of screen, individual windows or tabs.",
     "types": [
       {
@@ skipping 22 matching lines @@
             "description": "Optional tab for which the stream is created. If not specified then the resulting stream can be used only by the calling extension. The stream can only be used by frames in the given tab whose security origin matches <code>tab.url</code>."
           },
           {
             "type": "function",
             "name": "callback",
             "parameters": [
               {
                 "name": "streamId",
                 "type": "string",
                 "description": "An opaque string that can be passed to <code>getUserMedia()</code> API to generate media stream that corresponds to the source selected by the user. If user didn't select any source (i.e. canceled the prompt) then the callback is called with an empty <code>streamId</code>. The created <code>streamId</code> can be used only once and expires after a few seconds when it is not used."
+              },
+              {
+                "name": "options",
+                "type": "object",
+                "description": "Contains properties that describe the stream.",
+                "properties": {
+                   "can_request_audio_track": {

[Devlin, 2016/12/13 16:05:44]

Variables here should be JS-style, so canRequestAudioTrack. Though this might
just make more sense as "audioAllowed" or something.

[qiangchen, 2016/12/13 19:04:32]

Done.

+                     "type": "boolean",
+                     "description": "True if audio track is well generated. Otherwise false, and in this case, one should not ask for audio stream through getUserMedia call."

[Devlin, 2016/12/13 16:05:44]

What does "well generated" mean? From the bug/description, I thought this was if
the user unchecked a box, rather than chrome being unable to generate it?

[qiangchen, 2016/12/13 19:04:32]

Done. Changed to describing what happened in the foreground that JS developer
must be familiar with, rather than describing what happened behind the scenes.

+                   } 
+                }
               }
             ]
           }
         ],
         "returns": {
           "type": "integer",
           "description": "An id that can be passed to cancelChooseDesktopMedia() in case the prompt need to be canceled."
         }
       },
       {
         "name": "cancelChooseDesktopMedia",
         "type": "function",
         "description": "Hides desktop media picker dialog shown by chooseDesktopMedia().",
         "parameters": [
           {
             "name": "desktopMediaRequestId",
             "type": "integer",
             "description": "Id returned by chooseDesktopMedia()"
           }
         ]
       }
     ]
   }
 ]