• Overview
• Browser and Device Compatibility
• A code sample to get you started
• JavaScript API Details
• Attributions
• See it working in this page!

The Intel Web APIs are implemented as browser plugins. In order to avoid requiring the viewers of web pages with these plugins to individually download and install the plugins, the Connector simplifies this chore without compromising the viewer's control and security.

When first visting a site using Intel Web APIs, the viewer of the page will be directed to install the Connector. This installation is like any other plugin installation - download the installer, run it, and restart the browser. After this, however, the viewer experiences much different behavior with Intel Web API web pages. Upon subsequent visits to a page with Intel Web APIs, the web page will request that the Connector download and install any required Intel Web APIs. This occurs without the viewer performing the steps manually - so no longer does the viewer need to download, run, and restart.

Instead, after the Connector is installed, the viewer will be prompted to allow or deny each web site requesting other Intel Web APIs. This ensures the viewer remains in control of which web sites can and cannot use Intel Web APIs on his or her machine. The Connector allows the viewer to establish both per-session and permenant whitelists and blacklists. In otherwords, known good and known bad sites.

In addition to viewer-controlled white and black lists, the Connector also refuses to download and install plugins that are not digitally signed by the folks here at Intel working on Intel Web APIs - we don't want a rouge web site to instruct the Connector to download any random plugin!

The table below lists some compatability notes for browser and operating system combinations.

If you are interested in seeing these APIs available on other device types and operating systems please let us know by leaving comments.

This HTML & JavaScript shows you how to embed the Intel Connector Web API into your app.

  <div id="IntelWebAPIs_sample_code_status_div" 
    ></div>
  <script 
    type="text/javascript" 
    src="http://software.intel.com/sites/whatif/webapis/intelwebapis.js">
  </script>
  
  <script type="text/javascript">
  
    // this outer closure just to keep the sample code from cluttering up
    // the namespace with the function names etc being used
    (function() {
      
      //kick off IntelWebAPIs.init() and IntelWebAPIs.require() when
      //the page is loaded
      add_onload_handler( function() {
  
        IntelWebAPIs.init(init_result_func);
        
        //called by IntelWebAPIs.init()
        function init_result_func(result) {
          if(result.success) {
            // now bring in Intel Web APIs required by your app...
            output_status("IntelWebAPIs Connector init success: version " +
                          IntelWebAPIs.connector.version);
          }
          else {
            output_status("IntelWebAPIs Connector init error: " + result.error.msg);
            //handle error condition
            //result.error.msg contains an error message
            //result.connectorInstUrl contains the url to the Intel Web API connector installer
            output_status("you may need to download the Intel Web API connector from here: " + 
              result.connectorInstUrl);
          }
        }
      });     
      
      /* Its recommended that you wait until the document is loaded 
         before calling IntelWebAPIs.init() and IntelWebAPIs.require() 
         This utility helps with that...*/
      function add_onload_handler(addfunc, altwindow) {
        var targwindow = window;
        if(typeof(altwindow) != 'undefined'){
          targwindow = altwindow;
        }
        
        /* chain the onload functions together */
        var prevf = targwindow.onload;
        var newf  = addfunc;
        targwindow.onload = function(){
            newf();
            if(typeof(prevf) == 'function'){
              prevf();
            }
          };
      }
      
      /* utility that outputs status messages to a div*/
      function output_status(str) {
        var divout = document.getElementById("IntelWebAPIs_sample_code_status_div");
        divout.innerHTML += str + "<br/>";
        divout.scrollTop = divout.scrollHeight;
      }
    })(); // end of outer closure
  </script>

Th Object that is passed into callback for the init() function is formatted as follows:

  result = { 
    success           : boolean,
    
    // these fields are valid if success != true
    connectorInstUrl  : string 
    error             : {
      msg             : string 
    } 
  }

  IntelWebAPIs.connector = {
    'version'     : string
  };

Intel Connector Web API uses the following software components:

• OpenSSL: This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org/). Copyright (c) 1998-2008 The OpenSSL Project. All rights reserved.
• JSONXX: Copyright (c) 2010 Hong Jiang Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

