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

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

การตั้งค่า Android

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

การตั้งค่าโปรเจกต์ 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 ขึ้นไป

    // เมื่อใช้ CMake
find_package(hercules REQUIRED CONFIG)

target_link_libraries(
    ...
    hercules::Hercules
)

// เมื่อใช้ 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

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

  • ใช้ CocoaPods เพื่อค้นหา .h ในเส้นทางของเฟรมเวิร์ก Hercules ที่ติดตั้งในโปรเจกต์และทำการ import ลงในโปรเจกต์
    สามารถเลือกใช้ header ใดก็ได้ที่รวมอยู่ในเส้นทางของซิมูเลเตอร์หรืออุปกรณ์
    เส้นทางมีดังนี้ 
    `${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

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

  • ตรวจสอบเพื่ออนุญาต ‘unsafe’ Code

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

การตั้งค่า Unreal

โมดูลเฮอร์คิวลิสที่รวมอยู่ในปลั๊กอิน Hive SDK Unreal ไม่รองรับฟีเจอร์เสริมเฮอร์คิวลิส
หากต้องการใช้ฟีเจอร์เสริมเฮอร์คิวลิสในสภาพแวดล้อม Unreal โปรดดูด้านล่าง