1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
content / public / browser / picture_in_picture_window_controller.h [blame]
// 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 CONTENT_PUBLIC_BROWSER_PICTURE_IN_PICTURE_WINDOW_CONTROLLER_H_
#define CONTENT_PUBLIC_BROWSER_PICTURE_IN_PICTURE_WINDOW_CONTROLLER_H_
#include <optional>
#include "build/build_config.h"
#include "content/common/content_export.h"
#include "ui/gfx/geometry/rect.h"
#include "url/origin.h"
namespace content {
class WebContents;
#if !BUILDFLAG(IS_ANDROID)
class DocumentPictureInPictureWindowController;
#endif // !BUILDFLAG(IS_ANDROID)
class VideoPictureInPictureWindowController;
// Interface for Picture in Picture window controllers. This is currently tied
// to a WebContents |web_contents| and created when a Picture in Picture window
// is to be shown. This allows creation of a single window for the WebContents
// WebContents.
class PictureInPictureWindowController {
public:
// Gets a reference to the controller of the appropriate type associated with
// |web_contents| and creates one if it does not exist. If there is an
// existing controller, it is reused if it's of the correct type, but is
// recreated if the existing instance was for a different type. The returned
// pointer is guaranteed to be non-null.
CONTENT_EXPORT static VideoPictureInPictureWindowController*
GetOrCreateVideoPictureInPictureController(WebContents* web_contents);
#if !BUILDFLAG(IS_ANDROID)
CONTENT_EXPORT static DocumentPictureInPictureWindowController*
GetOrCreateDocumentPictureInPictureController(WebContents* web_contents);
#endif // !BUILDFLAG(IS_ANDROID)
virtual ~PictureInPictureWindowController() = default;
// Shows the Picture-in-Picture window.
virtual void Show() = 0;
// Called to notify the controller that initiator should be focused.
virtual void FocusInitiator() = 0;
// Called to notify the controller that the window was requested to be closed
// by the user or the content.
virtual void Close(bool should_pause_video) = 0;
// Called to notify the controller that the window was requested to be closed
// by the content and that initiator should be focused.
virtual void CloseAndFocusInitiator() = 0;
// Called by the window implementation to notify the controller that the
// window was requested to be closed and destroyed by the system.
virtual void OnWindowDestroyed(bool should_pause_video) = 0;
// Called to get the opener web contents for video or document PiP.
virtual WebContents* GetWebContents() = 0;
// Called to get the Picture-in-Picture window bounds.
virtual std::optional<gfx::Rect> GetWindowBounds() = 0;
// Called to get the child web contents to be PiP for document PiP. This will
// be null for video PiP.
virtual WebContents* GetChildWebContents() = 0;
// Called to get the origin of the initiator. This will return `std::nullopt`
// except for video PiP.
virtual std::optional<url::Origin> GetOrigin() = 0;
protected:
// Use PictureInPictureWindowController::GetOrCreateForWebContents() to
// create an instance.
PictureInPictureWindowController() = default;
};
} // namespace content
#endif // CONTENT_PUBLIC_BROWSER_PICTURE_IN_PICTURE_WINDOW_CONTROLLER_H_