Unity Developer Guide - Rift

The Avatar Unity package contains several prefabs you can drop into your existing Unity projects. This tutorial shows you how to start using them.

void Start () {
    LocalAvatar.RecordPackets = true;
    LocalAvatar.PacketRecorded += OnLocalAvatarPacketRecorded;
}

void OnLocalAvatarPacketRecorded(object sender, args)
{
    using (MemoryStream outputStream = new MemoryStream())
    {
        BinaryWriter writer = new BinaryWriter(outputStream);
        writer.Write(packetSequence++);
        args.Packet.Write(outputStream);
        SendPacketData(outputStream.ToArray());
    }
}

void SendPacketData(byte[] data)
{
    ReceivePacketData(data);
}

void ReceivePacketData(byte[] data)
{
    using (MemoryStream inputStream = new MemoryStream(data))
    {
        BinaryReader reader = new BinaryReader(inputStream);
        int sequence = reader.ReadInt32();
        OvrAvatarPacket packet = OvrAvatarPacket.Read(inputStream);
        LoopbackAvatar.GetComponent<OvrAvatarRemoteDriver>().QueuePacket(sequence, packet);
     }
}

You can replace the default blue Avatar with a personalized Avatar using the Oculus Platform package. The base Avatar SDK OvrAvatar.cs class is already set up to load the avatar specifications of users, but we need to call Oculus Platform functions to get valid user IDs.

After getting a user ID, we then can set the oculusUserID of the Avatar accordingly. The timing is important, because we have to set the user ID before the Start() function in OvrAvatar.cs gets called.

The example below shows one way of doing this. It defines a new class that controls the platform. After modifying the sample with our new class, the Avatar SDK shows you the personalized Avatar of the current Oculus Home user instead of the default blue Avatar.

1. Import the Oculus Platform SDK Unity package into your Unity project.
2. Specify valid App IDs for both the Oculus Avatars and Oculus Platform plugins:
   1. Click Oculus Avatars > Edit Configuration and paste your App ID into the field.
   2. Click Oculus Platform > Edit Settings and paste your App ID into the field.
3. Create an empty game object called <objectname>:
   1. Click GameObject > Create Empty.
   2. Rename the game object <objectname>.
4. Click Add Component, enter New Script in the search field, and then select New Script.
5. Name the script <filename> and set Language to C Sharp.
6. Save the text below as Assets\<filename>.cs.

   using UnityEngine;
   using Oculus.Avatar;
   using Oculus.Platform;
   using Oculus.Platform.Models;
   using System.Collections;
   
   public class <classname> : MonoBehaviour {
   
       public OvrAvatar myAvatar;
   
       void Awake () {
           Oculus.Platform.Core.Initialize();
           Oculus.Platform.Users.GetLoggedInUser().OnComplete(GetLoggedInUserCallback);
           Oculus.Platform.Request.RunCallbacks();  //avoids race condition with OvrAvatar.cs Start().
       }
   
       private void GetLoggedInUserCallback(Message<User> message) {
           if (!message.IsError) {
               myAvatar.oculusUserID = message.Data.ID;
           }
       }
   }

7. In the Unity Editor, select the game object you created from the Hierarchy. The My Avatar field appears in the Inspector.
8. Drag LocalAvatar from the Hierarchy to the My Avatar field.

Handling Multiple Personalized Avatars

In a multi-user scene where each avatar has different personalizations, you already have the user IDs of all the users in your scene because you had to retrieve that data to invite them in the first place. Set the oculusUserID for each user 's Avatar accordingly.

If your scene contains multiple Avatars of the same person, such as in our LocalAvatar and RemoteLoopback sample scenes, you can iterate through all the Avatar objects in the scene to change all their oculusUserID values. Here is an example of how to modify the callback of our new class to personalize the Avatars in those two sample scenes:

using UnityEngine;
using Oculus.Avatar;
using Oculus.Platform;
using Oculus.Platform.Models;
using System.Collections;

public class <classname> : MonoBehaviour {

    void Awake () {
        Oculus.Platform.Core.Initialize();
        Oculus.Platform.Users.GetLoggedInUser().OnComplete(GetLoggedInUserCallback);
        Oculus.Platform.Request.RunCallbacks();  //avoids race condition with OvrAvatar.cs Start().
    }

    private void GetLoggedInUserCallback(Message<User> message) {
        if (!message.IsError) {
            OvrAvatar[] avatars = FindObjectsOfType(typeof(OvrAvatar)) as OvrAvatar[];
            foreach (OvrAvatar avatar in avatars) {
                avatar.oculusUserID = message.Data.ID;
            }
        }
    }
}

The Avatar Unity package contains two prefabs for Avatars: LocalAvatar and RemoteAvatar.

They are located in OvrAvatar > Content > PreFabs. The difference between LocalAvatar and RemoteAvatar is in the driver, the control mechanism behind avatar movements.

The LocalAvatar driver is the OvrAvatarDriver script, which derives Avatar movement from the logged-in user's controllers and HMD.

The RemoteAvatar driver is the OvrAvatarRemoteDriver script, which gets its Avatar movement from the packet recording and playback system.

Dynamic lighting of your Avatar ensures that your user’s Avatar looks and feels at home in your scene. The primary light in your scene is used to calculate lighting.

If you must have multiple real-time light sources, which is highly discouraged, then can set the primary light source in Unity’s lighting settings.

The _Cubemap texture is designed to work with reflection probes and applies the reflection according to the alpha channel of the roughness map.

The GripPoses sample lets you change the hand poses by rotating the finger joints until you get the pose you want. You can then save these finger joint positions as a Unity prefab that you can load at a later time.

In this example, we pose the left hand to make it look like a scissors or bunny rabbit gesture.

Creating the left hand pose:

1. Open the Samples > GripPoses > GripPoses scene.
2. Click Play.
3. Press E to select the Rotate transform tool.

4. In the Hierarchy window, expand LocalAvatar > hand_left > LeftHandPoseEditHelp > hands_l_hand_world > hands:b_l_hand.

   

5. Locate all the joints of the fingers you want to adjust. Joint 0 is closest to the palm, subsequent joints are towards the finger tip. To adjust the pinky finger joints for example, expand hands:b_l_pinky0 > hands:b_l_pinky1 > hands:b_l_pinky2 > hands:b_l_pinky3.

6. In the Hierarchy window, select the joint you want to rotate.

   

7. In the Scene window, click a rotation orbit and drag the joint to the desired angle.

   

8. Repeat these two steps until you achieve the desired pose.

Saving the left hand pose:

1. In the Hierarchy window, drag hand_l_hand_world to the Project window.
2. In the Project window, rename this transform to something descriptive, for example: poseBunnyRabbitLeft.

Using the left hand pose:

1. In the Hierarchy window, select LocalAvatar.
2. Drag poseBunnyRabbitLeft from the Project window to the Left Hand Custom Pose field in the Inspector window.

Click Play again. You see that the left hand is now frozen in our custom bunny grip pose.

To let avatars interact with objects in their environment, use the OVRGrabber and OVRGrabble components. For a working example, see the AvatarWithGrab sample scene included in the Oculus Unity Sample Framework.

To make Rift Avatars appear in stand-alone executable builds, you need to change two settings.

• Add the Avatar shaders to the Always Included Shaders list in your project settings:
  1. Click Edit > Project Settings > Graphics.
  2. Under Always Included Shaders, add +3 to the Size and then press Enter.
• Build as a 64-bit application:
  1. Click File > Build Settings.
  2. Set Architecture to x86_x64.

Once you’ve completed your integration, you can test by retrieving some Avatars in-engine. Use the following user IDs to test: