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
83
84
85
86
87
88
89
|
// Copyright 2022 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef COMPONENTS_CAST_RECEIVER_BROWSER_PUBLIC_EMBEDDER_APPLICATION_H_
#define COMPONENTS_CAST_RECEIVER_BROWSER_PUBLIC_EMBEDDER_APPLICATION_H_
#include <memory>
#include <ostream>
#include <string>
#include <vector>
#include "base/functional/callback.h"
#include "components/cast_receiver/browser/public/runtime_application.h"
namespace content {
class WebContents;
} // namespace content
namespace cast_receiver {
class ContentWindowControls;
class MessagePortService;
class StreamingConfigManager;
// This class defines an interface to be implemented by embedders in order to
// allow a RuntimeApplication to interface with the embedder-specific details.
class EmbedderApplication {
public:
enum class ApplicationStopReason {
kUndefined = 0,
kApplicationRequest,
kIdleTimeout,
kUserRequest,
kHttpError,
kRuntimeError
};
virtual ~EmbedderApplication();
// Notifies the Cast agent that application has started.
virtual void NotifyApplicationStarted() = 0;
// Notifies the Cast agent that application has stopped.
virtual void NotifyApplicationStopped(ApplicationStopReason stop_reason,
int32_t net_error_code) = 0;
// Notifies the Cast agent about media playback state changed.
virtual void NotifyMediaPlaybackChanged(bool playing) = 0;
// Fetches all bindings asynchronously, calling |callback| with the results
// of this call once it returns.
using GetAllBindingsCallback =
base::OnceCallback<void(cast_receiver::Status, std::vector<std::string>)>;
virtual void GetAllBindings(GetAllBindingsCallback callback) = 0;
// Gets the platform-specific MessagePortService instance for this
// application, if such an instance exists.
virtual MessagePortService* GetMessagePortService() = 0;
// Returns the WebContents this application should use.
//
// TODO(crbug.com/1382907): Change to a callback-based API.
virtual content::WebContents* GetWebContents() = 0;
// Returns the window controls for this instance.
//
// TODO(crbug.com/1382907): Change to a callback-based API.
virtual ContentWindowControls* GetContentWindowControls() = 0;
// Returns the StreamingConfigManager to use for configuring a Cast Streaming
// session. The default implementation returns a ReceiverConfig only
// detailing the codec support as defined by the build flags.
//
// TODO(crbug.com/1382907): Change to a callback-based API.
// TODO(crbug.com/1359568): Change default implementation to be based on
// Chromium state.
virtual StreamingConfigManager* GetStreamingConfigManager();
// Loads |url| in the associated WebContents.
virtual void NavigateToPage(const GURL& url);
};
std::ostream& operator<<(std::ostream& os,
EmbedderApplication::ApplicationStopReason reason);
} // namespace cast_receiver
#endif // COMPONENTS_CAST_RECEIVER_BROWSER_PUBLIC_EMBEDDER_APPLICATION_H_
|
