Collaboration

PCoIP Ultra Collaboration enables a PCoIP session user to share their session with multiple remote collaborators using Anyware Software Clients.

Up to 5 collaborators can join an ongoing PCoIP session using the same invitation.

While connected, all collaborators can view and hear the session owner's screens and audio, and see the controlling collaborator's mouse movements. If permitted by the session owner, they can also share control of the session owner's keyboard and mouse using input control.

During a collaboration session, all of the session owner's desktop screens may be shared depending on the session owner's Anyware software client display settings. See Understanding Display Behavior for more information.

Collaboration Requirements

PCoIP Ultra Collaboration is supported by all Anyware agents. Anyware software clients that support PCoIP Ultra can participate in collaboration sessions (all Anyware software clients 23.04 and higher meet this requirement).

Some collaboration features have specific version requirements for Anyware agents and Anyware software clients; these are noted below.

Feature Version Requirements

PCoIP Ultra Collaboration features depend on coordinated updates in Anyware agents and Anyware clients, so review these requirements carefully to ensure the features you need are supported by your system. We strongly recommend using the latest versions of both Anyware agent and Anyware client.

Enabling Collaboration

PCoIP Ultra Collaboration is enabled and configured on the Session Owner's desktop. Refer to the following documentation, depending on the Anyware agent you are connecting to:

• Anyware Graphics Agent for Linux -Collaboration

• Anyware Graphics Agent for macOS - Collaboration

• Anyware Graphics Agent for Windows - Collaboration

• Anyware Standard Agent for Linux - Collaboration

• Anyware Standard Agent for Windows - Collaboration

Collaboration is disabled by default. The following instructions will not work until Collaboration is enabled on the session owner's Anyware agent as described in the guides above.

Sharing Your Session With Collaborators

You can invite up to 5 collaborators to participate in your session, and optionally allow them to control your desktop.

Collaboration sessions are managed using the Collaboration manager. The collaboration manager shows you who is connected to your session, whether each collaborators can view or control the session, and allows you to invite new collaborators or stop collaborating.

To launch the Collaboration Manager:

1. Connect to a PCoIP session with PCoIP Ultra and Collaboration enabled.

2. From the remote session, open the Collaboration Manager using either of these methods:

   • From the in-session menu: From the in-session menu, select Collaborate > Invite to Collaborate.

     

     The Collaborate menu appears if both the Anyware agent and Anyware client are version 23.06 and higher, and if both support Collaboration. If the Collaborate menu does not appear, open the Collaboration Manager using the menu bar instead.

     • From the menu bar: by clicking the Anyware Collaboration icon in the menu bar:

       

       This example shows a Linux desktop; yours may vary depending on which operating system you are connecting to.

To invite collaborators, the session owner generates a collaboration invitation using the collaboration manager, and distributes the invitation to all collaborators.

About Collaboration Invitations

Collaboration invitations are created by the session owner and distributed to collaborators, who use them to join an established collaboration session.

Inviting the First Collaborator

To begin a collaboration session, generate an invitation using the Collaboration Manager.

To generate a collaboration invitation:

1. Connect to a PCoIP session with PCoIP Ultra and Collaboration enabled.

2. From the remote session, open the Collaboration Manager using either of these methods:

   • From the in-session menu: From the in-session menu, select Collaborate > Invite to Collaborate.

     

     The Collaborate menu appears if both the Anyware agent and Anyware client are version 23.06 and higher, and if both support Collaboration. If the Collaborate menu does not appear, open the Collaboration Manager using the menu bar instead.

     • From the menu bar: by clicking the Anyware Collaboration icon in the menu bar:

       

       This example shows a Linux desktop; yours may vary depending on which operating system you are connecting to.

3. The Collaboration manager generates and displays an invitation:

   

   The invitation contains two pieces of information that are used to invite the collaborator:

   • Invitation Link: The collaborator will use this link to join your session. The link may be opened on any Mac, Windows or Linux machine with a Anyware Client 21.07 or newer.

   • Invitation passcode: This is a 6-digit code that confirms the identity of the individual connecting to the collaboration session. A new code is generated along with each new token.

4. Share the invitation link and the invitation passcode with the collaborator.

   • To share both the link and the code at once, click the Copy invitation button. This will create a single message containing both the link and the code and place it on your clipboard. Share this with your collaborators using any acceptable method.

   • To share the link and code separately, click the copy button beside each item and share them using separate communications. Sharing the invitation this way reduces risk in the event that a message is inadvertently sent, forwarded, or intercepted by a third party.

Inviting Additional Collaborators

Once the collaboration session has been created, you can invite additional collaborators by sharing the same invitation link and passcode with them. You can also view the invitation, and copy its link and passcode for sharing, using the Collaboration Manager.

To view and copy the invitation link and passcode:

1. From the remote session, open the Collaboration Manager using either of these methods:

   • From the in-session menu: From the in-session menu, select Collaborate > Invite to Collaborate.

     

     The Collaborate menu appears if both the Anyware agent and Anyware client are version 23.06 and higher, and if both support Collaboration. If the Collaborate menu does not appear, open the Collaboration Manager using the menu bar instead.

     • From the menu bar: by clicking the Anyware Collaboration icon in the menu bar:

       

   The collaboration manager shows a list of your active collaborators (if any).

2. In the Collaboration manager, below the list of active collaborators, click Invite Collaborator:

   

3. The Collaboration manager displays the generated invitation. Note that this is the same invitation link and passcode you used previously. It is not a new invitation:

   

4. Share the invitation link and the invitation passcode with the additional collaborators.

Accepting or Declining Collaborators

Once distributed, the session owner's collaborators can join the collaboration session. As collaborators use the invitation, the session owner is notified and can accept or reject each connection attempt.

