5.2.4 – Usage of RDP class
Properties:
| Name | Type | Description |
|---|---|---|
| appTimeout | Int | Close the RemoteApp if no Windows found after this period, default is 800 ms. |
| displayMsg | Boolean | If display error or warning message, default is true |
| reconnectOnResize | Boolean | If reconnect when resize the browser window, default is true |
| reconnectTimes | Int | Automatically reconnecting time,default 0. |
| sessionTimeout | Int | Close the session disconnection if no RemoteApp running after this period. Default value is 3000 (3 seconds). You may want to make it longer, so user can use the current session for new RemoteApp. |
| windowState | Int | State of RemoteApp main window, 3: always maximized, 0: controlled by user |
| openLink | Boolean | Display a web link button when user copy a web link in remote computer, default is true |
| sessionInfo | Object | Current session information. Including following properties: sessionId, userName, domain etc. |
| remoteAppLogin | Boolean | If display login details when using RemoteApp, default is true |
| setTitle | Boolean | If allow client to change browser title, default is true, the browser title will be set as the RDP host name. |
Methods:
| Name | Description |
|---|---|
| close() | Close current RDP session |
| exeAppCmd(cmd) | Execute command on current RemoteApp, cmd (Int) values: 0xF020: Minimize the window 0xF030: Maximize the window 0xF060: Close the window 0xF100: Display the windo’s system menu 0xF120: Restore the window |
| mouseDown(x, y, button) | Send mouse down to RDP host. X, Y: mouse position, button: which button, same as event.button. |
| mouseUp(x, y, button) | Send mouse up to RDP host. |
| mouseMove(x, y) | Send mouse move to RDP host. |
| pauseSession(numericId, pause) | Pause a session output, pause: true or false. Pause all joined sessions if numericId is 0 |
| running() | Check if connected to a RDP session |
| setAudioBuffer(seconds) | Audio buffer size, default is 2.0 seconds |
| writeKeyCode(down, keyCode) | Send browser keyCode to RDP host. “down”: Boolean |
| writeText(txt, interval, doneCallback) | Send Unicode to RDP host. RDP server could ignore some characters if the client is sending them too fast. Please use the optional interval and call back arguments. |
| writeRawInput(input) | Send raw keyboard, mouse events to RDP host. Please use |
| onactivity event to get the raw input events. | |
| writeKeyComb(keys, interval, doneCallback) | Write any key combinations like “Ctrl+Alt+Del”. if interval > 0, every key stroke (down or up) will be sent with delay. |
| notify(message, sessionIDArray) | Send message to other session. sessionIDArray is optional. If sessionIDArray is not given, this will send message to all other joined and main session. If sessionIDArray is provided, it will send message to sessions with the given ID. For example: [id1, id2, id3]. The id can be the 9 digit number id or the GUID. |
| saveSession(info) | This will leave the session open on the gateway, so you can connect to it later from same or different device. For example: saveSession({save: true, timeout:5, id: xxxx}) will leave the session open for 5 minutes on gateway with id xxxx. You can connect to this cached session with the given id. Please check 3.14 for more information about cached session. You can also use plugin to save session. This feature will be disabled if savedSessionTimeout in gateway.conf is 0. |
| startPing(interval, noResponTime) | Start to ping the gateway when the session is idle. Interval: seconds. noResponTime: seconds, time limit for no response. onnoresponse event will be fired if this value reached, default is 0 will never fire onnoresponse event. |
| setJoinMode(mode) | 0: Every one can control; 1: Only one can control; 2: Only one can control (others can move mouse) |
| setJoinCloseMode(mode) | 0: close all joined sessions after initiated session is closed; 1: leave all joined sessions open even initiated session is closed. |
| writeClipboard(text, type) | dp.writeClipboard('Plain text'); rdp.writeClipboard('<h>Header</h>', 'text/html'); var reader = new FileReader(); reader.onloadend = function (e) { if (e.target.readyState == FileReader.DONE) { var imgB64 = hi5.Base64.enc(new Uint8Array(e.target.result)); rdp.writeClipboard(imgB64, 'image/png'); } }; reader.readAsArrayBuffer(blob); |
| sendKeyboardSynchronize(scroll, numlock, capital) | Turn off/on lock key state on remote computer. |
Events:
| Name | Description |
|---|---|
| onclose(expected) | Fired when RDP session is closed. Expected is true if the session is closed by user (log off) or administrators. Please be aware, the Rdp object will be released and cannot be reused after this event. |
| onerror(error) | Fired on an error. Use error.name, error.message to get error details. |
| onloggedin() | Fired when user logged in (It's not supported by xRDP and VirtualBox RDP) |
| beforeupload(file, path) | Fired before uploading a file: file: File object path: file absolute path or name if path cannot be obtained. Return true if it's processed and prevent default behavior happening. |
| onfileuploaded(fileName) | Fired after a file was uploaded |
| onuploaded() | Fired after all files were uploaded |
| onsessionjoin(appInfo) | Fired when a new user joined the session. appInfo has following properties: numericId: the 9 digit id __ip: joined user’s hone name or ip address name: if provided Return true will override the default behavior. |
| onsessionexit(sessionInfo) | Fired when a joined user existed the session. Return true will override the default behavior. |
| ongivecontrol() | Fired when current user can control the session. Return true will override the default behavior. |
| ontakebackcontrol() | Fired when current user cannot control the session anymore |
| onrequirecontrol() | Fired when another require current user to control the session. |
| onremoteappstart(e) | Fired after a RemoteApp was started, you can get the RemoteApp id from e.id which is like: {1AC14E77-02E7-4E5D-B744-2EB1AE5198B7}\mspaint.exe |
| onactivity(input) | Fired after a client activity was sent to the server (Mouse, keyboard events). Input (string) is the mouse and keyboard event. You can use writeRawInput to send them to the RDP host. |
| onurlredirection(URL) | Fired when an URL was copied on remote computer |
| ontitlechange(title) | Fired when client before change the browser title. You can return a new title in this event. |
| onsessionstart(sessionInfo) | sessionInfo is same as the sessionInfo property |
| onservercopy(strValue) | Fired when copying from remote to local. strValue is in “mimeType;value” format, for example: “text/plain;textCopied”. |
| onrequestcredential(info) | Fired when wrong credential was given and credSSP is enabled on gateway). Return true will override the default behavior. Info object has following properties: domain: server’s FQDN domain name nbDomain: server’s NetBIOS domain name nbComputer: server’s NetBIOS computer name |
| onprintingready(printJob) | Return true will override the default behavior. printJob has following properties: link: the PDF file link printerName: target printer name printerDriver: target printer driver name |
| onresolutionchange(width, height) | Fired when resolution of RDP session changes. |
| onnoresponse() | Need to be used with startPing(interval, missTimes) |
| onLockKeyState({"capsLock": capsLock, "numLock": numLock, "scrollLock": scrollLock) |