• Overview
• Browser and Device Compatibility
• A code sample to get you started
• JavaScript API Details
• See it working in this page!

When web apps have the ability to learn about the characteristics of the device's network connection they are be able to make use of that information to create a better experience for the user.

For instance, in combination with other information about the device, a web app might use connection information to request a video stream which is approprate for the device's current bandwidth capability. A web app may determine that current signal strength is not sufficient for the app to function appropriatly for the desired user experience - and may prompt the user re-orient the device or move closer to a wireless access point.

The table below lists some compatability notes for browser and operating system combinations.

If you are interested in seeing these APIs available on other device types and operating systems please let us know by leaving comments.

This HTML & JavaScript shows you how to embed the Intel Connection Web API into your app.

  <div id="IntelWebAPIs_sample_code_status_div" 
    ></div>
  <script 
    type="text/javascript" 
    src="http://software.intel.com/sites/whatif/webapis/intelwebapis.js">
  </script>
  <script type="text/javascript">

    // this outer closure just to keep the sample code from cluttering up
    // the namespace with the function names etc being used
    (function() {
      
      //kick off IntelWebAPIs.init() and IntelWebAPIs.require() when
      //the page is loaded
      add_onload_handler( function() {

        IntelWebAPIs.init(init_result_func);
        
        //called by IntelWebAPIs.init()
        function init_result_func(result) {
          if(result.success) {
            // now bring in Intel Web APIs required by your app...
            output_status("IntelWebAPIs Connector init success");
            IntelWebAPIs.require(["connection"], require_completion_func, require_progress_func);
          }
          else {
            output_status("IntelWebAPIs Connector init error: " + result.error.msg);
            //handle error condition
            //result.error.msg contains an error message
            //result.connectorInstUrl contains the url to the Intel Web API connector installer
            output_status("you may need to download the Intel Web API connector from here: " + 
              result.connectorInstUrl);
          }
        }
    
        //called by IntelWebAPIs.require()
        function require_completion_func(result) {
          if(result.success){
            //you can now use IntelWebAPIs.connection properties and functions
            output_status("IntelWebAPIs." + result.installInfo.plugins[0].name + " ready for use!");
            setInterval(function(){
              // send a status message to our div every second
              var connInfo = IntelWebAPIs.connection.getConnectionInfo();
              output_status("Wifi connected=" + connInfo.wifi.connected);
              output_status("Wifi signal strength=" + connInfo.wifi.signalStrength);
            },1000);
          }
          else {
            //check other result properties and handle error condition
            output_status("IntelWebAPIs error: " + result.installInfo.msg);
          }
        }
        
        //called by IntelWebAPIs.require()
        function require_progress_func(statusMsg){
          //statusMsg is a string - send this wherever
          output_status("IntelWebAPIs connector status: " + statusMsg);
        }
      
      });
      
      /* Its recommended that you wait until the document is loaded 
         before calling IntelWebAPIs.init() and IntelWebAPIs.require() 
         This utility helps with that...*/
      function add_onload_handler(addfunc, altwindow) {
        var targwindow = window;
        if(typeof(altwindow) != 'undefined'){
          targwindow = altwindow;
        }
        
        /* chain the onload functions together */
        var prevf = targwindow.onload;
        var newf  = addfunc;
        targwindow.onload = function(){
            newf();
            if(typeof(prevf) == 'function'){
              prevf();
            }
          };
      }
      
      /* utility that outputs status messages to a div*/
      function output_status(str) {
        var divout = document.getElementById("IntelWebAPIs_sample_code_status_div");
        divout.innerHTML += str + "<br/>";
        divout.scrollTop = divout.scrollHeight;
      }
    })(); // end of outer closure
  </script>

