PlayoVR, a VRTK-PUN-Voice Demo

A small Unity demo project using VRTK for object interaction and VR controller handling, PhotonNetwork for allowing up to 4 people to join the same scene together and PUNVoice so those people can actually talk to each other.

Changelog

• 2018-08-07
  • Updated to work with the latest version of all 3rd party dependencies
  • 3rd party dependencies are no longer part of the repository
  • Fixed gun orientation
  • Fixed/updated door handling
  • Avatars now have a player name floating above them
  • Updated configuration instructions
• 2017-08-18
  • In the last update somehow all interactable scene objects were broken. Fixed now.
• 2017-08-12
  • Manager scripts are no longer observed components but now use Photon's "Custom Properties" to sync information
  • The NetworkParentManager was removed in favor of merging its functionality with NetworkObject
  • Updated to latest version of VRTK
• 2017-07-18
  • Updated to latest version of VRTK
  • Updated to latest version of PUN and PUNVoice
  • Removed Oculus Ultilities and Avatar
• 2017-09-06
  • Fixed creation of duplicate remote players
• 2017-05-11
  • Updated to latest version of VRTK
  • Updated to latest version of the Oculus Ultilities and Avatar (1.14.0)
• 2017-05-09
  • Choose a less infamous name
• 2017-05-05
  • Gave the project a proper name
• 2017-05-04
  • Added a door to the scene
  • Fixed lighting problems with sky dome
• 2017-05-03
  • Added a "sky dome" for 360 panoramic photos
  • The spheres are now containers for 360 panoramic photos
  • Bringing a photo sphere close to your head shows a personal preview
  • Placing a photo sphere on the central pedestal causes the sky dome to change for all connected players
• 2017-04-25
  • Added NetworkSnapManager script for syncing snap actions over the network
  • The network scripts now have custom editors that show their current state which makes debugging much easier
  • The gun now animates (thanks jimthegrim)
• 2017-03-23
  • Simplified project by removing DFVoice support and voice cli arguments
• 2017-03-22
  • Added support for Photon Voice chat
