Unity

Unity環境でhive_config.xmlを設定する方法は2つあります。

1. Unity Hive Config Editorを使用しての内容を自動的に設定する
2. 手動でを設定する

1. Unityハイブ設定エディタによる自動構成¶

Unity環境では、hive_config.xmlファイルを自動的に生成し、Unity Hive Config Editorを使用してそのほとんどの内容を構成できます。ただし、Unity Hive Config Editorを使用している場合でも、hive_config.xml ファイルの一部の値は手動で設定する必要があります。

Unityハイブ設定エディタの実行¶

Hive を選択 > Hive 設定 (設定を編集) を選択し、エディタ画面で必要な値を設定します。

実行環境を選択¶

まず、アプリ実行環境（Android、iOS、macOS、Windows）を選択します。

共通 (ハイブSDKの共通機能)¶

共通タブは、Hive SDKのすべての機能に適用される設定を構成する場所です。Hive AppIDを設定し、サーバー（本番またはサンドボックス）を選択できます。また、アプリが起動したときに表示される画面の向きを決定することもできます。共通タブのすべての設定は必ず入力する必要があります。

認証 (authentication)¶

Auth タブは、Hive SDK 認証機能を使用するための設定を構成する場所です。 Hive SDK は、Facebook、Google、QQ などの IdP ログインをサポートしています。ログインに使用する IdP を選択した後、この IdP の開発者コンソール（例：Google コンソール）から AppId、ClientId などを取得して入力する必要があります。

例えば、Google SignInを使用するには、Google ConsoleからGoogle SignInアイテムに必要な値を取得し、以下に示すようにAuthタブに入力する必要があります。

• Google App Id: Googleコンソールから発行されたAppIDを入力してください
• Google Server Client ID: Googleコンソールから発行されたWebアプリケーションのClient ID値を入力してください

マーケット (請求)¶

マーケットタブは、Hive SDKの請求機能を使用するための設定を構成する場所です。Hive SDKは、Google PlayストアやApple App Storeなどのアプリ市場をサポートしており、このタブではアプリ内購入に必要な値を設定する必要があります。

例えば、アプリがAndroid LebiマーケットとWechat Payの支払いをサポートしている場合、マーケットタブにWechatコンソールから発行されたPayment Keyを入力する必要があります。

アナリティクス (マーケティングアトリビューション)¶

分析タブでは、Hive SDKのマーケティング帰属機能を使用するための設定を構成できます。Hive SDKは、Adjust、Firebaseなどを通じてマーケティング帰属をサポートしており、それぞれのサービス開発者コンソールからkeyとeventの値を取得し、このタブに入力する必要があります。

例えば、Adjustを使用するには、以下の情報に従ってAnalyticsタブのAdjust項目に必要な値を入力してください。

• appToken: Adjustコンソールから発行されたAppTokenを入力してください
• Event: Adjustコンソールに登録されたイベントの名前と値を入力してください

オプション（ネットワーク通信オプション、ログ記録、その他の機能）¶

オプション タブでは、Hive SDKを使用する際のネットワーク通信オプション、ログ、およびその他の設定を入力できます。

例えば、Hive SDKメソッドを呼び出す際にネットワークタイムアウトを延長したい場合は、httpConnectTimeoutとhttpReadTimeoutの値を増やしてください。もう一つの例は、リモートログ送信中に送信サイクルと送信されるログデータのサイズを変更する場合で、分析ログ設定値を修正できます。絶対に必要でない限り、オプショナルタブ項目のデフォルト値を使用することをお勧めします。

設定を保存し、hive_config.xmlファイルを作成する¶

Unity Hive Config Editorのすべてのタブ設定を完了した後、設定ファイルを保存して再生成をクリックすると、自動的に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ボタンはhive_config.xmlファイルを作成します。hive_config.xmlファイルは以下の場所に作成されます。

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

hive_config.xml 手動設定¶

Unity Hive Config Editorを使用している場合でも、hive_config.xmlファイル内の以下の値のいくつかは手動で設定する必要があります。

2. 手動設定¶

Unity Hive Config Editor を使用しない場合は、hive_config.xml ファイルを作成し、ファイル内のほとんどの値を手動で設定する必要があります。

hive_config.xml ファイルの作成¶

以下のパスに直接hive_config.xmlファイルを作成してください。

• Android
  • Unity 2021以降: /Assets/HiveSDK/hive.androidlib/src/main/res/raw/hive_config.xml
  • Unity 2021以前: /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 の修正¶

Nextを参照し、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 -->