This is the result Object that is passed into init_result_func(result).
If the Intel Web API Connector is not yet installed on a user's device you can use the result.connectorInstUrl to prompt the user, in the context of your app, to install it.
Once the Intel Web API Connector is installed other apis are installed by the connector, with minimal user interruption, when your app calls IntelWebAPIs.require().

  result = { 
    success           : boolean,
    
    // these fields are valid if success != true
    connectorInstUrl  : string 
    error             : {
      msg             : string 
    } 
  }

  result = { 
    success       : boolean,
    
    installInfo   : {
      msg         : string,
      
      plugins     : [ { 
        name      : string,
        installed : boolean,
        details   : string
        }, 
        //...
      ], 
    }
  }  

  IntelWebAPIs.connection = {
    'version'             : string,
    'connected'           : boolean,
    'getConnectionInfo'   : function
  };

  connectionInfo =  {
    'lan'         : {
      'connected'       : boolean,
      'signalStrength'  : number,     //will be 100 if connected, 0 if not connected
      'linkSpeed'       : number      //kbps in 100bps or 0 if unknown or disconnected
    },
    'wifi'        : {
      'connected'       : boolean
      'signalStrength'  : number,     //RSSI signal strength as a percent or -1 if unknown. 
                                      // signal strength is 0 when disconnected.
      'linkSpeed'       : number      //kbps in 100bps or 0 if unknown or disconnected
    }
  }

  function output_connected(){
    alert("connected = " + IntelWebAPIs.connection.connected);      
  }
  
  function output_connection_info() {
    var conninfo = IntelWebAPIs.connection.getConnectionInfo();
    alert("lan.connected="        + conninfo['lan']['connected']);  
    alert("lan.signalStrength="   + conninfo['lan']['signalStrength']);
    alert("lan.linkSpeed="        + conninfo['lan']['linkSpeed']);

    alert("wifi.connected="       + conninfo['wifi']['connected']);  
    alert("wifi.signalStrength="  + conninfo['wifi']['signalStrength']);
    alert("wifi.linkSpeed="       + conninfo['wifi']['linkSpeed']);
  }

• Embedding the widget in your page
• Browser and Device Compatibility
• See it working in this page!

Here is the HTML & JavaScript for the widget up and running. The widget will display a UI with images for CPU, Power and Connection status and also provide a thumbs up / thumbs down image that represents an experience prediction.
The widget will update itself every 5 second.

    <div id="cpci_div"></div>
    <script type="text/javascript" 
      src="http://software.intel.com/sites/whatif/webapis/intelwebapis.js"></script>
    <script type="text/javascript" 
      src="http://software.intel.com/sites/whatif/webapis/widget/cpc/IntelCPCIWidget.js"></script>
    <script type="text/javascript">
    (function() {
      //basic mode
      var theIntelCpciInst = new IntelCPCIWidget('cpci_div');
    })();
    </script>

This HTML & JavaScript changes how often the widget is updated

    <div id="cpci_div"></div>
    <script type="text/javascript" 
      src="http://software.intel.com/sites/whatif/webapis/intelwebapis.js"></script>
    <script type="text/javascript" 
      src="http://software.intel.com/sites/whatif/webapis/widget/cpc/IntelCPCIWidget.js"></script>
    <script type="text/javascript">
    (function() {
      //modified update interval - updates every 1 second instead of default 5
      var theIntelCpciInst = new IntelCPCIWidget('cpci_div',{'updateInt':1});
    })();
    </script>

This HTML & JavaScript passes in another user defined element ID (div) to receive debug messages. Handy when first incorporating the widget into a page.

    <div id="cpci_div"></div>
    <div id="cpci_debug_div"></div>
    <script type="text/javascript" 
      src="http://software.intel.com/sites/whatif/webapis/intelwebapis.js"></script>
    <script type="text/javascript" 
      src="http://software.intel.com/sites/whatif/webapis/widget/cpc/IntelCPCIWidget.js"></script>
    <script type="text/javascript">
    (function() {
      //pass a debug element id for debug messages
      var theIntelCpciInst = new IntelCPCIWidget('cpci_div',{'updateInt':1,'debugElId':'cpci_debug_div'});
    })();
    </script>

