{{ ブランド名 }} 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

最新のSDKバージョンと各開発エンジンのサンプルアプリはダウンロードページからダウンロードできます。
最新のSDKバージョンは、Maven(Android)およびCocoapod(iOS)を通じて配布されています。

機能のインストール¶

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 Hive Config Editorを使用してhive_config.xmlを生成できますが、ネイティブ環境では、このファイルを手動で作成し、値を直接入力する必要があります。

（オプション）市場特有の設定¶

PCでGoogle Play Games、Amazon、Steam（Windows）などの特定のアプリマーケットを使用したい場合は、追加の設定が必要です。追加設定が必要です。

(オプション) 実行時設定¶

いくつかのSDK設定は、SDK初期化（ビルド時）ではなく、アプリ実行（ランタイム）時に行う必要があります。 ただし、ライブサービス中にランタイム構成値を変更することは推奨されません。

3. 開発¶

ログ設定と開発準備を完了した後、希望する機能をアプリに実装します。アプリのライフサイクルに従って発生するイベントをアプリ全体のソースコードを通じてHive SDKに渡し、これらのイベントを受信するSDKメソッドを呼び出す必要があります。以下はSDKを開発する際に知っておくべき重要な項目です。

SDKの初期化¶

SDKの初期化は、SDK機能を実行するための最初の準備ステップです。SDKのコードフローでは、初期化が最初に実行され、初期化が完了した後に、認証、支払い、プロモーションなどの各SDK機能が使用できるようになります。

SDKは、初期化プロセス中に利用規約同意画面（アプリユーザーがアプリを起動したときに表示されるデバイス識別情報収集、個人情報収集同意ポップアップなど）を表示します。SDKの主な利点の1つは、利用規約同意要求への準拠を簡単かつ便利に実装できることです。

初期化が完了したら、Hive コンソールでデバイス識別情報とログイン時にサポートされている IdP のリストを確認できます。

ログイン¶

アプリのユーザーが以前に設定したIdPでログインすると、SDKはユーザー識別情報を取得します。この情報を使用してユーザーを特定し、サービスを提供できます。

ログインを実装する際には、例外処理を実装する必要があります。例外処理は、SDKの設定エラーや正常にログインしたユーザーによって引き起こされる問題に必要です。例外として扱う必要があるユーザーの例には、停止されたユーザーのログインや、アカウントの競合を解決するプロセスが含まれます。

アプリのユーザーが正常にログインした場合、ログイントークンを検証する必要があります。SDKは、ユーザーが不適切であるかどうかを判断するために検証可能なトークンを発行し、このtoken can be verifiedを使用してトークンが改ざんされていないことを確認できます。

支払い¶

Billingは、アプリ内で販売されている商品のリストをアプリユーザーに表示し、これらの商品を購入できる機能です。アプリにストアを実装し、アプリ内商品を販売する場合、商品リストを公開し、国、通貨の種類、言語に基づいて異なる販売商品情報を提供します。各商品には商品識別コードがあり、各商品の情報を区別します。

アプリ内ストアで製品を販売すると、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 またはサードパーティライブラリで使用される個人情報ガイドを参照してください。