@nextcloud/dialogs
    Preparing search index...

    Interface MediaDevices

    The MediaDevices interface of the Media Capture and Streams API provides access to connected media input devices like cameras and microphones, as well as screen sharing. Available only in secure contexts.

    MDN Reference

    interface MediaDevices {
        ondevicechange: ((this: MediaDevices, ev: Event) => any) | null;
        addEventListener<K extends "devicechange">(
            type: K,
            listener: (this: MediaDevices, ev: MediaDevicesEventMap[K]) => any,
            options?: boolean | AddEventListenerOptions,
        ): void;
        addEventListener(
            type: string,
            listener: EventListenerOrEventListenerObject,
            options?: boolean | AddEventListenerOptions,
        ): void;
        dispatchEvent(event: Event): boolean;
        enumerateDevices(): Promise<MediaDeviceInfo[]>;
        getDisplayMedia(options?: DisplayMediaStreamOptions): Promise<MediaStream>;
        getSupportedConstraints(): MediaTrackSupportedConstraints;
        getUserMedia(constraints?: MediaStreamConstraints): Promise<MediaStream>;
        removeEventListener<K extends "devicechange">(
            type: K,
            listener: (this: MediaDevices, ev: MediaDevicesEventMap[K]) => any,
            options?: boolean | EventListenerOptions,
        ): void;
        removeEventListener(
            type: string,
            listener: EventListenerOrEventListenerObject,
            options?: boolean | EventListenerOptions,
        ): void;
    }

    Hierarchy (View Summary)

    Index
    ondevicechange
    addEventListener dispatchEvent enumerateDevices getDisplayMedia getSupportedConstraints getUserMedia removeEventListener
    ondevicechange: ((this: MediaDevices, ev: Event) => any) | null

    MDN Reference

    • The dispatchEvent() method of the EventTarget sends an Event to the object, (synchronously) invoking the affected event listeners in the appropriate order.

      MDN Reference

      Parameters

      Returns boolean

    • The enumerateDevices() method of the MediaDevices interface requests a list of the currently available media input and output devices, such as microphones, cameras, headsets, and so forth.

      MDN Reference

      Returns Promise<MediaDeviceInfo[]>

    • The getDisplayMedia() method of the MediaDevices interface prompts the user to select and grant permission to capture the contents of a display or portion thereof (such as a window) as a MediaStream.

      MDN Reference

      Parameters

      Returns Promise<MediaStream>

    • The getSupportedConstraints() method of the MediaDevices interface returns an object based on the MediaTrackSupportedConstraints dictionary, whose member fields each specify one of the constrainable properties the user agent understands.

      MDN Reference

      Returns MediaTrackSupportedConstraints

    • The getUserMedia() method of the MediaDevices interface prompts the user for permission to use a media input which produces a MediaStream with tracks containing the requested types of media.

      MDN Reference

      Parameters

      Returns Promise<MediaStream>

    Settings
    Member Visibility

    On This Page
    Properties
    Methods