Unity
使用したいHive SDKの機能を外部ライブラリとして追加します。Hive SDKは、認証、支払い、プッシュ通知、広告バナーなど、さまざまな機能を提供します。開発者は、使用したい機能のみを選択してインストールする必要があります。ここでは、最も基本的な機能である認証と支払いの使用方法について説明します。
Hive SDKは、UnityPackageバージョンに含まれるExternal-Dependency-Manager for Unity (EDM4U)パッケージと共に配布されます。これは、EDM4U設定を使用してビルドに必要なライブラリを自動的にインストール/配布するように構成されています。EDM4Uが動作できるビルド環境が準備されていない場合は、設定する必要があります。これは、EDM4Uが提供するGUIを使用するか、Unixシェル、Bash、すなわちコマンドラインインターフェース（CLI）を通じて行うことができます。
手動インストール/アップデートのためのノート¶
Hive SDK v4 24.3.0 以降、Hive SDK Manager の代わりに Unity パッケージ を介して Hive SDK Unity をインストールまたは更新する際には、アプリをビルドする前に以下のパスにあるすべての HIVESDK_{library_name}Dependencies.xml ファイルを削除する必要があります。
- Assets/Hive_SDK_v4/Dependencies
- Assets/Hive_SDK_v4/Editor
削除されるファイルは以下の通りです:
- HIVESDK_DefaultDependencies.xml
- HIVESDK_HerculesDependencies.xml
- HIVESDK_HiveAnalyticsConsentModeDependencies.xml
- HIVESDK_HiveDataStoreDependencies.xml
- HIVESDK_HiveDeviceManagementDependencies.xml
- HIVESDK_HiveGoogleInAppReviewDependencies.xml
- HIVESDK_HiveGoogleInAppUpdateDependencies.xml
- HIVESDK_HivePromotionDependencies.xml
- HIVESDK_HiveRealNameVerificationDependencies.xml
- HIVESDK_MarketAmazonDependencies.xml
- HIVESDK_MarketAppleDependencies.xml
- HIVESDK_MarketGoogleDependencies.xml
- HIVESDK_MarketHiveStoreDependencies.xml
- HIVESDK_MarketHuaweiDependencies.xml
- HIVESDK_MarketLebiDependencies.xml
- HIVESDK_MarketOneStoreDependencies.xml
- HIVESDK_MarketSamsungDependencies.xml
- HIVESDK_ProviderAdjustDependencies.xml
- HIVESDK_ProviderAppleDependencies.xml
- HIVESDK_ProviderAppleSignInDependencies.xml
- HIVESDK_ProviderAppsFlyerDependencies.xml
- HIVESDK_ProviderFacebookDependencies.xml
- HIVESDK_ProviderFirebaseDependencies.xml
- HIVESDK_ProviderGoogleDependencies.xml
- HIVESDK_ProviderGooglePlayGamesDependencies.xml
- HIVESDK_ProviderHiveMembershipDependencies.xml
- HIVESDK_ProviderHuaweiDependencies.xml
- HIVESDK_ProviderLineDependencies.xml
- HIVESDK_ProviderQQDependencies.xml
- HIVESDK_ProviderRecaptchaDependencies.xml
- HIVESDK_ProviderSingularDependencies.xml
- HIVESDK_ProviderVKDependencies.xml
- HIVESDK_ProviderWechatDependencies.xml
- HIVESDK_ProviderWeverseDependencies.xml
- HIVESDK_PushAmazonAdmDependencies.xml
- HIVESDK_PushGoogleFcmDependencies.xml
Android¶
これはHive SDKの各製品をUnity Androidにインストールする方法に関するガイドです。
Android リゾルバ設定¶
Unityを実行し、アセット > 外部依存関係マネージャ > Androidリゾルバ > 設定メニューをクリックします。
Androidリゾルバ設定ウィンドウが表示されたら、赤でマークされた項目をデフォルト設定として確認してください。
Unityバージョン2022.2以降を使用している場合のみ、Copy and patch settingsTemplate.gradle from 2022.2項目を確認してください。Use Jetifier機能はHive SDKによって自動的にサポートされているため、選択を解除することをお勧めします。
最新バージョンのUnityでJetifierを使用するを選択すると、Unityガイドに従ってカスタムGradleプロパティテンプレートを作成する必要があります。
Hive 依存関係¶
Hive依存関係では、Hive SDKによって提供されるサービスを有効または無効にできます。Hive > Hive依存関係 (ExternalDependency)を選択します。
設定ウィンドウが表示されたら、使用したいHive機能を選択します。たとえば、Google認証とGoogle Playストアの支払い機能を使用するには、Auth SettingsでGoogle Signinを選択し、Market SettingsでGoogle PlayStoreを選択します。使用したい機能を選択したら、選択を完了するためにSaveをクリックします。
ハイブモジュール設定
| 機能 | 説明 |
|---|---|
| プロモーション | ゲームの新しいニュースやイベントを効果的に露出させる機能を提供します。 |
| Google InAppReview | Google Playのレビューを残す機能を提供します。 (Android) |
| デバイス管理 | このサービスは、ユーザーによって登録されたデバイスのみがゲームに参加できるようにします。 |
| 実名認証 | 中国からアクセスするユーザーが実名認証を行うための機能を提供します。 |
| ヘラクレス | Hiveプラットフォームゲームを対象としたゲームの不正行為検出および追跡サービスを提供します。 |
| reCAPTCHA | Google reCAPTCHAを使用してユーザーがロボットかどうかを判定し、アカウント作成を制御する機能を提供します。 |
| DataStore | このサービスは、ゲーム内で生成されたデータをキー・バリュー形式で簡単に保存および読み取ることができるストレージシステムを提供します。 |
| Google InAppUpdate | アプリを閉じずにバックグラウンドで更新する機能を提供します。 (Android) |
| Analytics Consent-Mode | 個人データ収集に対する同意が得られているかどうかを確認するための同意バナーを表示する機能を提供します。 |
| マッチメイキング | ゲームユーザーが一緒にプレイするために接続するマッチング機能を提供します。 |
| チャット | ユーザー向けにリアルタイムチャット、グループチャット、1対1チャットを含むチャット機能を提供します。 |
認証設定
| 機能 | 説明 |
|---|---|
| Hive メンバーシップ | 'Hiveでログイン' IdPを提供します。 |
| Google サインイン | 'Googleでログイン' IdPを提供します。 |
| Google Play ゲーム | 'Google Playでログイン' IdPを提供します。(Android) |
| 'Facebookでログイン' IdPを提供します。 | |
| Apple GameCenter | 'Game Centerでログイン' IdPを提供します。(iOS) |
| Apple サインイン | 'Appleでログイン' IdPを提供します。 |
| Line | 'LINEでログイン' IdPを提供します。 |
| VK | 'VKでログイン' IdPを提供します。 |
| 'QQでログイン' IdPを提供します。 | |
| 'Wechatでログイン' IdPを提供します。 | |
| Weverse | 'Weverseでログイン' IdPを提供します。 |
| Steam | 'Steamでログイン' IdPを提供します。 |
| X | 'Xでログイン' IdPを提供します。 |
| Telegram | 'Telegramでログイン' IdPを提供します。 |
| Huawei | 'Huaweiでログイン' IdPを提供します。(Android) |
プッシュ設定
| 機能 | 説明 |
|---|---|
| Google FCM | Firebase Cloud Messaging通知機能を提供します。(Android) |
| Apple APNs | Apple Push Notification Service機能を提供します。(iOS) |
| Amazon ADM | Amazon Device Messaging通知機能を提供します。(Android) |
マーケット設定
| 機能 | 説明 |
|---|---|
| Google PlayStore | Google PlayStoreの課金機能を提供します。(Android) |
| Apple AppStore | Apple AppStoreの課金機能を提供します。(iOS) |
| OneStore | OneStoreの課金機能を提供します。(Android) |
| Amazon ADM | Amazon AppStoreの課金機能を提供します。(Android) |
| Lebi | Lebiの課金機能を提供します（中国）。(Android) |
| Hive Store | PG決済機能を提供します。(Android) |
| Samsung GalaxyStore | Samsung GalaxyStoreの課金機能を提供します。(Android) |
| Huawei AppGallery | Huawei AppGalleryの課金機能を提供します。(Android) |
分析設定
| 機能 | 説明 |
|---|---|
| Adjust | Adjustを通じてマーケティングアトリビューション機能を提供します。 |
| Airbridge | Airbridgeを通じてマーケティングアトリビューション機能を提供します。 |
| AppsFlyer | AppsFlyerを通じてマーケティングアトリビューション機能を提供します。 |
| Singular | Singularを通じてマーケティングアトリビューション機能を提供します。 |
| Firebase | Firebaseを通じてマーケティングアトリビューション機能を提供します。 |
iOS¶
このガイドでは、Unity iOSに各Hive SDK製品をインストールする方法を説明します。
CocoaPodsをインストールする¶
まず、CocoaPodsをインストールします。Unityを実行し、Asset > External Dependency Manager > iOS Resolver > Install CocoaPodsメニューをクリックします。
CLI（Bashシェル）を使用してもインストールできます。
結果が以下のように表示される場合、インストールは完了です。
iOSリゾルバ設定¶
次に、CocoaPodsを設定します。CocoaPodsを使用してiOS向けに外部ライブラリを提供する際、既存の.xcodeprojファイル拡張子は.xcworkspaceに変更されます。.xcworkspace形式でビルドを進められない場合は、GUIを使用して設定を変更してみてください。ビルドPC上のUnityで実行されるCocoaPodsの適用方法が変更され、実行可能になりました。
-
Unityを実行し、Asset > External Dependency Manager > iOS Resolver > Settings メニューをクリックします。
-
iOSリゾルバー設定ウィンドウが表示されたら、Cocoapods Integration項目を.xcworkspaceに設定し、Link framework staticallyのチェックを外して、フレームワークが静的に参照されるのを避けます。
Hive 依存関係¶
Hive依存関係では、Hive SDKによって提供されるサービスを有効または無効にできます。Hive > Hive依存関係 (ExternalDependency)を選択します。
設定ウィンドウが表示されたら、使用したいHive機能を選択してください。例えば、Google認証とApple AppStore決済機能を使用するには、Auth SettingsでGoogle Signinを選択し、Market SettingsでApple AppStoreを選択します。使用したい機能を選択したら、Saveをクリックして選択を完了します。
ハイブモジュール設定
| 機能 | 説明 |
|---|---|
| プロモーション | ゲームの新しいニュースやイベントを効果的に露出させる機能を提供します。 |
| Google InAppReview | Google Playレビューを残す機能を提供します。(Android) |
| デバイス管理 | このサービスは、ユーザーによって登録されたデバイスのみがゲームに入ることを許可します。 |
| 実名確認 | 中国からアクセスするユーザーが実名確認を行う機能を提供します。 |
| ヘラクレス | Hiveプラットフォームゲームを対象としたゲームの悪用検出と追跡サービスを提供します。 |
| reCAPTCHA | Google reCAPTCHAを使用してユーザーがロボットかどうかを判断し、アカウント作成を制御する機能を提供します。 |
| DataStore | このサービスは、ゲーム内で生成されたデータをキー・バリュー形式で簡単に保存および読み取ることができるストレージシステムを提供します。 |
| Google InAppUpdate | アプリを閉じずにバックグラウンドで更新する機能を提供します。(Android) |
| アナリティクス同意モード | 個人データ収集の同意が得られたかどうかを確認するための同意バナーを表示する機能を提供します。 |
| マッチメイキング | ゲームユーザーが一緒にプレイするためのマッチング機能を提供します。 |
| チャット | ユーザー向けのリアルタイムチャット、グループチャット、1:1チャットを含むチャット機能を提供します。 |
認証設定
| 機能 | 説明 |
|---|---|
| Hive Membership | 'Hiveでログイン' IdPを提供します。 |
| Google SignIn | 'Googleでログイン' IdPを提供します。 |
| Google Play Games | 'Google Playでログイン' IdPを提供します。 (Android) |
| 'Facebookでログイン' IdPを提供します。 | |
| Apple GameCenter | 'Game Centerでログイン' IdPを提供します。 (iOS) |
| Apple SignIn | 'Appleでログイン' IdPを提供します。 |
| Line | 'LINEでログイン' IdPを提供します。 |
| VK | 'VKでログイン' IdPを提供します。 |
| 'QQでログイン' IdPを提供します。 | |
| 'Wechatでログイン' IdPを提供します。 | |
| Weverse | 'Weverseでログイン' IdPを提供します。 |
| Steam | 'Steamでログイン' IdPを提供します。 |
| X | 'Xでログイン' IdPを提供します。 |
| Telegram | 'Telegramでログイン' IdPを提供します。 |
| Huawei | 'Huaweiでログイン' IdPを提供します。 (Android) |
プッシュ設定
| 機能 | 説明 |
|---|---|
| Google FCM | Firebase Cloud Messaging通知機能を提供します。(Android) |
| Apple APNs | Apple Push Notification Service機能を提供します。(iOS) |
| Amazon ADM | Amazon Device Messaging通知機能を提供します。(Android) |
マーケット設定
| 機能 | 説明 |
|---|---|
| Google PlayStore | Google PlayStoreの課金機能を提供します。(Android) |
| Apple AppStore | Apple AppStoreの課金機能を提供します。(iOS) |
| OneStore | OneStoreの課金機能を提供します。(Android) |
| Amazon ADM | Amazon AppStoreの課金機能を提供します。(Android) |
| Lebi | Lebiの課金機能を提供します（中国）。(Android) |
| Hive Store | PG決済機能を提供します。(Android) |
| Samsung GalaxyStore | Samsung GalaxyStoreの課金機能を提供します。(Android) |
| Huawei AppGallery | Huawei AppGalleryの課金機能を提供します。(Android) |
分析設定
| 機能 | 説明 |
|---|---|
| Adjust | Adjustを通じてマーケティング帰属機能を提供します。 |
| Airbridge | Airbridgeを通じてマーケティング帰属機能を提供します。 |
| AppsFlyer | AppsFlyerを通じてマーケティング帰属機能を提供します。 |
| Singular | Singularを通じてマーケティング帰属機能を提供します。 |
| Firebase | Firebaseを通じてマーケティング帰属機能を提供します。 |
ウィンドウズ¶
Windowsパッケージをインポートした後、追加の設定は必要ありません。
Info
各Hive SDK機能（認証、請求、通知など）に関する詳細情報は、各機能ガイドを参照してください。