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 SignIn，您需要从 Google 控制台 获取 Google SignIn 项目的所需值，并将它们输入到下面所示的 Auth 选项卡中。

• Google 应用 ID：输入从 Google 控制台发出的 AppID
• Google 服务器客户端 ID：输入从 Google 控制台发出的 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

hive_config.xml 手动配置¶

即使在使用 Unity Hive 配置编辑器时，下面 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。

``` xml

<!-- Hive SDK common: START -->
<appId>com.sample.your</appId>

<gameLanguage>en</gameLanguage>

<!--* Select Hive platform's server. sandbox for development, real for live
    (sandbox, real) -->
<zone>real</zone>

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

<!--* Company settings
    (C2S: Com2uS, GVI: Com2us Holdings) -->
<company>C2S</company>

<!--* Channel settings
    (C2S: Hive platform) -->
<channel>C2S</channel>

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

<!--* Set HTTP Connect Timeout duration used internally in the Hive SDK in seconds
    (do not change unless in special cases) -->
<httpConnectTimeout>8</httpConnectTimeout>

<!--* Set HTTP Read Timeout duration used internally in the Hive SDK in seconds
    (do not change unless in special cases) -->
<httpReadTimeout>8</httpReadTimeout>

<agreementDetermineBase>device</agreementDetermineBase>
<!-- Hive SDK common settings: END -->

<!-- Hive SDK feature-specific settings: START -->
<!--* Authentication product settings: Use Google authentication -->
<providers>             
    <google playAppId="123456789012"  clientId="123456789012-abc.apps.googleusercontent.com"  serverClientId="123456789012-abc.apps.googleusercontent.com"  reversedClientId="com.googleusercontent.apps.123456789012-abc"  deviceFlowClientId="331526026701-gn1abq1ev23nqj7rdvvlaamf7ii4f3u9.apps.googleusercontent.com" />
</providers>
<!-- Hive SDK feature-specific settings: END -->