Using the Client Session API

Use of the Client Session C++ API is demonstrated in <pcoip_client_sdk_session/modules/client_session/src/client_session_main.cpp>. It includes the steps outlined in the diagram below:

Alt Text PCoIP Session Client API Sequence Diagram

Each of these steps is used by the Session Client API, with a comment identifying the step number:

  1. Setup Environment and Implementations: Os specifc initialization. Instantiate a Configuration Provider object.
  2. Parse Command Line: Define and parse supported command line parameters.
  3. Setup Session Options: Validate the options passed via the command line and setup the Configuration Provider object accordingly.
  4. Setup Session Connection Information: Pack the session parameter, received via the command line, into the structures required by the API.
  5. Get Session Instance and Run:: Obtain the main session object, set the Configuration Provider and run the session. The run call blocks until the session is terminated.
  6. Post-Session Clean-up: Performs any post-session shutdown processing.