Desktop chrome tab capture-chooseDesktopMedia()

content/public/browser/web_contents_media_capture_id.h

+// Copyright (c) 2016 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.
+
+#ifndef CONTENT_PUBLIC_BROWSER_WEB_CONTENTS_MEDIA_CAPTURE_ID_H_
+#define CONTENT_PUBLIC_BROWSER_WEB_CONTENTS_MEDIA_CAPTURE_ID_H_
+
+#include <string>
+
+#include "content/common/content_export.h"
+
+namespace content {
+const char kWebContentsCaptureScheme[] = "web-contents-media-stream";
+
+struct CONTENT_EXPORT WebContentsMediaCaptureId {
+ public:
+  // Represents an "unset" value for either |render_process_id| or
+  // |main_render_frame_id|.
+  static const int kInvalidId = -1;
+
+  WebContentsMediaCaptureId() = default;
+  WebContentsMediaCaptureId(int render_process_id, int main_render_frame_id)
+      : render_process_id(render_process_id),
+        main_render_frame_id(main_render_frame_id) {}
+
+  WebContentsMediaCaptureId(int render_process_id,
+                            int main_render_frame_id,
+                            bool enable_auto_throttling)
+      : render_process_id(render_process_id),
+        main_render_frame_id(main_render_frame_id),
+        enable_auto_throttling(enable_auto_throttling) {}
+
+  bool operator<(const WebContentsMediaCaptureId& other) const;
+  bool operator==(const WebContentsMediaCaptureId& other) const;
+
+  // Return true if render_process_id or main_render_frame_id is invalid.
+  bool is_null() const;
+
+  std::string ToString() const;
+
+  // Tab video and audio capture need render process id and render frame id.
+  int render_process_id = kInvalidId;
+  int main_render_frame_id = kInvalidId;
+
+  bool enable_auto_throttling = false;
+
+  // Create WebContentsMediaCaptureId based on a string.
+  static WebContentsMediaCaptureId Parse(const std::string& str);
+
+  // Check whether the device id indicates that this is a web contents stream.
+  static bool IsWebContentsDeviceId(const std::string& device_id);
+
+  // Function to extract the target render frame id's from a media stream
+  // request's device id.
+  static bool ExtractTabCaptureTarget(const std::string& device_id,
+                                      int* render_process_id,
+                                      int* main_render_frame_id);
+
+  // Parses the media stream request |device_id| and returns true if both 1) the
+  // format is valid, and 2) the throttling option is set to auto.
+  static bool IsAutoThrottlingOptionSet(const std::string& device_id);
+};
+
+}  // namespace content
+
+#endif  // CONTENT_PUBLIC_BROWSER_WEB_CONTENTS_MEDIA_CAPTURE_ID_H_