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
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
|
// 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_RENDERER_PEPPER_PLUGIN_DELEGATE_H_
#define CONTENT_RENDERER_PEPPER_PLUGIN_DELEGATE_H_
#include <string>
#include <vector>
#include "base/callback.h"
#include "base/memory/ref_counted.h"
#include "base/memory/shared_memory.h"
#include "base/message_loop/message_loop_proxy.h"
#include "base/platform_file.h"
#include "base/process/process.h"
#include "base/time/time.h"
#include "content/common/content_export.h"
#include "ipc/ipc_platform_file.h"
#include "ppapi/c/dev/pp_video_dev.h"
#include "ppapi/c/pp_completion_callback.h"
#include "ppapi/c/pp_errors.h"
#include "ppapi/c/pp_file_info.h"
#include "ppapi/c/pp_instance.h"
#include "ppapi/c/pp_resource.h"
#include "ppapi/c/pp_stdint.h"
#include "ppapi/c/ppb_tcp_socket.h"
#include "ppapi/c/private/ppb_flash.h"
#include "ppapi/c/private/ppb_tcp_socket_private.h"
#include "ppapi/c/private/ppb_udp_socket_private.h"
#include "ppapi/shared_impl/dir_contents.h"
#include "ui/gfx/size.h"
#include "url/gurl.h"
#include "webkit/common/fileapi/file_system_types.h"
class GURL;
class SkCanvas;
class TransportDIB;
struct PP_NetAddress_Private;
namespace IPC {
struct ChannelHandle;
}
namespace WebKit {
class WebGraphicsContext3D;
}
namespace base {
class MessageLoopProxy;
class Time;
}
namespace content {
class RendererPpapiHost;
}
namespace fileapi {
struct DirectoryEntry;
}
namespace gfx {
class Point;
}
namespace ppapi {
class PepperFilePath;
class PpapiPermissions;
class SocketOptionData;
struct DeviceRefData;
struct HostPortPair;
} // namespace ppapi
namespace WebKit {
typedef SkCanvas WebCanvas;
class WebGamepads;
struct WebCursorInfo;
struct WebURLError;
class WebURLLoaderClient;
class WebURLResponse;
}
namespace content {
class FileIO;
class FullscreenContainer;
class PepperPluginInstanceImpl;
class PluginModule;
class PPB_Flash_Menu_Impl;
class PPB_ImageData_Impl;
class PPB_TCPSocket_Private_Impl;
// Virtual interface that the browser implements to implement features for
// PPAPI plugins.
class PluginDelegate {
public:
// Notification that the given plugin is focused or unfocused.
virtual void PluginFocusChanged(PepperPluginInstanceImpl* instance,
bool focused) = 0;
// Notification that the text input status of the given plugin is changed.
virtual void PluginTextInputTypeChanged(
PepperPluginInstanceImpl* instance) = 0;
// Notification that the caret position in the given plugin is changed.
virtual void PluginCaretPositionChanged(
PepperPluginInstanceImpl* instance) = 0;
// Notification that the plugin requested to cancel the current composition.
virtual void PluginRequestedCancelComposition(
PepperPluginInstanceImpl* instance) = 0;
// Notification that the text selection in the given plugin is changed.
virtual void PluginSelectionChanged(PepperPluginInstanceImpl* instance) = 0;
// Notification that the given plugin has crashed. When a plugin crashes, all
// instances associated with that plugin will notify that they've crashed via
// this function.
virtual void PluginCrashed(PepperPluginInstanceImpl* instance) = 0;
// Indicates that the given instance has been created.
virtual void InstanceCreated(PepperPluginInstanceImpl* instance) = 0;
// Indicates that the given instance is being destroyed. This is called from
// the destructor, so it's important that the instance is not dereferenced
// from this call.
virtual void InstanceDeleted(PepperPluginInstanceImpl* instance) = 0;
// Sends an async IPC to open a local file.
typedef base::Callback<void (base::PlatformFileError, base::PassPlatformFile)>
AsyncOpenFileCallback;
virtual bool AsyncOpenFile(const base::FilePath& path,
int flags,
const AsyncOpenFileCallback& callback) = 0;
// Returns a MessageLoopProxy instance associated with the message loop
// of the file thread in this renderer.
virtual scoped_refptr<base::MessageLoopProxy>
GetFileThreadMessageLoopProxy() = 0;
// For PPB_TCPSocket_Private.
virtual uint32 TCPSocketCreate() = 0;
virtual void TCPSocketConnect(PPB_TCPSocket_Private_Impl* socket,
uint32 socket_id,
const std::string& host,
uint16_t port) = 0;
virtual void TCPSocketConnectWithNetAddress(
PPB_TCPSocket_Private_Impl* socket,
uint32 socket_id,
const PP_NetAddress_Private& addr) = 0;
virtual void TCPSocketSSLHandshake(
uint32 socket_id,
const std::string& server_name,
uint16_t server_port,
const std::vector<std::vector<char> >& trusted_certs,
const std::vector<std::vector<char> >& untrusted_certs) = 0;
virtual void TCPSocketRead(uint32 socket_id, int32_t bytes_to_read) = 0;
virtual void TCPSocketWrite(uint32 socket_id, const std::string& buffer) = 0;
virtual void TCPSocketDisconnect(uint32 socket_id) = 0;
virtual void TCPSocketSetOption(uint32 socket_id,
PP_TCPSocket_Option name,
const ::ppapi::SocketOptionData& value) = 0;
virtual void RegisterTCPSocket(PPB_TCPSocket_Private_Impl* socket,
uint32 socket_id) = 0;
// For PPB_TCPServerSocket_Private.
virtual void TCPServerSocketListen(PP_Resource socket_resource,
const PP_NetAddress_Private& addr,
int32_t backlog) = 0;
virtual void TCPServerSocketAccept(uint32 server_socket_id) = 0;
virtual void TCPServerSocketStopListening(
PP_Resource socket_resource,
uint32 socket_id) = 0;
// Locks the mouse for |instance|. If false is returned, the lock is not
// possible. If true is returned then the lock is pending. Success or
// failure will be delivered asynchronously via
// PluginInstance::OnLockMouseACK().
virtual bool LockMouse(PepperPluginInstanceImpl* instance) = 0;
// Unlocks the mouse if |instance| currently owns the mouse lock. Whenever an
// plugin instance has lost the mouse lock, it will be notified by
// PluginInstance::OnMouseLockLost(). Please note that UnlockMouse() is not
// the only cause of losing mouse lock. For example, a user may press the Esc
// key to quit the mouse lock mode, which also results in an OnMouseLockLost()
// call to the current mouse lock owner.
virtual void UnlockMouse(PepperPluginInstanceImpl* instance) = 0;
// Returns true iff |instance| currently owns the mouse lock.
virtual bool IsMouseLocked(PepperPluginInstanceImpl* instance) = 0;
// Notifies that |instance| has changed the cursor.
// This will update the cursor appearance if it is currently over the plugin
// instance.
virtual void DidChangeCursor(PepperPluginInstanceImpl* instance,
const WebKit::WebCursorInfo& cursor) = 0;
// Notifies that |instance| has received a mouse event.
virtual void DidReceiveMouseEvent(PepperPluginInstanceImpl* instance) = 0;
// Retrieve current gamepad data.
virtual void SampleGamepads(WebKit::WebGamepads* data) = 0;
// Notifies the plugin of the document load. This should initiate the call to
// PPP_Instance.HandleDocumentLoad.
//
// The loader object should set itself on the PluginInstance as the document
// loader using set_document_loader.
virtual void HandleDocumentLoad(PepperPluginInstanceImpl* instance,
const WebKit::WebURLResponse& response) = 0;
// Sets up the renderer host and out-of-process proxy for an external plugin
// module. Returns the renderer host, or NULL if it couldn't be created.
virtual RendererPpapiHost* CreateExternalPluginModule(
scoped_refptr<PluginModule> module,
const base::FilePath& path,
::ppapi::PpapiPermissions permissions,
const IPC::ChannelHandle& channel_handle,
base::ProcessId plugin_pid,
int plugin_child_id) = 0;
};
} // namespace content
#endif // CONTENT_RENDERER_PEPPER_PLUGIN_DELEGATE_H_
|