This HTML & JavaScript shows how to disable the widget UI and have updates sent to your JavaScript function so that you can implement your own completely custom UI. You should replace the code in the myUpdateCB function with your code.

    <div id="cpci_div"></div>
    <div id="cpci_debug_div"></div>
    <script type="text/javascript" 
      src="http://software.intel.com/sites/whatif/webapis/intelwebapis.js"></script>
    <script type="text/javascript" 
      src="http://software.intel.com/sites/whatif/webapis/widget/cpc/IntelCPCIWidget.js"></script>
    <script type="text/javascript">
    (function() {
      //disable the default widget UI and add a update callback for a custom ui
      var theIntelCpciInst = new IntelCPCIWidget('cpci_div',{'updateInt':1,
        'debugElId':'cpci_debug_div','uiEnable': false,'updateCB':myUpdateCB});
      
      function myUpdateCB(currInfo) {
        //do something with currInfo.cpu, currInfo.power, currInfo.connection
        var customUiEl = document.getElementById("cpci_div");
        customUiEl.innerHTML = "Custom UI:<br/>";
        var cpuLoad = Math.round((IntelWebAPIs.cpu.load * 100) * 100)/100;
        var connState = currInfo.connection.connected;
        var drawEl = document.createElement("pre");
        drawEl.innerHTML = "CPU Name: " + currInfo.cpu.name + "\r\n";
        drawEl.innerHTML += "CPU Load: " + cpuLoad + " %\r\n";
        drawEl.innerHTML += "Network Connected: " + connState + "\r\n";
        
        if(connState){
          var conninfo = currInfo.connection.getConnectionInfo();
          var connInfoHtml = "Connection Info:" + "\r\n";
          if(conninfo.lan.connected){
            connInfoHtml += "  lan.connected=" + 
              conninfo['lan']['connected'] + "\r\n";
            connInfoHtml += "  lan.signalStrength=" +
              conninfo['lan']['signalStrength'] + "\r\n";
            connInfoHtml += "  lan.linkSpeed=" +
              ((conninfo['lan']['linkSpeed']*100)/1000/1000) + " Mbps" + "\r\n";
          }
          if(conninfo.wifi.connected){
            connInfoHtml += "  wifi.connected=" +
              conninfo['wifi']['connected'] + "\r\n";
            connInfoHtml += "  wifi.signalStrength=" +
              conninfo['wifi']['signalStrength'] + "\r\n";
            connInfoHtml += "  wifi.linkSpeed=" +
              ((conninfo['wifi']['linkSpeed']*100)/1000/1000) + " Mbps" + "\r\n";
          }
          drawEl.innerHTML += connInfoHtml  + "\r\n";
        }
        
        if(currInfo.power.usingExternalPowerSource) {
          drawEl.innerHTML += "Device power: External / wall power" + "\r\n";; 
        }
        else {
          drawEl.innerHTML += "Device power: Battery" + "\r\n";
          drawEl.innerHTML += "Device battery level: " + currInfo.power.powerLevel + " %" + "\r\n";
          drawEl.innerHTML += "Device battery time : " + 
            Math.round((currInfo.power.timeRemaining / 60)) + " minutes" + "\r\n";
        }
        customUiEl.appendChild(drawEl);
      }
      
    })();
    </script>

The table below lists some compatability notes for browser and operating system combinations. This widget is currently beta quality.

If you are interested in seeing these APIs available on other device types and operating systems please let us know by leaving comments.

• Embedding the widget in your page.
• Accessing the Intel Web API Registry data directly
• Browser and Device Compatibility

Here is the HTML & JavaScript to get the widget up and running.

  <div id="IntelWebAPIs_div"></div>
  <script type="text/javascript" 
    src="http://software.intel.com/sites/whatif/webapis/IntelWebAPIsRegistry.js"></script>
  <script type="text/javascript">
    (function(){
      var webApiRegistryCtrl = new IntelWebAPIsRegistryWidget('IntelWebAPIs_div',{'statusbar':false});
    })();
  </script>

This HTML & JavaScript changes how many columns are displayed using the 'maxcolumns' configuration option.

  <div id="IntelWebAPIs_div"></div>
  <script type="text/javascript" 
    src="http://software.intel.com/sites/whatif/webapis/IntelWebAPIsRegistry.js"></script>
  <script type="text/javascript">
    (function(){
        var webApiRegistryCtrl = new IntelWebAPIsRegistryWidget('IntelWebAPIs_div',
          {'maxcolumns':1,'statusbar':false});
    })();
  </script>

