Shared Applications


Shared Applications Programmes Manual

API reference can be found here in the AccessGrid.AccessGrid.SharedAppClient. You can also access the SharedApplication SOAP interface directly, then refer to AccessGrid.AccessGrid.SharedApplicationIW.

Exercise 1 - Installation

  1. Download SharedStopLight.py and SharedStopLight.app.

  2. Create an AG package, SharedStopLight.agpkg (zip file with .agpkg extension) containing the two files.

  3. Start a server on your local machine (see Configuration Exercise 4) and connect to it with the Venue Client (https://localhost:8000/Venues/default).

  4. Use the Venue Client to upload the AG package to the venue

    In the Venue Client:
    1. Right click the Data heading -> Add...
    2. Browse to the package -> Ok
    3. The package should show up under the Data heading
    4. Double click the package in the Data section to install Shared Stoplight

  5. Start a Shared Stoplight session

    In the Venue Client
    1. Right click the Application Sessions heading
    2. Select Shared Stoplight

  6. Join the session and test it with someone, or open two clients on your local machine

    In the Venue Client
    1. Right click the Shared Stoplight session -> Open.

Exercise 2 - Adding a Button

  1. Open the SharedStopLight.py in an editor.

  2. Make sure your local venue server is still running.

  3. Try starting the SharedStopLight.py in a command window

    SharedStopLight.py --test

    With the test flag set, we automatically create a session in the venue and do not have to manually start one in the Venue Client.

  4. Remove comments for line 122 and 130. This will add UI components for a "Yellow" button. Extend the code so the new yellow button works.

  5. Test the application from the command line

    SharedStopLight.py --test

  6. When finished, install the modified stoplight application, as in Exersice 1, and test it with someone. Or open two clients on your local machine.

Exercise 3 - Adding a Shared Title

  1. Remove comments from line 124 and 134. This will add a new text control for input under the buttons.

  2. Run

    SharedStopLight.py --test

    Note the additional UI pieces.

  3. Modify the code to set the title for all participants when you hit enter in the new text control. The title should be the same as the text entered in the text control.

    UI Hints:
    - Use EVT_TEXT_ENTER to register a callback for wxTextCtrl enter events.
    - event.GetString() gives you the string value from a text control enter event.
    - self.parent.SetTitle(string) sets the title of the frame from inside the panel.

  4. Test the application from the command line

    SharedStopLight.py --test

  5. When finished, install the modified stoplight application, as in Exersice 1, and test it with someone. Or open two clients on your local machine.


Solution: SharedStopLight_Solution.py

Exercise 4 - Creating a Group Chat

  1. The purpose of the exercise is to create shared application package for a simple group chat. The user interface has been prepared for you in following file:

    GroupChat.py

    For more UI details, see the wxPython online documentation.

Solution: GroupChat_Solution.py