chromium/extensions/browser/api/media_perception_private/media_perception_api_delegate.h

// Copyright 2017 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef EXTENSIONS_BROWSER_API_MEDIA_PERCEPTION_PRIVATE_MEDIA_PERCEPTION_API_DELEGATE_H_
#define EXTENSIONS_BROWSER_API_MEDIA_PERCEPTION_PRIVATE_MEDIA_PERCEPTION_API_DELEGATE_H_

#include "base/files/file_path.h"
#include "base/functional/callback.h"
#include "chromeos/services/media_perception/public/mojom/media_perception_service.mojom.h"
#include "extensions/common/api/media_perception_private.h"
#include "mojo/public/cpp/bindings/pending_receiver.h"
#include "services/video_capture/public/mojom/video_source_provider.mojom.h"

namespace content {

class RenderFrameHost;

}  //  namespace content

namespace extensions {

class MediaPerceptionAPIDelegate {
 public:
  // Callback for loading a CrOS component. |mount_point| will contain a path to
  // the loaded component, if |success| is true (installation succeeded).
  using LoadCrOSComponentCallback = base::OnceCallback<void(
      const api::media_perception_private::ComponentInstallationError
          installation_error,
      const base::FilePath& mount_point)>;

  using MediaPerceptionRequestHandler = base::RepeatingCallback<void(
      mojo::PendingReceiver<chromeos::media_perception::mojom::MediaPerception>
          receiver)>;

  virtual ~MediaPerceptionAPIDelegate() {}

  // Provides an interface through which a media analytics Chrome OS component
  // from Component Updater can be loaded and mounted on a device.
  virtual void LoadCrOSComponent(
      const api::media_perception_private::ComponentType& type,
      LoadCrOSComponentCallback load_callback) = 0;

  // Provides an interface to the Video Capture service (started lazily by the
  // browser) to connect the MediaPerceptionService to it and establish a direct
  // Mojo IPC-based connection.
  virtual void BindVideoSourceProvider(
      mojo::PendingReceiver<video_capture::mojom::VideoSourceProvider>
          receiver) = 0;

  // Provides an interface to set a handler for an incoming
  // MediaPerceptionRequest.
  virtual void SetMediaPerceptionRequestHandler(
      MediaPerceptionRequestHandler handler) = 0;

  // Receives an incoming media perception receiver and forwards it to the
  // receiver handler if set.
  virtual void ForwardMediaPerceptionReceiver(
      content::RenderFrameHost* render_frame_host,
      mojo::PendingReceiver<chromeos::media_perception::mojom::MediaPerception>
          receiver) = 0;
};

}  // namespace extensions

#endif  // EXTENSIONS_BROWSER_API_MEDIA_PERCEPTION_PRIVATE_MEDIA_PERCEPTION_API_DELEGATE_H_