blob: ed9eb6a76d456430da54ad9fbc568a11990a8ffd [file] [log] [blame]
// Copyright 2018 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.
#include "content/common/content_export.h"
class GURL;
namespace content {
enum DesktopStreamRegistryType {
struct DesktopMediaID;
// Interface to DesktopStreamsRegistry which is used to store accepted desktop
// media streams for Desktop/Tab Capture API. Single instance of this class is
// created at first time use. This should be called on UI thread.
class CONTENT_EXPORT DesktopStreamsRegistry {
virtual ~DesktopStreamsRegistry() {}
static DesktopStreamsRegistry* GetInstance();
// Adds new stream to the registry. Called by the implementation of either
// desktopCapture API or tabCapture API, differentiated by |type|, after user
// has approved access to |source| for the |origin|. Returns identifier of
// the new stream.
// |render_frame_id| refers to the RenderFrame requesting the stream.
virtual std::string RegisterStream(int render_process_id,
int render_frame_id,
const GURL& origin,
const DesktopMediaID& source,
const std::string& extension_name,
const DesktopStreamRegistryType type) = 0;
// Validates stream identifier specified in getUserMedia(). Returns null
// DesktopMediaID if the specified |id| is invalid, i.e. wasn't generated
// using RegisterStream() or if it was generated for a different
// RenderFrame/origin/type. Otherwise returns ID of the source and removes it
// from the registry.
virtual DesktopMediaID RequestMediaForStreamId(
const std::string& id,
int render_process_id,
int render_frame_id,
const GURL& origin,
std::string* extension_name,
const DesktopStreamRegistryType type) = 0;
} // namespace content