メインコンテンツまでスキップ

AptoideBillingSDKManager

AptoideBillingSDKManager は、Unity アプリケーションにおけるアプリ内課金操作を処理するためのメインインターフェースとして機能します。購入の照会、商品詳細の取得、購入の消費、非消費型購入の承認、ユーザーの Aptoide アカウントへのサインイン管理、課金フローの管理といった操作を容易にします。さらに、アプリの更新やリファラルディープリンクのためのユーティリティも提供します。

AptoideBillingSDKManager を使用するには、必要なリスナー、公開鍵、およびクラス名を渡して InitializePlugin メソッドで初期化します。この SDK は、基盤となる Android ブリッジとの接続を管理することで、Aptoide の課金システムとのシームレスな統合を実現します。

パブリックメソッド​

InitializePlugin​

static void InitializePlugin(IAptoideBillingClientStateListener aptoideBillingClientStateListener, IConsumeResponseListener consumeResponseListener, IPurchasesUpdatedListener purchasesUpdatedListener, IPurchasesResponseListener purchasesResponseListener, IProductDetailsResponseListener productDetailsResponseListener, IAcknowledgeResponseListener acknowledgeResponseListener, IAptoideSignInResponseListener aptoideSignInResponseListener, IAptoideAccountStateListener aptoideAccountStateListener, string publicKey, string className)

必要なリスナーと設定を用いてプラグインを初期化します。

パラメータ​

名前型説明
aptoideBillingClientStateListenerIAptoideBillingClientStateListener課金状態の変更用リスナー。
consumeResponseListenerIConsumeResponseListener消費レスポンス用リスナー。
purchasesUpdatedListenerIPurchasesUpdatedListener購入更新用リスナー。
purchasesResponseListenerIPurchasesResponseListener購入照会レスポンス用リスナー。
productDetailsResponseListenerIProductDetailsResponseListener商品詳細レスポンス用リスナー。
acknowledgeResponseListenerIAcknowledgeResponseListener承認レスポンス用リスナー。
aptoideSignInResponseListenerIAptoideSignInResponseListenerAptoide アカウントのサインイン結果用リスナー。
aptoideAccountStateListenerIAptoideAccountStateListenerAptoide アカウントのサインイン状態変更用リスナー。
publicKeyString購入を検証するための公開鍵。
classNameString課金 SDK ブリッジに関連付けられたクラス名。

Initialize​

static void Initialize(string publicKey, string className)

指定された公開鍵とクラス名を用いて Android ブリッジを初期化します。

StartConnection​

static void StartConnection()

課金システムへの接続を開始します。

EndConnection​

static void EndConnection()

課金システムへの接続を終了し、リソースを解放します。

IsReady​

static bool IsReady()

課金システムが操作可能な状態かどうかを確認します。

戻り値​

システムの準備状態を示す Boolean 値。

QueryProductDetailsAsync​

static void QueryProductDetailsAsync(QueryProductDetailsParams queryProductDetailsParams)

指定した商品 ID の商品詳細を非同期で取得します。

パラメータ​

名前型説明
queryProductDetailsParamsQueryProductDetailsParams照会する購入のためのパラメータ。

LaunchBillingFlow​

static BillingResult LaunchBillingFlow(BillingFlowParams billingFlowParams)

指定した SKU の課金フローを開始します。

パラメータ​

名前型説明
billingFlowParamsBillingFlowParams課金フローのためのパラメータ。

戻り値​

受信したレスポンスの BillingResult 型の課金結果。

ConsumeAsync​

static void ConsumeAsync(ConsumeParams consumeParams)

以前に購入した商品を消費します。

パラメータ​

名前型説明
consumeParamsConsumeParams消費する購入のパラメータ。

AcknowledgeAsync​

static void AcknowledgeAsync(AcknowledgeParams acknowledgeParams)

