summaryrefslogtreecommitdiffstats
path: root/dom/media/nsIMediaManager.idl
blob: 68334b2e6af22c3b6d030ee992cbecf9fdc28845 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this file,
 * You can obtain one at http://mozilla.org/MPL/2.0/. */

#include "nsISupports.idl"

interface nsIArray;
interface nsIDOMWindow;
interface nsIMediaDevice;

[scriptable, builtinclass, uuid(24b23e01-33fd-401f-ba25-6e52658750b0)]
interface nsIMediaManagerService : nsISupports
{
  /* return a array of inner windows that have active captures */
  readonly attribute nsIArray activeMediaCaptureWindows;

  /* possible states for camera and microphone capture */
  const unsigned short STATE_NOCAPTURE = 0;
  const unsigned short STATE_CAPTURE_ENABLED = 1;
  const unsigned short STATE_CAPTURE_DISABLED = 2;

  /* Get the capture state for the given window. This will not check
   * descendants, such as iframes. Callers who need to check descendants should
   * iterate descendants manually and call this on each.
   */
  void mediaCaptureWindowState(in nsIDOMWindow aWindow,
                               out unsigned short aCamera,
                               out unsigned short aMicrophone,
                               out unsigned short aScreenShare,
                               out unsigned short aWindowShare,
                               out unsigned short aBrowserShare,
                               out Array<nsIMediaDevice> devices);

  /* Clear per-orgin list of persistent DeviceIds stored for enumerateDevices
     sinceTime is milliseconds since 1 January 1970 00:00:00 UTC. 0 = clear all */
  void sanitizeDeviceIds(in long long sinceWhen);
};