• 2017-03-20
  • Changed NetworkParentableObject to stand-alone `NetworkParentManager
  • Introduced NetworkBehaviour base class for all network classes
  • Made onChangeOnly part of all network classes and made it default to false
• 2017-03-19
  • Now supporting objects that are re-parented
• 2017-03-17
  • Fixed SDKChooser
  • Split the code up in modules
  • Code can now work without DFVoice
• 2017-03-16
  • Updated to use the SDKChooser
• 2017-03-15
  • First version

Configuration

To be able to use this example project you'll have to set it up first:

1. Open the project in Unity.
2. Make sure you have TextMesh Pro installed by going to Windows > Package Manager, clicking the All tab, then selecting TextMesh Pro and clicking the install button.
3. In the menu bar click on Window > TextMeshPro > Import TMP Essential Resources and import all.
4. Clone VRTK or download as a ZIP.
5. Copy VRTK/Assets/VRTK to the Assets folder of this project.
6. For VRTK to work with any VR headsets you will need to install their respective SDKs. Read the section on 'Supported SDKs' here on how to do that.
   • Normally you will only need to follow the instructions about importing the SDKs, the project already contains all the necessary camera rigs. If you encounter problems like missing scripts on the SDKs present in the Main scene you should delete those SDKs and follow the full instructions on how to re-add them.
   • If you import the SteamVR Plugin and get a dialog about recommended project settings that just won't go away you can simply click "Ignore All".
   • If you import the SteamVR Plugin and you get an error saying "The type or namespace name SteamVR_PlayArea' could not be found" you are using a plugin version 2+ that isn't supported by VRTK right now. Instructions on how to solve this can be found here.
   • If you imported the "Oculus Integration" and you get a dialog "Update Oculus Utilities Plugin" then just select "Yes" and "Restart" (don't save changes to the scene).
7. In the Asset Store search for Photon Unity Networking Free and import all of it.
   • If you get a dialog "API Update Required" just select "I Made a Backup. Go Ahead!".
   • If you get a dialog "PUN Setup" just click Skip and Close for now.
8. In the Asset Store search for Photon Voice and import all of it.
   • If you imported the "Oculus Integration" and you get errors in Assets/Oculus/Avatar/Samples/SocialStarter just delete that entire folder.
9. In the menu bar click on Window > Photon Unity Networking > Highlight Server Settings.
10. In the Inspector window set hosting (use Best Region if you're not sure what to use) and set the AppId and Voice AppId fields to use the IDs you got from Photon.
11. Open the Main scene found in the Scenes folder in the Project window.
12. Hit Play!

Testing locally

To test locally without another computer you can create a special shortcut that will run the program in normal, Non-VR, mode:

1. In the menu bar click on File > Build Settings...
2. Click the Build button, choose a destination folder and name your executable.
3. In the Explorer window that popped up right-click on the .exe and select Create shortcut
4. Right-click on the newly created shortcut and select Properties
5. In the Target field at the very end just after .exe type a space and add -vrmode none
6. Click Ok
7. Run the executable by double-clicking the shortcut
8. Hit Play in the Unity Editor (or run the .exe instead of the shortcut)

You could also add shortcuts for the other VR modes as documented below.

Command line arguments

• -vrmode : force the program to use the specified SDK. Valid values for <NAME> are:
  • openvr (for SteamVR)
  • oculus
  • none (no VR support, will output to the monitor and use mouse and keyboard)

Using networked interactable objects

If you want to add networking to your VRTK interactable objects then you just need to follow a couple of simple steps. This assumes you already have a project that has both the VRTK and Photon Unity Networking assets (you can find them on the Unity Asset store) and that networking has already been set up. So for each object that has a VRTK_Interactable_Object script you do the following:

• From this project copy/drag the NetBase and NetVRTK folders
• Add a PhotonView script
• Add a NetworkObject script (leave the default options)
• Drag the NetworkObject script to the Observed Components of the PhotonView
• Optionally add a NetworkGrabManager script if the object can be grabbed
• Optionally add a NetworkSnapManager script if the object can be snapped to a drop zone

NetworkGrabManager

This script handles the transfer of "ownership" that Photon imposes on object. Only an object's owner is allowed to send updates about it, other can only receive updates. So to be able to pick up an object and move it we must first tell Photon that we want ownership of the object. The NetworkGrabManager does this for us.

Properties:

• Own Additional Photonviews : This can contain a list of additional PhotonView scripts that should change ownership when the player grabs the current object. This is useful for complex objects like for instance a door where the user might grab a door knob but the script for syncing the movement of the door is on the door, not the knob.
• Grab Owner : (Read Only) Shows the PUN ID of the plauer currently holding the object or 0 if it's not being held.

Requirements/suggestions:

• a VRTK_InteractableObject must exist on the same object

NetworkSnapManager

This script syncs the action of an object being snapped to a drop zone across the network. If you don't use this script it might seem that everything works fine but a) the VRTK on remote clients doesn't really know the object is being snapped and b) the moment the client that performed the snap disconnects the "illusion" disappears.

Properties:

• Snapped To : (Read Only) Shows the path/id of the object that we're snapped to.

Requirements/suggestions:

• a VRTK_InteractableObject must exist on the same object

NetworkObject

This script handles the synchronization of position, orientation and movement of an object between clients.

It is NOT necessary to use this script if you're happy with the way Photon's NetworkTransformView and NetworkRigidbodyView work! I just happen to like this script better than theirs.

Properties:

• Parent : Synchronizes changes to the location of the object in the object hierarchy. For more detail see below.
• Position : This determines the way in which the position of the object will be synchronized with the other clients. It can be set to one of the following values:
  • None : no synchronization will happen, the value will always remain unchanged
  • Set : the value will be set the moment a client receives it, no interpolation will happen
  • Lerp : the value will be gradually changed (interpolated) in the time between network updates
• Rotation : This determines the way in which the rotation of the object will be synchronized with the other clients. It can be set to the same values as men