Unity

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

1. Unity Hive Config Editorを使用してhive_config.xmlの内容を自動的に構成する
2. 手動でhive_config.xmlを構成する

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

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

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

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

実行環境を選択¶

まず、アプリ実行環境（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アプリID: Googleコンソールから発行されたAppIDを入力してください
• GoogleサーバークライアントID: Googleコンソールから発行されたWebアプリケーションのクライアント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

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
  • 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>false</agreementDetermineBase>

    <!-- Terms exposure design setting (Not set for SDK v4)
        (true, false) -->
    <!-- <authV1Agreement>device</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>