Unity

在Unity环境中配置hive_config.xml有两种方法。

1. 使用 Unity Hive 配置编辑器自动配置 hive_config.xml 的内容
2. 手动配置 hive_config.xml

1. 使用 Unity hive 配置编辑器的自动配置¶

在Unity环境中，您可以自动创建hive_config.xml文件，并使用Unity Hive配置编辑器配置其大部分内容。然而，即使在使用Unity Hive配置编辑器时，hive_config.xml 文件中的某些值必须手动设置。

运行 Unity hive 配置编辑器¶

选择 Hive > Hive 配置 (编辑配置) 并在 编辑器 屏幕上设置必要的值。

选择执行环境¶

首先，选择应用执行环境（Android、iOS、macOS、Windows）。

常见（hive sdk 的常见特性）¶

通用选项卡允许您配置适用于Hive SDK所有功能的设置。您可以设置Hive AppID并选择服务器（生产或沙盒）。您还可以确定应用启动时显示的屏幕方向。通用选项卡中的所有设置都是必填项。

认证 (authentication)¶

Auth 选项卡是您配置设置以使用 Hive SDK 认证功能的地方。 Hive SDK 支持 IdP 登录，例如 Facebook、Google 和 QQ。选择要用于登录的 IdP 后，您需要从该 IdP 的开发者控制台（例如：Google 控制台）中检索并输入 AppId、ClientId 等信息。

例如，要使用 Google 登录，您需要从 Google 控制台 获取 Google 登录项目所需的值，并将其输入到下面所示的 Auth 选项卡中。

• 谷歌应用程序 ID：输入从谷歌控制台发出的 AppID
• 谷歌服务器客户端 ID：输入从谷歌控制台发出的 Web 应用程序的客户端 ID 值

市场（计费）¶

市场选项卡是您配置使用Hive SDK计费功能的设置的地方。Hive SDK支持Google Play商店和Apple App Store等应用市场，在此选项卡中，您需要设置进行应用内购买所需的值。

例如，如果应用程序支持 Android Lebi 市场和微信支付，您需要在市场选项卡中输入从微信控制台发出的支付密钥。

分析（市场归因）¶

分析选项卡是您配置使用Hive SDK营销归因功能的设置的地方。Hive SDK支持通过Adjust、Firebase等进行营销归因，您需要从相应的服务开发者控制台获取key和event值，并将它们输入此选项卡中。

例如，要使用 Adjust，请根据以下信息在分析选项卡中输入 Adjust 项目的所需值。

• appToken: 输入从 Adjust 控制台发出的 AppToken
• Event: 输入在 Adjust 控制台注册的事件的名称和值

可选（网络通信选项、日志记录和其他功能）¶

可选 在选项卡中，您可以输入网络通信选项、日志和使用 Hive SDK 时的其他设置。

例如，如果您想在调用Hive SDK方法时延长网络超时，请增加httpConnectTimeout和httpReadTimeout的值。作为另一个例子，当发送远程日志时，您可以更改传输周期和传输日志数据的大小，这允许您修改分析日志设置值。除非绝对必要，建议使用可选选项卡项的默认值。

保存设置并创建 hive_config.xml 文件¶

在Unity Hive 配置编辑器中完成所有选项卡设置后，点击 保存并重新生成设置文件 将自动生成 hive_config.xml 文件。

安卓¶

点击保存和重新生成设置文件将创建AndroidManifest.xml文件和hive_config.xml文件。hive_config.xml文件创建的位置取决于Unity的版本。

• Unity 2021 及以上版本: /Assets/HiveSDK/hive.androidlib/src/main/res/raw/hive_config.xml
• Unity 2021 以下版本: /Assets/Plugins/Android/res/raw/hive_config.xml

iOS¶

点击保存和重新生成设置文件 将创建 Info.plist 文件和 hive_config.xml 文件。hive_config.xml 文件将创建在下面的位置。

• /Assets/Plugins/iOS/hive_config.xml

Windows¶

按下 Windows 按钮将创建 hive_config.xml 文件。该 hive_config.xml 文件将创建在以下位置。

• /Assets/Plugins/Windows/res/hive_config.xml

2. 手动配置¶

如果您不使用 Unity Hive 配置编辑器，您将需要创建 hive_config.xml 文件，并手动设置文件中的大多数值。

hive_config.xml 文件创建¶

直接在下面的路径创建hive_config.xml文件。

• 安卓
  • Unity 2021 或更高版本: /Assets/HiveSDK/hive.androidlib/src/main/res/raw/hive_config.xml
  • 2021 年之前的 Unity: /Assets/Plugins/Android/res/raw/hive_config.xml
• iOS
  • /Assets/Plugins/iOS/hive_config.xml
• Windows
  • /Assets/Plugins/Windows/res/hive_config.xml

hive_config.xml 修改¶

请参考下一步直接修改并保存hive_config.xml文件。然而，文件中的某些值是根据开发者的需求设置的。

hive_config.xml 文件示例¶

以下是使用身份验证（Google 身份验证）和支付（Google Play 商店或 Apple AppStore）时的hive_config.xml 文件示例。请根据您要使用的 Hive SDK 功能和应用环境修改、添加或删除值。由于 iOS 仅支持 Apple AppStore 支付，因此在 Unity iOS 环境中将市场设置为 AP。

<properties>

    <!-- Hive SDK common settings: START -->
    <!-- Set game build unique identifier -->
    <appId>com.sample.your</appId>

    <!-- Select server for Hive platform. sandbox is for development, real is for commercial
        (sandbox, real) -->
    <zone>real</zone>

    <!-- Set whether to use SDK internal operation logs
        (true, false) -->
    <useLog>false</useLog>

    <!-- Set whether to apply ageGateU13
        (true, false) -->
    <ageGateU13>false</ageGateU13>

    <!-- Hive Orientation setting -->
    <hiveOrientation>landscape</hiveOrientation>

    <!-- Channel setting (login and in-app support service platform)
        (C2S: Hive platform) -->
    <channel>C2S</channel>

    <!-- Payment market setting (GO: Google Play, LE: Com2us Lebi, AP: Apple App Store) -->
    <market>GO</market>

    <!-- Set standard for receiving terms agreement
        (device, account) -->
    <agreementDetermineBase>device</agreementDetermineBase>

    <!-- Terms exposure design setting (Not set for SDK v4)
        (true, false) -->
    <!-- <authV1Agreement>true</authV1Agreement> -->

    <!-- Set sharing apps to not expose when sharing promotion UA (Android Only) -->
    <unsupportedUAShareType>
        <value>SMS</value>
        <value>URL</value>
    </unsupportedUAShareType>

    <!-- Set HTTP Connect Timeout time in seconds used internally by Hive SDK
        (Do not change unless it is a special case) -->
    <httpConnectTimeout>8</httpConnectTimeout>

    <!-- Set HTTP Read Timeout time in seconds used internally by Hive SDK
        (Do not change unless it is a special case) -->
    <httpReadTimeout>8</httpReadTimeout>
    <!-- Hive SDK common settings: END -->

    <!-- Hive SDK analytics settings: START -->
        <!-- Analytics settings, refer to analytics pre-configuration guide -->
    <!-- Hive SDK analytics settings: END -->

    <!-- Hive SDK feature settings: START -->
    <providers>
        <!-- Set authentication product, refer to authentication pre-configuration guide -->
        <!-- Set billing product, refer to billing pre-configuration guide -->
        <!-- Set marketing attribution product, refer to marketing attribution pre-configuration guide -->
    </providers>
    <!-- Hive SDK feature settings: END -->

</properties>