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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
|
// Copyright (c) 2012 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.
#ifndef CONTENT_PUBLIC_BROWSER_BROWSER_PPAPI_HOST_H_
#define CONTENT_PUBLIC_BROWSER_BROWSER_PPAPI_HOST_H_
#include "base/callback_forward.h"
#include "base/process/process.h"
#include "content/common/content_export.h"
#include "content/public/browser/render_view_host.h"
#include "ppapi/c/pp_instance.h"
#include "url/gurl.h"
namespace IPC {
class ChannelProxy;
struct ChannelHandle;
class Sender;
}
namespace ppapi {
class PpapiPermissions;
namespace host {
class PpapiHost;
}
}
namespace content {
// Interface that allows components in the embedder app to talk to the
// PpapiHost in the browser process.
//
// There will be one of these objects in the browser per plugin process. It
// lives entirely on the I/O thread.
class CONTENT_EXPORT BrowserPpapiHost {
public:
struct OnKeepaliveInstanceStruct {
int render_process_id;
int render_view_id;
GURL document_url;
};
typedef std::vector<OnKeepaliveInstanceStruct> OnKeepaliveInstanceData;
typedef base::Callback<
void (const OnKeepaliveInstanceData& instance_data,
const base::FilePath& profile_data_directory)>
OnKeepaliveCallback;
// Creates a browser host and sets up an out-of-process proxy for an external
// pepper plugin process.
static BrowserPpapiHost* CreateExternalPluginProcess(
IPC::Sender* sender,
ppapi::PpapiPermissions permissions,
base::ProcessHandle plugin_child_process,
IPC::ChannelProxy* channel,
int render_process_id,
int render_view_id,
const base::FilePath& profile_directory);
virtual ~BrowserPpapiHost() {}
// Returns the PpapiHost object.
virtual ppapi::host::PpapiHost* GetPpapiHost() = 0;
// Returns the handle to the plugin process.
virtual base::ProcessHandle GetPluginProcessHandle() const = 0;
// Returns true if the given PP_Instance is valid.
virtual bool IsValidInstance(PP_Instance instance) const = 0;
// Retrieves the process/view Ids associated with the RenderView containing
// the given instance and returns true on success. If the instance is
// invalid, the ids will be 0 and false will be returned.
//
// When a resource is created, the PP_Instance should already have been
// validated, and the resource hosts will be deleted when the resource is
// destroyed. So it should not generally be necessary to check for errors
// from this function except as a last-minute sanity check if you convert the
// IDs to a RenderView/ProcessHost on the UI thread.
virtual bool GetRenderViewIDsForInstance(PP_Instance instance,
int* render_process_id,
int* render_view_id) const = 0;
// Returns the name of the plugin.
virtual const std::string& GetPluginName() = 0;
// Returns the path of the plugin.
virtual const base::FilePath& GetPluginPath() = 0;
// Returns the user's profile data directory.
virtual const base::FilePath& GetProfileDataDirectory() = 0;
// Get the Document/Plugin URLs for the given PP_Instance.
virtual GURL GetDocumentURLForInstance(PP_Instance instance) = 0;
virtual GURL GetPluginURLForInstance(PP_Instance instance) = 0;
// Sets a callback the BrowserPpapiHost will run when the plugin messages
// that it is active.
virtual void SetOnKeepaliveCallback(const OnKeepaliveCallback& callback) = 0;
};
} // namespace content
#endif // CONTENT_PUBLIC_BROWSER_BROWSER_PPAPI_HOST_H_
|
