Question 1

Copy the PoseAI UnityAPI files

Accepted Answer

Download and copy the PoseAI UnityAPI folder of scripts  into your project's Assets folder

Question 2

Disable redundant controllers on the PlayerArmature

Accepted Answer

Select the PlayerArmature in the sample project and disable or delete the AnimationController, ThirdPersonCharacterController, and PlayerInput controllers.
We will replace the functionality of these controllers with the PoseAI controllers, and disablling them prevents two sets of controls being sent to the character. 
 
Make sure to keep the CharacterController component, as we will use that for player movement.

Question 3

Add a PoseAI SourceDirect component to the armature

Accepted Answer

Select the Player Armature, click on Add Component and add a PoseAI SourceDirect component to the armature.
 
This component sets up a UDP server to communicate with the Pose Camera app.  Each source needs to be on its own port, and you can have multiple players connect to different sources.  Character objects can share sources by using a PoseAI SourceShared component, many of which can be pointed at a particular PoseAI SourceDirect component.
 
Make sure the Rig Type is set to Unity for the Sample project mesh.  We also provide preconfigured rigs for other common options (for example most newer Mixamo rigs).
 
The Mode should be set to either Room or Portrait.  For Room mode you will film from your phone in landscape orientation and capture a wider space, although you need to back further away to be fully in the frame.  For Portrait mode, you will film from portrait orientation.  This allows you to be closer, helpful in smaller rooms, but means you can't capture much lateral movement.

Question 4

Add the PoseAI AnimatorComponent

Accepted Answer

Select the Armature again and click on Add Component.  This component allows you to use live player input to animate the character.  
 
AnimationAlpha allows you to blend between conventional animations and the live motion capture.  The script automatically blend back to zero when the camera can't find a subject.
 
UseUpperBodyOnly only animates the upper body and works well when combined with the PoseAI CharacterController.  This combines the standard state machine animation for the lower body, triggered by input events, with the player's upper body live motion capture.  This should be set to True for this demo.
 
MoveRootSideways moves the root in response the live capture movement in the camera frame (i.e. if the player moves side to side).  This should be on if you are using full body animation and also not using the CharacterController.  A use case would be showing a dance move on screen.

Question 5

Enable IK Pass on the Animator asset

Accepted Answer

Our animation component uses the IK input functions to override the standard animations, while allowing easy blending.
 
Make sure the animator component points to the Starter Assets Third Person (Animator Controller).  Open the component, click on the gear symbol in the base layer and enable the "IK Pass".

Question 6

Add the PoseAICharacterController

Accepted Answer

Select the PlayerArmature again and Add Component.  This controller is similar to the starter controller but instead of using keyboard/mouse input, it uses motion capture input to move the character.
 
There are a lot of configuration options but we suggest trying the default settings first.  We start by enabling multiple ways to trigger movement, but this can be configured through defaults or in the script.
 • You can lean to the side or twist your upper body to have your character rotate.
 • While the character is on the ground, you can jog in place and/or pump your arms up and down to move forward.  Depending on how fast you jog or pump, you will either walk forward or sprint forward
 • If you want to fly, flap your arms or do chest expansions.  Holding your arms out (i.e. T-position) will put you in glide mode, slowing your fall but giving you forward speed.  Bring your arms back to your sides to plummet. You can still lean or twist to bank into turns.
 • Jump in RL to jump in game
 • Crouching in RL is picked up but the starter animation pack does not include crouching so currently it only creates a text output in console.

Question 7

Connect Pose Camera on your phone

Accepted Answer

Open the PoseCamera app on your phone.  Go to settings (gear icon):
https://static.wixstatic.com/media/undefined

and input the IP address of the computer running the Unreal Engine:
https://static.wixstatic.com/media/undefined

This can usually be found displayed in LiveLink (but if you have multiple adapters this may not be correct).  Make sure your phone and the computer are on the same local network.
 
Close settings on your phone.  The app should show the IP address you entered at the bottom of the main screen.   You may be asked to rotate your phone sideways:
https://static.wixstatic.com/media/undefined

https://static.wixstatic.com/media/undefined

Tap to connect.  When successful connected the phone app should display "Unreal LiveLink" in place of the IP address, and say "tap to stream".   Tap to begin the stream and the app will switch to camera mode. 
 
Unsuccessful? Try our troubleshooting p(javascript:void(0))age for tips resolving common connection issues

Question 8

Begin the stream

Accepted Answer

Once connected the phone app should offer "Tap to Stream" (or ask you to rotate first).  Tap and the phone should switch to camera preview mode.  Sometimes you may need to try to connect a couple times, particularly after stopping/restarting Unity.

For Room or Portrait ensure the full body, head to feet, is visible.  For Desktop mode ensure the camera can see the head to pelvis and ideally both elbows.  The segmented human icon overlaying camera preview turns blue when a subject is visible and shows which limbs are currently poseable - if it is grey you need to reposition the camera or the person. 
https://static.wixstatic.com/media/undefined
Within the scripts you can access these visibility parameters.  For instance, in the PoseAIAnimationComponent we check if the torso is visible, and if not we fade to standard animations.

Question 9

Play the demo level

Accepted Answer

Get on camera and try to move your character around using mocap input.

Question 10

(Optional) Try mirror mode

Accepted Answer

Also, we suggest you try full body capture mode with some setup changes.
1. disable the PoseAIMovementComponent
2. set the PoseAIAnimationSource to mirror mode and full body (restart the scene).
Now the character should face you and mirror your actions.  Try some dance moves to see what the character can do.