跳轉至

如何使用高级功能

設定 Android

要使用 Hercules 附加功能，Android Gradle 模块必须启用 prefab 功能。

設定 Android Studio 專案

  • 使用 Android Gradle Plugin 4.1 以下时

    • 在 gradle.properties 文件中添加如下内容。

      android.enablePrefab=true

  • 使用 Android Gradle 插件 4.1 或更高版本

    • 在 build.gradle 文件中的 android 块中添加如下内容。

      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 在專案中安裝的 Hercules 框架的路徑下尋找 .h 並將其導入到專案中。
    可以隨意選擇包含在模擬器或設備目標路徑中的任何標頭來使用。
    路徑如下所示。 
    `${PROJECT_ROOT_DIR}/Pods/Hercules/Hive_SDK_iOS_External_${HIVE_SDK_VERSION}/Hercules.xcframework/${SIMULATOR_OR_PHONEOS}/Hercules.framework/Headers/Hercules.h`

設定 Unity

設定專案設定

  • 在 Unity 預處理器標誌中添加 USE_HERCULES。

    • 玩家設置 → 其他設置 → 腳本編譯 → 腳本定義符號

  • 允许‘不安全’代码的选项被勾选。

    • 玩家设置 → 其他设置 → 脚本编译 → 允许‘不安全’代码

設定 Unreal

Hive SDK Unreal Plugin包含的海克力斯模块不支持海克力斯附加功能。
要在Unreal环境中使用海克力斯附加功能，请参考以下内容。