To respond to a collaborator:

1. When the collaborator attempts to join the session, the Collaboration manager will display options to accept or reject the connection.

   

2. Click Accept to start the collaboration session. Click Decline to deny the request. Whether you accept the request or not, the invitation has been used and is now disabled. Subsequent attempts will require a new invitation.

Ending a Collaboration Session

The collaboration session will end when the session owner disconnects their PCoIP session, or if they stop collaborating using the collaboration manager.

Ending the collaboration session invalidates the invitation. To start a new session, generate a new invitation by inviting another collaborator.

To stop collaborating:

1. From the remote session, open the Collaboration Manager using either of these methods:

   • From the in-session menu: From the in-session menu, select Collaborate > Invite to Collaborate.

     

     The Collaborate menu appears if both the Anyware agent and Anyware client are version 23.06 and higher, and if both support Collaboration. If the Collaborate menu does not appear, open the Collaboration Manager using the menu bar instead.

     • From the menu bar: by clicking the Anyware Collaboration icon in the menu bar:

       

       This example shows a Linux desktop; yours may vary depending on which operating system you are connecting to.

2. Click the Stop Collaboration button.

Allowing Collaborators to Control the Session

Collaborator input control allows collaborators to use their own mice and keyboards to control the session owner's desktop. This feature is disabled by default, and must be enabled on the Anyware agent before it is available.

Once enabled, input control options are available from the collaboration manager. Input control can be granted (or retracted) for each user separately or for all users at once.

Enabling Input Control for Collaborators

The following steps will allow one or more collaborators to take control of the session desktop. The collaborators will not immediately have control when this is granted; they must still take control using the process described above.

This option will not be available if Input Control has been disabled on the Anyware agent.

To allow collaborators to control the session desktop:

1. From the remote session, open the Collaboration Manager using either of these methods:

   • From the in-session menu: From the in-session menu, select Collaborate > Invite to Collaborate.

     

     The Collaborate menu appears if both the Anyware agent and Anyware client are version 23.06 and higher, and if both support Collaboration. If the Collaborate menu does not appear, open the Collaboration Manager using the menu bar instead.

     • From the menu bar: by clicking the Anyware Collaboration icon in the menu bar:

       

       This example shows a Linux desktop; yours may vary depending on which operating system you are connecting to.

2. Grant input control using one of these methods:

   • To allow input control for all collaborators, click the dropdown menu at the top right and select All can control.

     

   • To allow input for one collaborator, click the dropdown menu beside the collaborator's name and select Can control.

Stopping input control

To return a user (or all users) to view-only mode:

1. From an active collaboration session, open the collaboration manager.

2. Beside the collaborator's name, click the dropdown menu and select Can View.

Understanding Display Behavior

Collaboration sessions support sharing of multiple monitors, which varies by session owner's client setting as follows:

• Windowed mode: The session in the owner's client window will be shared.

• Fullscreen One Monitor: The single fullscreen session will be shared. The session owner should set their Anyware Client to Fullscreen One Monitor mode prior to starting the collaboration session.

• Fullscreen All Monitors: All monitors will be shared, beginning with the Session Owner's monitor 1 and continuing up to the number of displays in the collaborator's system. The monitors that are shared cannot be configured, and are shared in system order.

  When using this mode, the session owner should assume that collaborators can see all displays unless a specific configuration has been tested and verified.

  For example, if the session owner has four monitors and a collaborator only has two, the collaborator will see the session owner's first and second monitors. If different collaborators have a different number of screens, each will see as many displays their system supports; in this scenario, you may have some displays that are visible to certain collaborators but not others.

  The session owner should set their Anyware Client to Fullscreen All Monitors mode prior to starting the collaboration session.

If the session owner's and collaborator's screen resolutions are different, the collaborator's screen will use scrollbars and letterboxing to display the shared content.

If high performance client mode is enabled, and if the session owner's resolution is greater than the collaborator's, the collaborator's screen will be clipped instead.

Joining a Collaboration Session

Collaborators receive the invitations generated by session owners, and use the invitation URI and passcode to connect to the session.

Each collaborator can join the session with the collaboration link and the Collaboration Invitation passcode. The same URI and passcode are used for all collaborators on the same session.

To join a collaboration session as a collaborator:

1. Open a web browser and go to the collaboration link shared with you (you may be able to click this link directly, depending on how it was shared with you).

2. The web browser will warn you that the link is attempting to open the Anyware Client application. Allow the browser to open the Anyware client.

3. When the Anyware client opens, it will prompt you for your name and the Collaboration Invitation passcode. The name you provide here will identify you in the collaboration session. The collaboration invitation passcode is the six digit number provided by the session owner. Enter both values and click Submit.

4. Once the session owner accepts your connection request, the Collaboaration screen share will start.

5. To leave the collaboration session, select Connection > Disconnect from the Anyware Client menu.

Collaborator Input Control

If the session owner has enabled input control for a collaborator, the collaborator can take control of the session owner's desktop including mouse, keyboard, and pointer activity. The session owner retains the ability to stop input control at any time.

Using Input Control as a Collaborator

A collaborator who has input control can release it by idling—stopping all keyboard, mouse, and pointer activity—for a short time. Once the control timeout has elapsed, the floor is open, and whichever collaborator provides input next takes control.

By default, the control timeout is 3 seconds. The timeout value can be configured when enabling the input control feature.

For example: the session owner has initial control of the session. In order to give control to the collaborator, the owner takes their hands off the keyboard and mouse for three seconds, allowing the control timeout to pass. A collaborator then moves their mouse, which gives them control. To give control back to the session owner, the collaborator takes their hands off their keyboard and mouse for three seconds. This exchange continues as long as needed.