Skip to content

Using the Session Client API

Use of the Session Client C++ API is demonstrated in /usr/lib/x86_64-linux-gnu/pcoip-client/examples/client_session_example/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.