ข้ามไปที่เนื้อหา

Unreal Engine

คู่มือการติดตั้ง Hercules Unreal Plugin

สามารถใช้ Hercules Unreal Plugin ได้โดยเพิ่มแพ็กเกจปลั๊กอินที่แจกจ่ายลงในโปรเจกต์โดยตรง


1. ติดตั้ง HerculesPlugin

ดาวน์โหลดแพ็กเกจ HerculesPlugin สำหรับ Unreal Engine จากหน้าดาวน์โหลดโมดูล Hercules

แตกไฟล์แพ็กเกจ HerculesPlugin ที่แจกจ่าย

คัดลอกโฟลเดอร์ HerculesPlugin ที่แตกไฟล์แล้วไปยังโฟลเดอร์ Plugins ของโปรเจกต์ Unreal

หากโปรเจกต์ยังไม่มีโฟลเดอร์ Plugins ให้สร้างโฟลเดอร์ใหม่

ตัวอย่าง:

<พาธโปรเจกต์ Unreal>/
├─ Content/
├─ Plugins/
│  └─ HerculesPlugin/
│     ├─ HerculesPlugin.uplugin
│     ├─ Source/
│     └─ ...
├─ Source/
└─ <ชื่อโปรเจกต์>.uproject

2. เพิ่ม Dependency ของ HerculesPlugin

เพิ่ม Dependency HerculesPlugin ลงในไฟล์ Build.cs ของโมดูล Unreal ที่จะใช้ฟังก์ชันของ HerculesPlugin แล้วรีสตาร์ต Unreal Editor

โดยทั่วไปจะพบไฟล์ Build.cs ได้ที่ตำแหน่งต่อไปนี้ในโปรเจกต์

<พาธโปรเจกต์ Unreal>/Source/<ชื่อโมดูล>/<ชื่อโมดูล>.Build.cs

เพิ่ม HerculesPlugin ลงใน PublicDependencyModuleNames

PublicDependencyModuleNames.AddRange(new string[]
{
    // รายการโมดูลที่มีอยู่เดิม,
    "HerculesPlugin"
});

หากใช้ HerculesPlugin เฉพาะภายในโมดูลนั้น สามารถเพิ่มลงใน PrivateDependencyModuleNames ได้เช่นกัน โดยขึ้นอยู่กับการตั้งค่าของโปรเจกต์

PrivateDependencyModuleNames.AddRange(new string[]
{
    "HerculesPlugin"
});

3. ใช้ HerculesPlugin

โมดูลที่เพิ่ม Dependency ของ HerculesPlugin แล้วสามารถใช้เฮดเดอร์และ API ที่ปลั๊กอินมีให้ได้

include เฮดเดอร์ของ HerculesPlugin ที่จำเป็น แล้วจึงใช้ API

#include "HerculesPlugin.h"

4. นำ HerculesPlugin ออก

ลบ Dependency ต่อไปนี้ออกจากไฟล์ Build.cs ของโปรเจกต์

"HerculesPlugin"

จากนั้นลบโฟลเดอร์ต่อไปนี้ออกจากโปรเจกต์

<พาธโปรเจกต์ Unreal>/Plugins/HerculesPlugin