# CameraTwin LiveLink Setup

## Step 1: Open LiveLink Window

Open the Live Link window, by searching for it under the Window option of the Unreal Engine’s top bar

{% embed url="<https://www.youtube.com/watch?v=lg5BIxMjEfA>" %}
Search and Open LiveLink Window
{% endembed %}

<figure><img src="https://3763251240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9BAa74uZVvvtnO0Rq9Vh%2Fuploads%2Fgit-blob-eae2f7dfd117c255cffc18cd14a15707d21fe690%2FLiveLinkTab-Empty.png?alt=media" alt=""><figcaption><p>LiveLink Window</p></figcaption></figure>

## Step 2: Create CameraTwin LiveLink Source

To create a CameraTwin LiveLink Source:

1. Click the ![](https://3763251240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9BAa74uZVvvtnO0Rq9Vh%2Fuploads%2Fgit-blob-17e57bf480e97f65765bb7a95e7028f997d2d451%2FLiveLinkSource.png?alt=media) button inside the LiveLink Tab
2. Hover over the CameraTwin option
3. Select your desired CameraTwin Source from the drop-down menu
4. Click the "Ok" button

{% hint style="info" %}
The drop-down menu will be populated with all CameraTwin sources detected on your network. Please make sure that your computer and your smartphone are connected to the same Local Area Network (LAN) in order for CameraTwin to be able to detect your phone.
{% endhint %}

{% embed url="<https://www.youtube.com/watch?v=q4ffqLQdzOI>" %}
Create CameraTwin LiveLink Source
{% endembed %}

## Step 3: Add the Camera Actor of your preference

You can select between three ready-to-use Camera Actors.

1. **BP\_CT\_CameraActor**\
   A custom Cinecamera Actor with the appropriate LiveLink controllers and components to enable CameraTwin functionality. This Actor is suitable for all general purposes and Virtual Production setups.
2. **BP\_CT\_Capture\_CameraActor**\
   A specialized Camera Actor with a Scene Capture Component suitable for capturing accurate color and ray traced light effects. This Actor is suitable for use with Composure Composition layers\\
3. **BP\_CT\_Plate\_CameraActor**\
   A specialized Camera Actor with a Image Plate ready to project the Camera Stream inside the scene at a given distance. This Actor is suitable for AR compositions and easy in Scene preview of the video stream.

{% hint style="info" %}
It is possible to create custom Camera Actor setups specialized for your use-case. We recommend to start from the generic BP\_CT\_CameraActor and build up your setup.
{% endhint %}

{% hint style="info" %}
To learn more about Scene Capture Components and understand the practical differences of ***BP\_CT\_CameraActor*** and ***BP\_CT\_Capture\_CameraActor*** and their intended usage, check out our [**Scene Capture Components** page](https://docs.realtwin.org/cameratwin/documentation/unreal-engine-plugin/scene-capture-components)
{% endhint %}

## (Optional) Step 4: Select the right Source in your Camera Actor

By default when you connect just one CameraTwin Source, this source will be automatically selected in the current Level Camera Actor.

{% hint style="warning" %}
For the correct behavior only a single Camera Actor should exit in the same Level, if you need multiple Camera Actors in your level you should manually select the Source in the details panel of your desired Camera Actor every time you connect your CameraTwin source.
{% endhint %}

{ PLACEHOLDER: Image showing the source selection in the camera Actor}

<figure><img src="https://3763251240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9BAa74uZVvvtnO0Rq9Vh%2Fuploads%2Fgit-blob-ec785f366e706a639a337a71e969f43522409c66%2FCameraActor_SourceSelection.png?alt=media" alt=""><figcaption></figcaption></figure>

## (Optional) Step 5: Check Synchronization Status in The Control Panel

Open the [Control Panel](https://docs.realtwin.org/cameratwin/documentation/unreal-engine-plugin/control-panel) and check the[ Synchronization status](https://docs.realtwin.org/cameratwin/documentation/control-panel#synchronization-status) of the Connected source

{ PLACEHOLDER: Image of the Control Panel with focus on the Synchronization Status}

<figure><img src="https://3763251240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9BAa74uZVvvtnO0Rq9Vh%2Fuploads%2Fgit-blob-924fed157c65ef9ae2dfe4bc0c0db2d77fda9610%2FControlPanel_SynchronizationMessage.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
For more details about Timecode Synchronization check out [here](https://docs.realtwin.org/cameratwin/documentation/unreal-engine-plugin/cameratwin-livelink-setup/timecode-synchronization)
{% endhint %}

## Troubleshooting: Manually Setup or Check LiveLink Subjects

Setup all CameraTwin LiveLink Subjects to the LiveLink Controllers of your Actors & Composition Layers

### Camera Actor

<figure><img src="https://3763251240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9BAa74uZVvvtnO0Rq9Vh%2Fuploads%2Fgit-blob-e69ad279b221b192cb91cc00718cddcd9eb96bf4%2FBP_CameraActor?alt=media" alt=""><figcaption></figcaption></figure>

#### Pose LiveLink Controller

| Select LiveLink Subject                                                                                                                                                                                                                               | Select Component to Control                                                                                                                                                                                                                           |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <img src="https://3763251240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9BAa74uZVvvtnO0Rq9Vh%2Fuploads%2Fgit-blob-30091b84b3793f41566a27eb4c254654453e7e58%2FCTPoseSubjectSetup1.png?alt=media" alt="" data-size="original"> | <img src="https://3763251240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9BAa74uZVvvtnO0Rq9Vh%2Fuploads%2Fgit-blob-7cb75f0bcf6fd6fdb19d36df81dee5a8e2afbfb7%2FCTPoseSubjectSetup2.png?alt=media" alt="" data-size="original"> |

#### Camera Attributes LiveLink Controller

| Select LiveLink Subject                                                                                                                                                                                                                                     | Select Component to Control                                                                                                                                                                                                                                 |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <img src="https://3763251240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9BAa74uZVvvtnO0Rq9Vh%2Fuploads%2Fgit-blob-a00df45f9364c889ef28ec709fd923ab3cb0434f%2FCTAttributesSubjectSetup1.png?alt=media" alt="" data-size="original"> | <img src="https://3763251240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9BAa74uZVvvtnO0Rq9Vh%2Fuploads%2Fgit-blob-b1caf9a3158021e7569e5bda6c73c30164057fe6%2FCTAttributesSubjectSetup2.png?alt=media" alt="" data-size="original"> |

#### Stage LiveLink Controller

| Select LiveLink Subject                                                                                                                                                                                                                                | Select Component to Control                                                                                                                                                                                                                            |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <img src="https://3763251240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9BAa74uZVvvtnO0Rq9Vh%2Fuploads%2Fgit-blob-cb0b5f2c78d228030f1ddfd1c895b5f40942610d%2FCTStageSubjectSetup1.png?alt=media" alt="" data-size="original"> | <img src="https://3763251240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9BAa74uZVvvtnO0Rq9Vh%2Fuploads%2Fgit-blob-92001a5b990754a2ce9041434b887bbd70806911%2FCTStageSubjectSetup2.png?alt=media" alt="" data-size="original"> |

### Composition Layer

<figure><img src="https://3763251240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9BAa74uZVvvtnO0Rq9Vh%2Fuploads%2Fgit-blob-fe196b5bdcc7ac198d2c5db3544944a9130b1ac0%2FCompositionLayerOutline.png?alt=media" alt=""><figcaption><p>Composition Layer of CameraTwin Video Stream</p></figcaption></figure>

#### Video LiveLink Controller

<figure><img src="https://3763251240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9BAa74uZVvvtnO0Rq9Vh%2Fuploads%2Fgit-blob-f73886d39bc021acd382a7147e18e4829a9c4e3c%2FCTVideoStreamSubjectSetup.png?alt=media" alt="" width="335"><figcaption><p>Video Stream LiveLink Subject Setup</p></figcaption></figure>

### Static Mesh Actor

<figure><img src="https://3763251240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9BAa74uZVvvtnO0Rq9Vh%2Fuploads%2Fgit-blob-a6202a87dc1525b314ae18ff21948ab091be866e%2FStaticMeshOutline.png?alt=media" alt=""><figcaption><p>Static Mesh Actor with CameraTwin Video Stream Projection</p></figcaption></figure>

#### Video LiveLink Controller

| Select LiveLink Subject                                                                                                                                                                                                                                          | Select Component to Control                                                                                                                                                                                                                                      |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <img src="https://3763251240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9BAa74uZVvvtnO0Rq9Vh%2Fuploads%2Fgit-blob-399ae1b3db122ff5fca61279c7881913ac615ed6%2FCTVideoStaticMeshSubjectSetup1.png?alt=media" alt="" data-size="original"> | <img src="https://3763251240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9BAa74uZVvvtnO0Rq9Vh%2Fuploads%2Fgit-blob-08cac0bce0d43a70f536de054ec497e31a15c4bd%2FCTVideoStaticMeshSubjectSetup2.png?alt=media" alt="" data-size="original"> |

{% hint style="info" %}
Please note that you need to write the appropriate Parameter name so that the controller can set the texture to your Material. The Texture of the default material is named "Video Texture"
{% endhint %}

## Troubleshooting

{% content-ref url="../../troubleshooting/my-device-is-not-showing-up-in-the-livelink-sources-list" %}
[my-device-is-not-showing-up-in-the-livelink-sources-list](https://docs.realtwin.org/cameratwin/troubleshooting/my-device-is-not-showing-up-in-the-livelink-sources-list)
{% endcontent-ref %}