購入を承認し、所有状態を保ったままトランザクションを確定します。一度限りの非消費型商品に対しては、ConsumeAsync の代わりにこのメソッドを使用してください。これにより、購入が返金されず、QueryPurchasesAsync によって引き続き返されるようになります。結果は IAcknowledgeResponseListener に配信されます。

この機能はリモートで切り替えられます。IsFeatureSupported(4) で利用可否を確認してください（レスポンスコード 0 は有効であることを意味します）。

パラメータ​

名前型説明
acknowledgeParamsAcknowledgeParams承認する購入のパラメータ。

IsFeatureSupported​

static BillingResult IsFeatureSupported(int feature)

特定の機能がサポートされているかどうかを確認します。

パラメータ​

名前型説明
featureint確認する機能の値。

戻り値​

受信したレスポンスの BillingResult 型の課金結果。

QueryPurchasesAsync​

static void QueryPurchasesAsync(QueryPurchasesParams queryPurchasesParams)

指定した QueryPurchasesParams に基づき、ユーザーに関連付けられた購入を非同期で取得し、iPurchasesResponseListener に返します。

パラメータ​

名前型説明
queryPurchasesParamsQueryPurchasesParams照会する購入のためのパラメータ。

SignInToAptoideServices​

static void SignInToAptoideServices()

WebView で Aptoide アカウントのサインインフローを開始します。サインインすると、ユーザーの購入がその Aptoide アカウントに紐付けられ、保留中の購入や非消費型購入が、再インストールやデバイスをまたいで QueryPurchasesAsync から取得可能になります。結果は IAptoideSignInResponseListener に配信されます。

この機能はリモートで切り替えられます。IsFeatureSupported(3) で利用可否を確認してください（レスポンスコード 0 は有効であることを意味します）。

SignOutFromAptoideServices​

static void SignOutFromAptoideServices()

ユーザーを Aptoide アカウントからサインアウトさせ、保存されているセッションをクリアし、以降のすべての操作を匿名のゲストフローに戻します。登録されている IAptoideAccountStateListener には状態 0（サインアウト済み）が通知されます。

IsSignedInToAptoideServices​

static bool IsSignedInToAptoideServices()

ユーザーが現在 Aptoide アカウントにサインインしているかどうかを確認します。

戻り値​

ユーザーがサインインしているかどうかを示す Boolean 値。

static ReferralDeeplinkResult GetReferralDeeplink()

アプリケーションに関連付けられたリファラルディープリンクを取得します。

戻り値​

ディープリンクの詳細を含む ReferralDeeplinkResult。

IsAppUpdateAvailable​

static bool IsAppUpdateAvailable()

アプリケーションの更新が利用可能かどうかを確認します。

戻り値​

更新が利用可能かどうかを示す Boolean 値。

LaunchAppUpdateDialog​

static void LaunchAppUpdateDialog()

アプリケーションの更新をユーザーに促すダイアログを表示します。

LaunchAppUpdateStore​

static void LaunchAppUpdateStore()

アプリケーションを更新するためのストアページを開きます。

コールバックハンドラー​

以下のコールバックメソッドは、Android ブリッジからのレスポンスを処理します。

  1. BillingSetupFinishedCallback: 課金のセットアップが完了したときに呼び出されます。
  2. BillingServiceDisconnectedCallback: 課金サービスが切断されたときに呼び出されます。
  3. PurchasesUpdatedCallback: 購入の更新を処理します。
  4. PurchasesResponseCallback: 購入照会の結果を処理します。
  5. ProductDetailsResponseCallback: 商品詳細に対するレスポンスを処理します。
  6. ConsumeResponseCallback: 消費操作に対するレスポンスを処理します。
  7. AcknowledgeResponseCallback: 承認操作に対するレスポンスを処理します。
  8. SignInResponseCallback: Aptoide アカウントのサインイン結果を処理します。
  9. AccountStateChangedCallback: Aptoide アカウントのサインイン状態の変更を処理します。