このドキュメントには、NowGGPaymentsSdkManagerクラスおよびそのメソッドのリファレンスが含まれています。
プロパティ:
Instance – クラスのインスタンスを返します。
T以下のパブリックメソッドのリファレンスが提供されています:
このメソッドは、指定された引数でnow.ggの支払いモジュールを初期化するために使用されます。
NowGGPaymentsSdkManager.Instance.InitializeIap(PAYMENT_ID)
| タイプ | パラメータ | 説明 |
|---|---|---|
| string | PAYMENT_ID | now.ggの支払いを有効にするためのアプリ固有のID。 |
このnow.ggペイメントモジュールのコールバック関数は、初期化が成功したときにトリガーされます。
戻り値の型 – Void.
Usage
NowGGPaymentsSdkManager.Instance.OnInitSuccess += OnInitSuccess;
このnow.ggペイメントモジュールのコールバック関数は、初期化が失敗したときにトリガーされます。
Usage
NowGGPaymentsSdkManager.Instance.OnInitFailed += OnInitFailed;
| Type | Param | Description |
|---|---|---|
| string | error | 初期化失敗に関連するエラーを返します。 |
このメソッドは、商品の購入を開始するために使用されます。
public void PurchaseProduct(string productId, string developerPayload=null)
{
NowGGPaymentsSdkManager.Instance.PurchaseProduct(productId, developerPayload);
}
| タイプ | パラメータ | 概要 |
|---|---|---|
| string | productId | 購入したプロダクトの固有の識別子。 |
| string | developerPayload | 注文に関する補足情報を含む、開発者が指定した文字列。 |
このコールバック関数は、購入が失敗した後にerrorCodeとerrorMessageを返します。
public void OnPurchaseFailed(int errorCode, string errorMessage)
{
Debug.Log($"OnPurchaseFailed: errorCode: {errorCode} and msg: {errorMessage}");
}
以下の表は、タイプ、レスポンスコード、メッセージ、レスポンスの説明を示しています。
| 定数 | 値 | 説明 |
|---|---|---|
| int | 0 | 正常に動作したことを示します。 |
| int | 1 | ユーザーによってプロセスがキャンセルされたか、「戻る」ボタンが押されたことを示します。 |
| int | 2 | ネットワークに問題があることを示します。 |
| int | 3 | これは、要求されたタイプに対して Payment APIバージョンがサポートされていないことを示します。 |
| int | 4 | リクエストされたアイテムが購入できないことを示します。 |
| int | 5 | 複数のシナリオを示します:i) API に提供された無効な引数 ii) now.gg課金サービス内のセットアップの問題 iii) 許可の問題など |
| int | 6 | 実行中に発生した重大なエラーを示します。 |
| int | 7 | アイテムがすでに所有されており、購入が失敗したことを示します。 |
| int | 8 | アイテムが所有されていないため、消費できない問題を示します。 |
| int | -1 | サービスは現在接続されていません。考えられる理由: i) サービスのメンテナンス ii) アプリケーションの過渡状態 |
| int | -2 | リクエストされた機能が特定のデバイス上のnow.gg課金サービスでサポートされていないことを示します。 |
| int | -3 | 最大タイムアウトが発生し、課金サービスが応答していないことを示します。 |
| int | 100 | INVALID_PAYMENT_ID – この支払いIDが無効であることを示します。 |
| int | 101 | PRODUCT_NOT_FOUND_ON_STUDIO – nowStudioで製品が見つからなかったことを示します。 |
| int | 102 | INVALID_PURCHASE_TOKEN – 提供された購入トークンが無効であることを示します。 |
| int | 103 | PRODUCT_ALREADY_CONSUMED – この製品は既に消費されたことを示します。 |
| int | 104 | PRODUCT_ALREADY_ACKNOWLEDGED – この製品は既に確認されたことを示します。 |
| int | 105 | PRODUCT_NOT_CONSUMED – 購入した製品が消費されていないことを示します。 |
| int | 106 | ACTIVE_SUBSCRIPTION_CANNOT_BE_PURCHASED_AGAIN – 有効なサブスクリプションを再購入できないことを示します。 |
| int | 107 | NO_VALID_SUBSCRIPTION_FOUND – 有効なサブスクリプションが見つからなかったことを示します。 |
| int | 108 | PAYMENT_FAILED – 支払いが失敗したことを示します。 |
| int | 109 | PAYMENT_CANCELLED – 支払いがキャンセルされたことを示します。 |
| int | 110 | PAYMENT_TIMEOUT – 支払いがタイムアウトしたことを示します。 |
| int | 1000 | INTERNAL_ERROR – 内部エラーが発生したことを示します。 |
このメソッドは、保留中の購入を確認するために使用されます。
public void ConfirmPendingPurchase(string purchasetoken, ProductType productType) {
if (productType == ProductType.Consumable) {
ConsumeProduct(purchasetoken);
} else {
AcknowledgePurchase(purchasetoken);
}
}
| Type | Param | Description |
|---|---|---|
| string | purchasetoken | 購入が成功した後に生成される購入トークン。 |
| ProductType | productType | 製品の種類: Consumable, NonConsumable, Subscription. |
このメソッドは、現在利用されているアプリ内課金(IAP)のストアタイプを返します。
NowGGPaymentsSdkManager.Instance.GetStoreType();
ストアタイプを表す文字列(String)を返します。可能な値は以下の通りです:
| 戻り値 | 説明 |
|---|---|
| onestore | ONE Store |
| amazon | Amazon Appstore |
| huawei | Huawei AppGallery |
| xiaomi | Xiaomi GetApps |
| samsung | Samsung Galaxy Store |
| nowgg | now.gg Store |
ドキュメント改訂版 1.0