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

วิธีการใช้ฟีเจอร์ขั้นสูง

ตั้งค่าสำหรับ Android

ในการใช้ฟีเจอร์ขั้นสูงของ Hercules ฟีเจอร์ prefab ควรเปิดใช้งานในโมดูล Android Gradle.

การตั้งค่าโปรเจกต์ Android Studio ของคุณ

  • สำหรับ Android Gradle Plugin < 4.1

    • เพิ่มสิ่งต่อไปนี้ในไฟล์ gradle.properties ของคุณ.
    android.enablePrefab=true
    
  • สำหรับ Android Gradle plugin ≥ 4.1

    • เพิ่มสิ่งต่อไปนี้ในบล็อก android ในไฟล์ build.gradle.
    android {
        ...
        buildFeatures {
            prefab true
        }
    }
    

การตั้งค่า CMake / ndk-build (เมื่อใช้ C/C++)

  • สำหรับ NDK ≥ r21
// When using CMake
find_package(hercules REQUIRED CONFIG)

target_link_libraries(
  ...
  hercules::Hercules
)

// When using Android.mk
LOCAL_SHARED_LIBRARIES := Hercules

ifneq ($(call ndk-major-at-least,21),true)
    $(call import-add-path,$(NDK_GRADLE_INJECTED_IMPORT_PATH))
endif
$(call import-module, prefab/hercules)
  • NDK < r21

เพิ่มไฟล์ Hercules.h ลงในโปรเจกต์ของคุณและใช้ลิงก์ตรงไปยังเส้นทางไฟล์ .so

// CMake
target_link_libraries(
    ...
    ${CMAKE_CURRENT_SOURCE_DIR}/../build/intermediates/merged_native_libs/${CMAKE_BUILD_TYPE}/out/lib/${ANDROID_ABI}/libHercules.so
)

// Android.mk
include $(CLEAR_VARS)
LOCAL_MODULE := Hercules
LOCAL_SRC_FILES := ../build/intermediates/merged_native_libs/debug/out/lib/$(TARGET_ARCH_ABI)/libHercules.so
include $(PREBUILT_SHARED_LIBRARY)
LOCAL_SHARED_LIBRARIES := Hercules

กำหนดค่าสำหรับ iOS

วิธีการตั้งค่า

ค้นหา .h ภายใต้เส้นทางของเฟรมเวิร์ก Hercules ที่ติดตั้งในโปรเจกต์ผ่าน CocoaPods และนำเข้ามาในโปรเจกต์
คุณสามารถเลือกและใช้หัวข้อใดก็ได้ที่รวมอยู่ในเส้นทางเป้าหมายของซิมูเลเตอร์หรืออุปกรณ์

เส้นทางคือ: ${PROJECT_ROOT_DIR}/Pods/Hercules/Hive_SDK_iOS_External_${HIVE_SDK_VERSION}/Hercules.xcframework/${SIMULATOR_OR_PHONEOS}/Hercules.framework/Headers/Hercules.h

ตั้งค่าสำหรับ Unity

การตั้งค่าโครงการ

  • เพิ่ม USE_HERCULES ลงในธงโปรเซสเซอร์ของ Unity.

    • การตั้งค่าเกม → การตั้งค่าอื่น ๆ → การคอมไพล์สคริปต์ → สัญลักษณ์การกำหนดสคริปต์

  • เปิดใช้งานอนุญาต 'unsafe' Code.

    • การตั้งค่า Player → การตั้งค่าอื่น ๆ → การคอมไพล์สคริปต์ → อนุญาต 'unsafe' Code

กำหนดค่าให้กับ Unreal

โมดูล Hercules ที่รวมอยู่ใน Hive SDK Unreal Plugin ไม่รองรับฟีเจอร์ขั้นสูงของ Hercules.
ในการใช้ฟีเจอร์ขั้นสูงของ Hercules ในสภาพแวดล้อม Unreal โปรดดูด้านล่าง.

hive::Configuration::setUseHercules(false);
  • ค้นหาหัวข้อและไลบรารีในโฟลเดอร์ Hercules ที่ตั้งอยู่ที่ด้านบนของไดเรกทอรีปลั๊กอิน และเพิ่มไปยังโปรเจกต์เกมของคุณ
  • หาก Target.Platform == UnrealTargetPlatform.Win64 ถูกตั้งค่าใน HIVESDK.Build.cs จะต้องมีการตั้งค่า .lib ตามที่แสดงด้านล่าง
PublicAdditionalLibraries.Add(ModuleDirectory + "/ThirdParty/windows/lib/Hercules.lib");