text: /*
   * Copyright (C) 2011 Ericsson AB. All rights reserved.
   *
   * Redistribution and use in source and binary forms, with or without
   * modification, are permitted provided that the following conditions
   * are met:
   *
   * 1. Redistributions of source code must retain the above copyright
   *    notice, this list of conditions and the following disclaimer.
   * 2. Redistributions in binary form must reproduce the above copyright
   *    notice, this list of conditions and the following disclaimer
   *    in the documentation and/or other materials provided with the
   *    distribution.
   * 3. Neither the name of Ericsson nor the names of its contributors
   *    may be used to endorse or promote products derived from this
   *    software without specific prior written permission.
   *
   * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
   * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
   * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
   * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
   * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
   * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
   * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
   * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
   * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
   * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
   * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
   */
  
  #ifndef THIRD_PARTY_BLINK_RENDERER_MODULES_MEDIASTREAM_USER_MEDIA_REQUEST_H_
  #define THIRD_PARTY_BLINK_RENDERER_MODULES_MEDIASTREAM_USER_MEDIA_REQUEST_H_
  
  #include "third_party/blink/renderer/bindings/modules/v8/v8_navigator_user_media_error_callback.h"
  #include "third_party/blink/renderer/bindings/modules/v8/v8_navigator_user_media_success_callback.h"
  #include "third_party/blink/renderer/core/execution_context/execution_context_lifecycle_observer.h"
  #include "third_party/blink/renderer/modules/modules_export.h"
  #include "third_party/blink/renderer/platform/mediastream/media_constraints.h"
  #include "third_party/blink/renderer/platform/mediastream/media_stream_source.h"
  #include "third_party/blink/renderer/platform/wtf/forward.h"
  
  namespace blink {
  
  class LocalDOMWindow;
  class MediaErrorState;
  class MediaStreamConstraints;
  class MediaStreamDescriptor;
  class UserMediaController;
  
  class MODULES_EXPORT UserMediaRequest final
      : public GarbageCollected<UserMediaRequest>,
        public ExecutionContextLifecycleObserver {
    USING_GARBAGE_COLLECTED_MIXIN(UserMediaRequest);
  
   public:
    enum class Error {
      kNotSupported,
      kSecurityError,
      kPermissionDenied,
      kPermissionDismissed,
      kInvalidState,
      kDevicesNotFound,
      kTabCapture,
      kScreenCapture,
      kCapture,
      kTrackStart,
      kFailedDueToShutdown,
      kKillSwitchOn,
      kSystemPermissionDenied
    };
  
    enum class MediaType {
      kUserMedia,
      kDisplayMedia,
    };
  
    class Callbacks : public GarbageCollected<Callbacks> {
     public:
      virtual ~Callbacks() = default;
  
      virtual void OnSuccess(ScriptWrappable* callback_this_value,
                             MediaStream*) = 0;
      virtual void OnError(ScriptWrappable* callback_this_value,
                           DOMExceptionOrOverconstrainedError) = 0;
  
      virtual void Trace(Visitor*) const {}
  
     protected:
      Callbacks() = default;
    };
  
    class V8Callbacks;
  
    static UserMediaRequest* Create(ExecutionContext*,
                                    UserMediaController*,
                                    MediaType media_type,
                                    const MediaStreamConstraints* options,
                                    Callbacks*,
                                    MediaErrorState&);
    static UserMediaRequest* Create(ExecutionContext*,
                                    UserMediaController*,
                                    const MediaStreamConstraints* options,
                                    V8NavigatorUserMediaSuccessCallback*,
                                    V8NavigatorUserMediaErrorCallback*,
                                    MediaErrorState&);
    static UserMediaRequest* CreateForTesting(const MediaConstraints& audio,
                                              const MediaConstraints& video);
  
    UserMediaRequest(ExecutionContext*,
                     UserMediaController*,
                     MediaType media_type,
                     MediaConstraints audio,
                     MediaConstraints video,
                     Callbacks*);
    virtual ~UserMediaRequest();
  
    LocalDOMWindow* GetWindow();
  
    void Start();
  
    void Succeed(MediaStreamDescriptor*, bool pan_tilt_zoom_allowed);
    void FailConstraint(const String& constraint_name, const String& message);
    void Fail(Error name, const String& message);
  
    MediaType MediaRequestType() const;
    bool Audio() const;
    bool Video() const;
    MediaConstraints AudioConstraints() const;
    MediaConstraints VideoConstraints() const;
  
    // Flag tied to whether or not the similarly named Origin Trial is
    // enabled. Will be removed at end of trial. See: http://crbug.com/789152.
    bool ShouldDisableHardwareNoiseSuppression() const;
  
    // errorMessage is only set if requestIsPrivilegedContext() returns |false|.
    // Caller is responsible for properly setting errors and canceling request.
    bool IsSecureContextUse(String& error_message);
  
    // ExecutionContextLifecycleObserver
    void ContextDestroyed() override;
  
    void set_request_id(int id) { request_id_ = id; }
    int request_id() { return request_id_; }
  
    void set_has_transient_user_activation(bool value) {
      has_transient_user_activation_ = value;
    }
    bool has_transient_user_activation() const {
      return has_transient_user_activation_;
    }
  
    void Trace(Visitor*) const override;
  
   private:
    MediaType media_type_;
    MediaConstraints audio_;
    MediaConstraints video_;
    bool should_disable_hardware_noise_suppression_;
    bool has_transient_user_activation_ = false;
    int request_id_ = -1;
  
    Member<UserMediaController> controller_;
  
    Member<Callbacks> callbacks_;
    bool is_resolved_ = false;
  };
  
  }  // namespace blink
  
  #endif  // THIRD_PARTY_BLINK_RENDERER_MODULES_MEDIASTREAM_USER_MEDIA_REQUEST_H_
  