You can add a script node to your page as follows and then access the data through a JavaScript Object. This javascript object is the same data that is available in the JSON data below.

  <script type="text/javascript" 
    src="http://software.intel.com/sites/whatif/webapis/IntelWebAPIsRegistryData.js"></script>
  <script type="text/javascript">
    (function(){
        var regDataObj = new IntelWebAPIsRegistryData();
        //do something with regDataObj or inspect in a DOM debug tool
        //window.check_this_stuff = regDataObj;
    })();
  </script>

You can also access the JSON data directly. This might be useful from server side PHP code or even stand alone app code can can handle JSON.

  http://software.intel.com/sites/whatif/webapis/intelwebapis_reg.json

This is the data that is available as JSON or through IntelWebAPIsRegistryData.js:

  registry_data = {
    'version'   : string, // format major.minor.patch, ex: '1.0.0'
    'language'  : string, // language ex: en-us

    //array of strings
    //unique identifier of the api or widget or mashup in the registry
    //for each name in this array there is a key 
    //with the same value in the details object below
    'names'     : [
      string,
      //more names ...
    ],

    //details object : each key in this object matches a name in the names
    //array above.
    'details'   : {
      'entry_name' : {                // unique identifier of this entry - same as value in names array.
        'uid'           : string,     // unique identifier of this entry - 
                                      //   same as name 'string_name' of this object
        'type'          : string,     // type of this entry: api|widget|mashup
        'friendly_name' : string,     // friendly text name of entry
        'friendly_desc' : string,     // long description of entry
        'version'       : string,     // major.minor.patch_string
        'add_date'      : string,     // date formated as '02/09/2010'
        'update_date'   : string,     // date formated as '02/09/2010'
        'website'       : string,     // url for website of this entry
        'license'       : string,     // url of the license / terms of entry
        // archive object:
        // contains paths to plugin archives for OS/plugin type combinations
        'archive' : {
          'win32-npapi' :'./api/cpu/cpu-win32-npapi.iwa',
          'win32-ie'    :'./api/cpu/cpu-win32-ie.iwa',
          'mac'         :''
        },
        'imgs' : {
          'thumb'       : string,     // file name of thumbnail for this entry    - relative to website url
          'screenshot'  : string,     // file name of screen shot for this entry  - relative to website url
        }        
        //more entries ...
      },
    }
  }

The table below lists compatability notes for browser and operating system combinations. This widget is currently beta quality.

• Overview
• Browser and Device Compatibility
• A code sample to get you started
• JavaScript API Details
• See it working in this page!

When web apps have the ability to learn about the device's state they are able to make use of that information to create a better experience for the user.

For instance, in combination with other information about the device, a web app might use Battery level information to determine if a will be able to complete an activity - such as watching a lengthy movie or playing a game.

The table below lists some compatability notes for browser and operating system combinations. This API is currently beta quality.

If you are interested in seeing these APIs available on other device types and operating systems please let us know by leaving comments.

