Hive SDK 開発フロー¶
Hive SDKのインストールからアプリの配布までの全体の流れの概要は以下の通りです。
1. インストール¶
アプリに認証や支払いなどの機能を実装するには、Hive SDKを使用して、まずHiveコンソールにサインアップし、AppIDを作成します。その後、開発環境に適したHive SDKをインストールします。
インストール前の準備¶
ほとんどのHive SDK機能は、Hiveコンソールに入力されたデータを必要とします。したがって、SDKを使用するには、まずHiveコンソールにサインアップし、AppIDを作成する必要があります。
SDKのインストール¶
コンソールでAppIDを作成した後、SDKをインストールします。Hive SDKは、開発エンジン（Unity、Unreal Engineなど）やOS（Android、iOS）によって異なるインストール方法がある場合があります。たとえば、Unityエンジンでアプリを開発している場合は、SDKマネージャーを使用して最新のSDKバージョンを便利にインストールできますが、ネイティブAndroid環境でアプリを開発している場合は、Gradleを使用してSDKをインストールする必要があります。
Info
機能のインストール¶
Hive SDKのインストールを完了した後、使用するSDK機能をインストールする必要があります。SDKは、認証、支払い、プッシュ通知、プロモーション、マッチメイキングなどのさまざまな機能を提供しており、認証と支払い機能を必須として使用し、残りの機能をオプションとして使用することをお勧めします。
Note
認証機能をインストールすることは、Googleログイン、Appleログインなどの希望するアイデンティティプロバイダー（IdP）を選択することを意味します。すべてのIdPがインストールされていなくても、ゲストログインはデフォルトでサポートされています。Hive SDKを初めて使用する開発者は、ゲストログインのみを使用することでHive SDKをすぐに体験できます。
2. 環境設定¶
SDKのインストールが完了したら、SDK環境を設定します。必須設定とオプション設定があります。
（必須）基本設定： hive_config.xml¶
hive_config.xml は、SDKが機能するために必要な重要な設定値を含むファイルで、アプリのビルドに含まれています。SDKを使用するには、Hive コンソールで生成されたAppIDと、このファイルで使用するIdPを入力する必要があります。SDKは、初期化の際にアプリのビルドにhive_config.xmlを含めます。
SDKのインストールと同様に、hive_config.xmlの設定方法は、開発エンジン（Unity、Unreal Engineなど）やOS（Android、iOS）によって異なる場合があります。たとえば、Unityエンジンでアプリを開発する場合、hive_config.xmlの設定値を直接入力することなく、Unity Inspectorを使用してhive_config.xmlを生成できますが、ネイティブ環境では、このファイルを手動で作成し、値を直接入力する必要があります。
（オプション）市場特有の設定¶
PCでGoogle Play Games、Amazon、Steam（Windows）などの特定のアプリマーケットを使用する場合は、追加の設定が必要です。追加設定が必要です。
(オプション) 実行時設定¶
いくつかのSDK設定は、SDK初期化（ビルド時）ではなく、アプリの実行時に行う必要があります。 ただし、ライブサービス中に実行時設定を変更することは推奨されません。
3. 開発¶
ログ設定と開発準備を完了した後、アプリで必要な機能を実装します。アプリ全体のソースコード内でアプリライフサイクルに応じて発生するイベントをHive SDKに渡し、これらのイベントを受け取るSDKメソッドを呼び出す必要があります。以下はSDKを開発する際に知っておくべき重要な項目です。
SDKの初期化¶
SDKの初期化は、SDK機能を実行するための最初の準備ステップです。SDKのコードフローでは、初期化が最初に実行され、初期化が完了した後に、認証、支払い、プロモーションなどのさまざまなSDK機能が使用できるようになります。
SDKは、初期化プロセス中に利用規約同意画面（アプリユーザーがアプリを実行したときに表示されるデバイス識別情報収集および個人情報収集の同意ポップアップなど）を表示します。SDKの主な利点の一つは、コンプライアンスに準拠した利用規約同意要求の簡単で便利な実装を可能にすることです。
初期化が完了すると、Hive コンソールでログイン中にデバイス識別情報とサポートされている IdP のリストを確認できます。
ログイン¶
アプリのユーザーが以前に設定したIdPでログインすると、SDKはユーザー識別情報を取得します。この情報を使用してユーザーを特定し、サービスを提供できます。
ログインを実装する際には、例外処理を実装する必要があります。例外処理は、SDKの設定エラーや正常にログインしたユーザーによって引き起こされる問題に必要です。例外として扱う必要があるユーザーの例には、停止されたユーザーのログインや、アカウントの競合を解決するプロセスが含まれます。
アプリのユーザーが正常にログインした場合、ログイントークンを確認する必要があります。SDKは、ユーザーが不適切かどうかを判断するために確認できるトークンを発行し、このtoken can be verifiedを使用して、トークンが改ざんされていないかどうかを判断できます。
支払い¶
請求機能は、アプリのユーザーに販売されている商品のリストを表示し、これらの商品を購入できるようにします。アプリ内でストアを実装し、アプリ内商品を販売する際には、商品リストが公開され、販売商品の情報は国、通貨の種類、言語に基づいて異なって提供されます。各商品には、各商品の情報を区別するための商品識別コードがあります。
アプリ内ストアで製品を販売すると、SDKは領収書を発行します。あなたのアプリはこの領収書データを受け取り、領収書検証APIを呼び出して領収書を検証する必要があります。領収書が有効な場合、アプリは購入したユーザーに製品を提供します。製品の配信が完了すると、SDKは支払いトランザクションの終了を宣言します。
支払い取引の終了が宣言されると、購入の領収書は製品の復元には使用できません。アプリのユーザーがアプリ内ストアから製品を購入したが、何らかの理由で製品がユーザーに届けられていない場合、発行された領収書を使用して再度製品を届ける試みを行うことができます。
デバッグ¶
ロギングを有効にすると、開発の問題を確認し、デバッグを行うことができます。開発エンジンがUnityの場合、RTT4Uを使用してリアルタイムデバッグがサポートされています。
4. ビルド¶
ビルドする前に確認すべき項目は、開発エンジン、OS、またはビルドパイプラインに応じて異なります。たとえば、Android環境（ネイティブAndroidおよびUnity Android）では、権限がSDKに自動的に含まれるため、追加の設定は必要ありません。それに対して、ネイティブiOS環境では、アプリが使用する予定の機能に基づいて権限をビルド前に宣言する必要があります。Unity iOS環境では、必要な権限のみがHivePostProcess Editorを使用して自動的に追加できます。
Note
Android OSは多言語リソースの最適化をサポートしています。アプリから未使用の言語を削除したり、アプリに言語を追加したりできます。
5. デプロイ¶
アプリをアプリ市場（Google Play ストア、App Store など）に配布する前に、アプリが Hive プラットフォームの ポリシー に従って適切に実装されていることを確認し、アプリによって収集される 個人データの種類と目的 をアプリ市場に提出する必要があります。提出のために Hive SDK またはサードパーティライブラリで使用される個人情報ガイドを参照してください。