Skip to content

setup-guide.md

Latest commit

 

History

History
159 lines (110 loc) · 7.24 KB

setup-guide.md

File metadata and controls

159 lines (110 loc) · 7.24 KB

Setup Guide

Through this guide, you will be introduced to the basic steps for setting up the playback.

Import Package

First, extract the SDK from the .zip file, copy the HISPlayer folder and paste into the Plugins/ directory in your project’s root (If that directory doesn’t exist, create one).

Then, go into the HISPlayer directory and open the HISPlayer.uplugin file. You need to check that the Engine Version in this file matches the Unreal Engine version of your project.

⚠ Don’t worry about the full version number. The Engine Version field only cares about the major and minor version numbers. Ignore the patch number.

Example:

  1. Suppose your project uses Unreal Engine 5.5.4.
  2. Open HISPlayer.uplugin.
  3. Locate the field "Engine Version".
  4. Enter only the major and minor numbers: 5.5.0.
    • ✅ Correct: 5.5.0
    • ❌ Incorrect: 5.5.4 (the patch number .4 will be ignored anyway)

This ensures that HISPlayer is recognized as compatible with your Unreal Engine project.

If you are unsure, always use X.Y.0 where X is the major version and Y is the minor version of your Unreal Engine.

image

Open your project and go into Edit > Plugins, look for the HISPlayer plugin and if it’s disabled, enable it and restart the project.

image

Set Default Build Settings Version

It is preferable to use the HISPlayer SDK in a C++ project, rather than in an only blueprint one. To create a C++ project from an only blueprint project, go to Tools > New C++ Class and follow the indications to create a new one. Any kind of C++ parent class will work.

Make sure that the "YourProjectName".Target.cs and "YourProjectName"Editor.Target.cs scripts located in the Source directory have the following setup:

image image

The HISPlayerSample and HISPlayerVRSample are C++ projects which already include this lines of code so, in case you are using them, you can skip to the next section.

Import BP_HISPlayer

To use HISPlayer’s functionalities in your Level, you need to add the BP_HISPlayer. The is located inside Content Browser > HISPlayer Content > Blueprint.

If you can’t find the HISPlayer Content directory in the Content Browser, check “Show Plugin Content” in “View Options”.

Add the BP_HISPlayer.

image

To render the content, you need to set an actor with M_HISPlayerMat as Material.

image

Configure HISPlayer multistream properties

Set the player’s parameters as desired in your BP_HISPlayer actor for single stream and multistream. It is possible to add more than one stream using one instance of the BP_HISPlayer, by adding more elements to the Stream URL and Target Actors arrays.

You can modify the behavior of the BP_HISPlayer as desired or use a custom blueprint, as long as it follows the original structure.

Use the HISPlayer API to add your own implementation.

License Key

Input the license key that is associated with the SDK. If the license key is not valid, the player won’t work and will throw an error message.

To find this field, go to the Level Outliner and look for the BP_HISPlayer actor. Then, in the Details window, locate the HISPlayer section.

Note: If you are using the FAB marketplace package, entering a license key is not required.

image

Disable Anti-Aliasing

If you are experiencing a ghosting effect on the stream, then you will need to disable the anti-aliasing effect on your project. To do that on Unreal 5, go to Edit > Project Settings > Engine > Rendering > Default Settings > Anti-Aliasing Method and set it to None.

Default Windows Editor RHIs

To use the SDK in the Windows Editor, make sure that the Default RHIs option is settled to DirectX11 or DirectX12. Otherwise, go to Edit > Project Settings > Platforms > Windows > Targeted RHIs.

Configure Android Project Settings

Please go to Edit > Project Settings > Platforms > Android.

Make sure that you have clicked Configure Android Settings.

Both Vulkan and OpenGL ES3 are supported. You can select either Vulkan or OpenGL ES3 or both according to your project requirement.

All the Android Settings must be configurated according to your project needs.

Packaging the project

Before packaging the project, please make sure first that you are using the right NDK and JDK versions needed for your specific Unreal Engine version. You can check which ones to install on the official Unreal documentation page . If you have installed different NDK or JDK versions on your computer, you can always change the ones you are targeting on the Project Settings > Platforms > Android SDK menu.

In order to package the project, you need to make sure that Your_Project.uproject file has been correctly updated on the “Plugins” field:

You can update this file manually, or by clicking on the Update button when this message appears when opening the project with the plugin installed.

Updating the SDK

To update a HISPlayer SDK of a previous version, please follow these steps:

  • Go to your Root project folder > Plugins and delete the HISPlayer folder.
  • Paste your new HISPlayer SDK folder inside the Plugins folder.
  • Go again to your Root project folder and delete the Binaries and Intermediate folders.
  • Execute Your_Project.uproject file.

Make sure that your project is closed while doing this process.