This HTML & JavaScript shows you how to embed the Intel Power Web API into your app.

  <div id="IntelWebAPIs_sample_code_status_div" 
    ></div>
  <script 
    type="text/javascript" 
    src="http://software.intel.com/sites/whatif/webapis/intelwebapis.js">
  </script>
  <script type="text/javascript">
  
    // this outer closure just to keep the sample code from cluttering up
    // the namespace with the function names etc being used
    (function() {
      
      //kick off IntelWebAPIs.init() and IntelWebAPIs.require() when
      //the page is loaded
      add_onload_handler( function() {
  
        IntelWebAPIs.init(init_result_func);
        
        //called by IntelWebAPIs.init()
        function init_result_func(result) {
          if(result.success) {
            // now bring in Intel Web APIs required by your app...
            output_status("IntelWebAPIs Connector init success");
            IntelWebAPIs.require(["power"], require_completion_func, require_progress_func);
          }
          else {
            output_status("IntelWebAPIs Connector init error: " + result.error.msg);
            //handle error condition
            //result.error.msg contains an error message
            //result.connectorInstUrl contains the url to the Intel Web API connector installer
            output_status("you may need to download the Intel Web API connector from here: " + 
              result.connectorInstUrl);
          }
        }
    
        //called by IntelWebAPIs.require()
        function require_completion_func(result) {
          if(result.success){
            //you can now use IntelWebAPIs.power properties and functions
            output_status("IntelWebAPIs." + result.installInfo.plugins[0].name + " ready for use!");
            setInterval(function(){
              // send a status message to our div every second
              output_status("Device is using AC power: " + IntelWebAPIs.power.usingExternalPowerSource);
              output_status("Device power level: " + IntelWebAPIs.power.powerLevel + " %");
              if(IntelWebAPIs.power.usingExternalPowerSource == false){
                output_status("Device battery time remaining: " + 
                  Math.round((IntelWebAPIs.power.timeRemaining / 60)) + " minutes");
              }
            },1000);
          }
          else {
            //check other result properties and handle error condition
            output_status("IntelWebAPIs error: " + result.installInfo.msg);
          }
        }
        
        //called by IntelWebAPIs.require()
        function require_progress_func(statusMsg){
          //statusMsg is a string - send this wherever
          output_status("IntelWebAPIs connector status: " + statusMsg);
        }
      
      });
      
      /* Its recommended that you wait until the document is loaded 
         before calling IntelWebAPIs.init() and IntelWebAPIs.require() 
         This utility helps with that...*/
      function add_onload_handler(addfunc, altwindow) {
        var targwindow = window;
        if(typeof(altwindow) != 'undefined'){
          targwindow = altwindow;
        }
        
        /* chain the onload functions together */
        var prevf = targwindow.onload;
        var newf  = addfunc;
        targwindow.onload = function(){
            newf();
            if(typeof(prevf) == 'function'){
              prevf();
            }
          };
      }
      
      /* utility that outputs status messages to a div*/
      function output_status(str) {
        var divout = document.getElementById("IntelWebAPIs_sample_code_status_div");
        divout.innerHTML += str + "<br/>";
        divout.scrollTop = divout.scrollHeight;
      }
    })(); // end of outer closure
  </script>

This is the result Object that is passed into init_result_func(result).
If the Intel Web API Connector is not yet installed on a user's device you can use the result.connectorInstUrl to prompt the user, in the context of your app, to install it.
Once the Intel Web API Connector is installed other apis are installed by the connector, with minimal user interruption, when your app calls IntelWebAPIs.require().

  result = { 
    success           : boolean,
    
    // these fields are valid if success != true
    connectorInstUrl  : string 
    error             : {
      msg             : string 
    } 
  }

  result = { 
    success       : boolean,
    
    installInfo   : {
      msg         : string,
      
      plugins     : [ { 
        name      : string,
        installed : boolean,
        details   : string
        }, 
        //...
      ], 
    }
  }  

  IntelWebAPIs.power = {
    'version'                   : string,
    'usingExternalPowerSource'  : boolean,
    'timeRemaining'             : number,
    'powerLevel'                : number
  };

  function output_timeRemaining(){
    alert("timeRemaining=" + IntelWebAPIs.power.timeRemaining);
  }
  
  function output_usingExternalPowerSource(){
    alert("usingExternalPowerSource=" + IntelWebAPIs.power.usingExternalPowerSource);
  }

  function output_powerLevel(){
    var selplugin = get_sel_plugin();
    alert("powerLevel=" + IntelWebAPIs.power.powerLevel);
  }

• Overview
• Browser and Device Compatibility
• A code sample to get you started
• JavaScript API Details
• See it working in this page!

When web apps have the ability to learn about some of the characteristics of the device's CPU and the current CPU load they are able to make use of that information to create a better experience for the user.

For instance, in combination with other information about the device, a web app might use CPU information to request a video stream which is approprate for the device's CPU decode capability. A web app may determine that current CPU utilization is too high for the app to function appropriatly for the desired user experience - and may prompt the user to shut down some applicaitons before proceeding.

The table below lists some compatability notes for browser and operating system combinations. This API is currently beta quality.

If you are interested in seeing these APIs available on other device types and operating systems please let us know by leaving comments.

