This directory contains helper classes to embed a Window.

RemoteViewProvider

RemoteViewProvider wraps the work needed to provide a Window to another (remote) client. Typical usage is to create an instance of it with the window to provide to the remote client.

e.g.

  ...

  // Step 1: Prepares for embedding after |window_for_remote_client_| is ready.
  void StartEmbed() {
    remote_view_provider_ =
        std::make_unique<views::RemoteViewProvider>(window_for_remote_client_);
    remote_view_client->GetEmbedToken(base::BindOnce(
        &EmbeddedClient::OnGotEmbedToken, base::Unretained(this)));
  }

  void OnGotEmbedToken(const base::UnguessableToken& token) {
    // Step 2: Pass |token| to the embedder.
  }

  // A Window to to provide to the remote client.
  aura::Window* window_for_remote_client_;

  // Helper to prepare |window_for_remote_client_| for embedding.
  std::unique_ptr<views::RemoteViewProvider> remote_view_provider_;

  ...

RemoteViewHost

RemoteViewHost wraps the work on the embedder side and is a NativeViewHost that embeds the window from the RemoteViewProvider. RemoveViewHost is a View that you add to your existing View hierarchy.

e.g.

  class EmbedderView : public views::View {
   public:
    ...
    // Creates a RemoteViewHost using |token| from the embedded client.
    void AddEmbeddedView(const base::UnguessableToken& token) {
      // Ownership will be passed to the view hierarchy in AddChildView.
      views::RemoteViewHost* remote_view_host = new RemoteViewHost();
      remote_view_host->EmbedUsingToken(token, base::DoNothing());
      AddChildView(remote_view_host);
    }
    ...
  };