# The TV Actor

Bring your architectural scenes to life by adding functional televisions that can play your custom video files. The BP\_TVActor is a complete, ready-to-use asset that handles video playback, sound, and user interaction.

**Key Features**

* **Play Any Video:** Supports standard video formats (e.g., .mp4).
* **Multiple Video Sources:** Create a playlist or a selection of multiple video files for a single TV.
* **Independent Control:** Each TV actor in your level can have its own unique playlist and playback status.

***

#### **Setup & Workflow**

Follow this step-by-step guide to set up a working TV in your level.

**Step 1: Prepare Your Video Files**

Before adding the TV to your level, you must import your video files into the project correctly.

1. Using your computer's File Explorer, navigate to your project's main folder and create a new folder named **Movies**. Place all your video files (e.g., MyVideo.mp4) inside this folder.
2.

```
<figure><img src="/files/NRk2U0FT3wNQQM7Fg84A" alt=""><figcaption></figcaption></figure>
```

3. Now, open your project in Unreal Engine. In the **Content Browser**, you will see the new Movies folder. Drag your video files from the **File Explorer** and drop them directly into the **Movies folder inside the Content Browser**.
4. Unreal Engine will automatically create a **File Media Source** asset for each video. You can rename these assets for better organization.

<figure><img src="/files/1KoOBpTVfTHIiHmMEgz6" alt=""><figcaption></figcaption></figure>

**Step 2: Add and Configure the TV Actor**

1. **Locate the Actor:** In the Content Browser, navigate to:\ <mark style="color:purple;">**/ShikorDriftXR/Common/Blueprints/Movies**</mark>
2. **Add to Level:** Find the **BP\_TVActor** and drag and drop it into your level. Position and scale it as needed.
3. **Configure the Details Panel:** Select the BP\_TVActor in your level to see its properties in the Details panel.

<figure><img src="/files/VZRa9SjT5n1Ahj0BpI0T" alt="" width="403"><figcaption></figcaption></figure>

* **Media Sources:** This is the most important setting. Click the + icon to add elements to the array, and assign the **File Media Source** assets you created in Step 1 to each slot.
  * Note: You can add as many different media sources as you like to create a playlist or a selection for the user.
* **Video Texture:** This property tells the TV which material to use for displaying the video. You must select the **MT\_TVVideoOutput** Video Texture here.
* **Screen Off Material:** This is the material that will be displayed on the TV screen when no video is playing.

Your TV is now set up and ready to play!

***

#### **⚠️ Important: Duplicating TVs in Your Level**

If you want to have multiple TVs in your level that can play different videos simultaneously, you **must create a unique Video Texture for each TV**.

If you simply duplicate a TV, both TVs will share the same video texture and will always show the same video.

**How to do it correctly:**

1. Navigate to the <mark style="color:purple;background-color:$primary;">**/ShikorDriftXR/Common/Blueprints/Movies/Textures**</mark> folder.
2. You will find the default MT\_TVVideoOutput Video Texture. Right-click on it and select **Duplicate**.
3. Rename the new material (e.g., MT\_TVVideoOutput\_2).
4. In the Details panel of your second TV actor, assign this new, duplicated material (MT\_TVVideoOutput\_2) to the **Video Texture** property.

As shown in the image below, you should have one unique video texture for each TV in your level.

<figure><img src="/files/l5odi7G8n5TvMq82yyFs" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://shikorviz.gitbook.io/shikordriftxr/the-tv-actor.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