This HTML & JavaScript shows you how to embed the Intel CPU Web API into your app.

  <div id="IntelWebAPIs_sample_code_status_div" 
    ></div>
  <script 
    type="text/javascript" 
    src="http://software.intel.com/sites/whatif/webapis/intelwebapis.js">
  </script>
  <script type="text/javascript">

    // this outer closure just to keep the sample code from cluttering up
    // the namespace with the function names etc being used
    (function() {
      
      //kick off IntelWebAPIs.init() and IntelWebAPIs.require() when
      //the page is loaded
      add_onload_handler( function() {

        IntelWebAPIs.init(init_result_func);
        
        //called by IntelWebAPIs.init()
        function init_result_func(result) {
          if(result.success) {
            // now bring in Intel Web APIs required by your app...
            output_status("IntelWebAPIs Connector init success");
            IntelWebAPIs.require(["cpu"], require_completion_func, require_progress_func);
          }
          else {
            output_status("IntelWebAPIs Connector init error: " + result.error.msg);
            //handle error condition
            //result.error.msg contains an error message
            //result.connectorInstUrl contains the url to the Intel Web API connector installer
            output_status("you may need to download the Intel Web API connector from here: " + 
              result.connectorInstUrl);
          }
        }
    
        //called by IntelWebAPIs.require()
        function require_completion_func(result) {
          if(result.success){
            //you can now use IntelWebAPIs.cpu properties and functions
            output_status("IntelWebAPIs." + result.installInfo.plugins[0].name + " ready for use!");
            output_status("Your CPU Name is: " + IntelWebAPIs.cpu.name);
            setInterval(function(){
              // send a status message to our div every second
              var cpuLoad = Math.round((IntelWebAPIs.cpu.load * 100) * 100)/100;
              output_status("CPU Load =" + cpuLoad + " %");
            },1000);
          }
          else {
            //check other result properties and handle error condition
            output_status("IntelWebAPIs error: " + result.installInfo.msg);
          }
        }
        
        //called by IntelWebAPIs.require()
        function require_progress_func(statusMsg){
          //statusMsg is a string - send this wherever
          output_status("IntelWebAPIs connector status: " + statusMsg);
        }
      
      });
      
      /* Its recommended that you wait until the document is loaded 
         before calling IntelWebAPIs.init() and IntelWebAPIs.require() 
         This utility helps with that...*/
      function add_onload_handler(addfunc, altwindow) {
        var targwindow = window;
        if(typeof(altwindow) != 'undefined'){
          targwindow = altwindow;
        }
        
        /* chain the onload functions together */
        var prevf = targwindow.onload;
        var newf  = addfunc;
        targwindow.onload = function(){
            newf();
            if(typeof(prevf) == 'function'){
              prevf();
            }
          };
      }
      
      /* utility that outputs status messages to a div*/
      function output_status(str) {
        var divout = document.getElementById("IntelWebAPIs_sample_code_status_div");
        divout.innerHTML += str + "<br/>";
        divout.scrollTop = divout.scrollHeight;
      }
    })(); // end of outer closure
  </script>

This is the result Object that is passed into init_result_func(result).
If the Intel Web API Connector is not yet installed on a user's device you can use the result.connectorInstUrl to prompt the user, in the context of your app, to install it.
Once the Intel Web API Connector is installed other apis are installed by the connector, with minimal user interruption, when your app calls IntelWebAPIs.require().

  result = { 
    success           : boolean,
    
    // these fields are valid if success != true
    connectorInstUrl  : string 
    error             : {
      msg             : string 
    } 
  }

  result = { 
    success       : boolean,
    
    installInfo   : {
      msg         : string,
      
      plugins     : [ { 
        name      : string,
        installed : boolean,
        details   : string
        }, 
        //...
      ], 
    }
  }  

  IntelWebAPIs.cpu = {
    'version'     : string,
    'name'        : string,
    'load'        : float
  };

  function output_cpu_name(){
    alert("cpu name = " + IntelWebAPIs.cpu.name);
  }
  
  function output_cpu_load(){
    var currLoad = IntelWebAPIs.cpu.load * 100;
    alert("cpu load = " + currLoad + " %");
  }