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
|
// Copyright (c) 2011 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.
// This implements the JavaScript class entrypoint for the plugin instance.
// The Javascript API is defined as follows.
//
// interface ChromotingScriptableObject {
//
// // Dimension of the desktop area.
// readonly attribute int desktopWidth;
// readonly attribute int desktopHeight;
//
// // Connection status.
// readonly attribute unsigned short status;
//
// // Statistics.
// // Video Bandwidth in bytes per second.
// readonly attribute float videoBandwidth;
// // Latency for capturing in milliseconds.
// readonly attribute int videoCaptureLatency;
// // Latency for video encoding in milliseconds.
// readonly attribute int videoEncodeLatency;
// // Latency for video decoding in milliseconds.
// readonly attribute int videoDecodeLatency;
// // Latency for rendering in milliseconds.
// readonly attribute int videoRenderLatency;
// // Latency between an event is sent and a corresponding video packet is
// // received.
// readonly attribute int roundTripLatency;
//
// // Constants for connection status.
// const unsigned short STATUS_UNKNOWN = 0;
// const unsigned short STATUS_CONNECTING = 1;
// const unsigned short STATUS_INITIALIZING = 2;
// const unsigned short STATUS_CONNECTED = 3;
// const unsigned short STATUS_CLOSED = 4;
// const unsigned short STATUS_FAILED = 5;
//
// // Connection quality.
// readonly attribute unsigned short quality;
// // Constants for connection quality
// const unsigned short QUALITY_UNKNOWN = 0;
// const unsigned short QUALITY_GOOD = 1;
// const unsigned short QUALITY_BAD = 2;
//
// // JS callback function so we can signal the JS UI when the connection
// // status has been updated.
// attribute Function connectionInfoUpdate;
//
// // JS callback function to call when there is new debug info to display
// // in the client UI.
// attribute Function debugInfo;
//
// // JS callback function to send an XMPP IQ stanza for performing the
// // signaling in a jingle connection. The callback function should be
// // of type void(string request_xml).
// attribute Function sendIq;
//
// // Method for receiving an XMPP IQ stanza in response to a previous
// // sendIq() invocation. Other packets will be silently dropped.
// void onIq(string response_xml);
//
// // This function is called when login information for the host machine is
// // needed.
// //
// // User of this object should respond with calling submitLoginInfo() when
// // username and password is available.
// //
// // This function will be called multiple times until login was successful
// // or the maximum number of login attempts has been reached. In the
// // later case |connection_status| is changed to STATUS_FAILED.
// attribute Function loginChallenge;
//
// // Methods for establishing a Chromoting connection.
// //
// // Either use connect() or connectSandboxed(), not both. If using
// // connectSandboxed(), sendIq must be set, and responses to calls on
// // sendIq must be piped back into onIq().
// void connect(string username, string host_jid, string auth_token);
// void connectSandboxed();
// void disconnect();
//
// // Method for submitting login information.
// void submitLoginInfo(string username, string password);
//
// // Method for setting scale-to-fit.
// void setScaleToFit(bool scale_to_fit);
// }
#ifndef REMOTING_CLIENT_PLUGIN_CHROMOTING_SCRIPTABLE_OBJECT_H_
#define REMOTING_CLIENT_PLUGIN_CHROMOTING_SCRIPTABLE_OBJECT_H_
#include <map>
#include <string>
#include <vector>
#include "base/memory/weak_ptr.h"
#include "ppapi/cpp/dev/scriptable_object_deprecated.h"
#include "ppapi/cpp/var.h"
namespace remoting {
class ChromotingInstance;
class PepperXmppProxy;
enum ConnectionStatus {
STATUS_UNKNOWN = 0,
STATUS_CONNECTING,
STATUS_INITIALIZING,
STATUS_CONNECTED,
STATUS_CLOSED,
STATUS_FAILED,
};
enum ConnectionQuality {
QUALITY_UNKNOWN = 0,
QUALITY_GOOD,
QUALITY_BAD,
};
class ChromotingScriptableObject
: public pp::deprecated::ScriptableObject,
public base::SupportsWeakPtr<ChromotingScriptableObject> {
public:
explicit ChromotingScriptableObject(ChromotingInstance* instance);
virtual ~ChromotingScriptableObject();
virtual void Init();
// Override the ScriptableObject functions.
virtual bool HasProperty(const pp::Var& name, pp::Var* exception);
virtual bool HasMethod(const pp::Var& name, pp::Var* exception);
virtual pp::Var GetProperty(const pp::Var& name, pp::Var* exception);
virtual void GetAllPropertyNames(std::vector<pp::Var>* properties,
pp::Var* exception);
virtual void SetProperty(const pp::Var& name,
const pp::Var& value,
pp::Var* exception);
virtual pp::Var Call(const pp::Var& method_name,
const std::vector<pp::Var>& args,
pp::Var* exception);
void SetConnectionInfo(ConnectionStatus status, ConnectionQuality quality);
void LogDebugInfo(const std::string& info);
void SetDesktopSize(int width, int height);
// This should be called to signal JS code to provide login information.
void SignalLoginChallenge();
// Attaches the XmppProxy used for issuing and receivng IQ stanzas for
// initiaing a jingle connection from within the sandbox.
void AttachXmppProxy(PepperXmppProxy* xmpp_proxy);
// Sends an IQ stanza, serialized as an xml string, into Javascript for
// handling.
void SendIq(const std::string& request_xml);
private:
typedef std::map<std::string, int> PropertyNameMap;
typedef pp::Var (ChromotingScriptableObject::*MethodHandler)(
const std::vector<pp::Var>& args, pp::Var* exception);
struct PropertyDescriptor {
explicit PropertyDescriptor(const std::string& n, pp::Var a)
: name(n), attribute(a), method(NULL) {
}
explicit PropertyDescriptor(const std::string& n, MethodHandler m)
: name(n), method(m) {
}
enum Type {
ATTRIBUTE,
METHOD,
} type;
std::string name;
pp::Var attribute;
MethodHandler method;
};
// Routines to add new attribute, method properties.
void AddAttribute(const std::string& name, pp::Var attribute);
void AddMethod(const std::string& name, MethodHandler handler);
// This should be called to signal the JS code that the connection status has
// changed.
void SignalConnectionInfoChange();
// Signal the JS code that the desktop size has changed.
void SignalDesktopSizeChange();
pp::Var DoConnect(const std::vector<pp::Var>& args, pp::Var* exception);
pp::Var DoConnectSandboxed(const std::vector<pp::Var>& args,
pp::Var* exception);
pp::Var DoDisconnect(const std::vector<pp::Var>& args, pp::Var* exception);
// This method is called by JS to provide login information.
pp::Var DoSubmitLogin(const std::vector<pp::Var>& args, pp::Var* exception);
// This method is called by JS to set scale-to-fit.
pp::Var DoSetScaleToFit(const std::vector<pp::Var>& args, pp::Var* exception);
// This method is caleld by Javascript to provide responses to sendIq()
// requests when establishing a sandboxed Chromoting connection.
pp::Var DoOnIq(const std::vector<pp::Var>& args, pp::Var* exception);
PropertyNameMap property_names_;
std::vector<PropertyDescriptor> properties_;
scoped_refptr<PepperXmppProxy> xmpp_proxy_;
ChromotingInstance* instance_;
};
} // namespace remoting
#endif // REMOTING_CLIENT_PLUGIN_CHROMOTING_SCRIPTABLE_OBJECT_H_
|
