| OLD | NEW | 
 | (Empty) | 
|    1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. |  | 
|    2 // Use of this source code is governed by a BSD-style license that can be |  | 
|    3 // found in the LICENSE file. |  | 
|    4  |  | 
|    5 /** |  | 
|    6  * @fileoverview |  | 
|    7  * Class handling creation and teardown of a remoting host session. |  | 
|    8  * |  | 
|    9  * This abstracts a <embed> element and controls the plugin which does the |  | 
|   10  * actual remoting work.  There should be no UI code inside this class.  It |  | 
|   11  * should be purely thought of as a controller of sorts. |  | 
|   12  */ |  | 
|   13  |  | 
|   14 'use strict'; |  | 
|   15  |  | 
|   16 /** @suppress {duplicate} */ |  | 
|   17 var remoting = remoting || {}; |  | 
|   18  |  | 
|   19 /** |  | 
|   20  * @constructor |  | 
|   21  */ |  | 
|   22 remoting.HostSession = function() { |  | 
|   23   /** @private */ |  | 
|   24   this.HOST_PLUGIN_ID_ = 'host-plugin-id'; |  | 
|   25 }; |  | 
|   26  |  | 
|   27 /** @type {remoting.HostPlugin} */ |  | 
|   28 remoting.HostSession.prototype.plugin = null; |  | 
|   29  |  | 
|   30 // Note that these values are copied directly from host_script_object.h and |  | 
|   31 // must be kept in sync. |  | 
|   32 /** @enum {number} */ |  | 
|   33 remoting.HostSession.State = { |  | 
|   34   UNKNOWN: -1, |  | 
|   35   DISCONNECTED: 0, |  | 
|   36   STARTING: 1, |  | 
|   37   REQUESTED_ACCESS_CODE: 2, |  | 
|   38   RECEIVED_ACCESS_CODE: 3, |  | 
|   39   CONNECTED: 4, |  | 
|   40   DISCONNECTING: 5, |  | 
|   41   ERROR: 6 |  | 
|   42 }; |  | 
|   43  |  | 
|   44 /** |  | 
|   45  * Create the host plugin and initiate a connection. |  | 
|   46  * @param {Element} container The parent element to which to add the plugin. |  | 
|   47  * @param {string} email The user's email address. |  | 
|   48  * @param {string} accessToken A valid OAuth2 access token. |  | 
|   49  * @param {function(boolean):void} onNatTraversalPolicyChanged Callback |  | 
|   50  *     for notification of changes to the NAT traversal policy. |  | 
|   51  * @param {function(remoting.HostSession.State):void} onStateChanged |  | 
|   52  *     Callback for notifications of changes to the host plugin's state. |  | 
|   53  * @param {function(string):void} logDebugInfo Callback allowing the plugin |  | 
|   54  *     to log messages to the debug log. |  | 
|   55  */ |  | 
|   56 remoting.HostSession.prototype.createPluginAndConnect = |  | 
|   57     function(container, email, accessToken, |  | 
|   58              onNatTraversalPolicyChanged, onStateChanged, logDebugInfo) { |  | 
|   59   this.plugin = /** @type {remoting.HostPlugin} */ |  | 
|   60       document.createElement('embed'); |  | 
|   61   this.plugin.type = remoting.PLUGIN_MIMETYPE; |  | 
|   62   this.plugin.id = this.HOST_PLUGIN_ID_; |  | 
|   63   // Hiding the plugin means it doesn't load, so make it size zero instead. |  | 
|   64   this.plugin.width = 0; |  | 
|   65   this.plugin.height = 0; |  | 
|   66   container.appendChild(this.plugin); |  | 
|   67   this.plugin.onNatTraversalPolicyChanged = onNatTraversalPolicyChanged; |  | 
|   68   this.plugin.onStateChanged = onStateChanged; |  | 
|   69   this.plugin.logDebugInfo = logDebugInfo; |  | 
|   70   this.plugin.localize(chrome.i18n.getMessage); |  | 
|   71   this.plugin.connect(email, 'oauth2:' + accessToken); |  | 
|   72 }; |  | 
|   73  |  | 
|   74 /** |  | 
|   75  * Get the access code generated by the host plugin. Valid only after the |  | 
|   76  * plugin state is RECEIVED_ACCESS_CODE. |  | 
|   77  * @return {string} The access code. |  | 
|   78  */ |  | 
|   79 remoting.HostSession.prototype.getAccessCode = function() { |  | 
|   80   return this.plugin.accessCode; |  | 
|   81 }; |  | 
|   82  |  | 
|   83 /** |  | 
|   84  * Get the lifetime for the access code. Valid only after the plugin state is |  | 
|   85  * RECEIVED_ACCESS_CODE. |  | 
|   86  * @return {number} The access code lifetime, in seconds. |  | 
|   87  */ |  | 
|   88 remoting.HostSession.prototype.getAccessCodeLifetime = function() { |  | 
|   89   return this.plugin.accessCodeLifetime; |  | 
|   90 }; |  | 
|   91  |  | 
|   92 /** |  | 
|   93  * Get the email address of the connected client. Valid only after the plugin |  | 
|   94  * state is CONNECTED. |  | 
|   95  * @return {string} The client's email address. |  | 
|   96  */ |  | 
|   97 remoting.HostSession.prototype.getClient = function() { |  | 
|   98   return this.plugin.client; |  | 
|   99 }; |  | 
|  100  |  | 
|  101 /** |  | 
|  102  * Disconnect the client. |  | 
|  103  * @return {void} Nothing. |  | 
|  104  */ |  | 
|  105 remoting.HostSession.prototype.disconnect = function() { |  | 
|  106   this.plugin.disconnect(); |  | 
|  107 }; |  | 
|  108  |  | 
|  109  |  | 
|  110 /** |  | 
|  111  * Remove the plugin element from the document. |  | 
|  112  * @return {void} Nothing. |  | 
|  113  */ |  | 
|  114 remoting.HostSession.prototype.removePlugin = function() { |  | 
|  115   this.plugin.parentNode.removeChild(this.plugin); |  | 
|  116 }; |  | 
| OLD | NEW |