Flutter SDKでエラーを処理する
SDKから返されるエラーはすべて AdaptyErrorCode です。以下に例を示します:
デバッグ前に詳細ログを有効にしてください。 ほとんどの AdaptyError は、StoreKit、Play Billing、ネットワーク、またはバックエンドのエラーをラップしています。詳細ログを有効にすると(await Adapty().setLogLevel(AdaptyLogLevel.verbose) — ロギングを参照)、ラップされたエラーがコンソールに出力され、実際の原因が分かります。
これらの解決策で問題が解決しない場合は、サポートに連絡する前にその他の問題を参照して、より効率的にサポートできるよう手順をご確認ください。
try {
final result = await adapty.makePurchase(product: product);
} on AdaptyError catch (adaptyError) {
if (adaptyError.code == AdaptyErrorCode.paymentCancelled) {
// Cancelled
}
} catch (e) {
}
System StoreKit コード
| エラー | コード | 解決策 |
|---|---|---|
| unknown | 0 | 不明または予期しないエラーが発生したことを示すエラーコードです。 再試行するか、その他の問題セクションを参照してください。 |
| clientInvalid | 1 | クライアントが試みた操作を実行する権限がないことを示すエラーコードです。 |
| paymentCancelled | 2 | ユーザーが支払いリクエストをキャンセルしたことを示すエラーコードです。 対応は不要ですが、ビジネスロジックの観点から、ユーザーに割引を提示したり、後でリマインドしたりすることができます。 |
| paymentInvalid | 3 | 支払いパラメーターのいずれかが App Store に認識されなかったことを示すエラーです。 |
| paymentNotAllowed | 4 | ユーザーが支払いの承認を許可されていないことを示すエラーコードです。 |
| storeProductNotAvailable | 5 | リクエストしたプロダクトがストアで販売されていないことを示すエラーコードです。 アプリを再インストールしてみてください。 |
| cloudServicePermissionDenied | 6 | ユーザーがクラウドサービス情報へのアクセスを許可していないことを示すエラーコードです。 |
| cloudServiceNetworkConnectionFailed | 7 | デバイスがネットワークに接続できなかったことを示すエラーコードです。 |
| cloudServiceRevoked | 8 | ユーザーがこのクラウドサービスの使用許可を取り消したことを示すエラーコードです。 |
| privacyAcknowledgementRequired | 9 | ユーザーがまだ Apple のプライバシーポリシーに同意していないことを示すエラーコードです。 |
| unauthorizedRequestData | 10 | アプリが、必要なエンタイトルメントを持たないプロパティを使用しようとしていることを示すエラーコードです。 |
| invalidOfferIdentifier | 11 | オファーの AppStore Connect で目的のオファーを設定し、有効なオファー識別子を渡していることを確認してください。 |
| invalidSignature | 12 | 支払い割引の署名が無効であることを示すエラーコードです。 |
| missingOfferParams | 13 | 支払い割引のパラメーターが不足していることを示すエラーコードです。 |
| invalidOfferPrice | 14 | App Store Connect で指定した価格が無効になったことを示すエラーコードです。オファーは常に割引価格である必要があります。 |
カスタム Android コード
| エラー | コード | 解決策 |
|---|---|---|
| adaptyNotInitialized | 20 | Adapty.activate メソッドを使用して Adapty SDK を適切に設定する必要があります。設定方法は Flutter の場合 をご覧ください。 |
| productNotFound | 22 | このエラーは、購入リクエストされたプロダクトがストアで利用できないことを示しています。 |
| invalidJson | 23 | ペイウォールの JSON が無効です。Adapty ダッシュボードで修正してください。修正方法の詳細については、リモートコンフィグによるペイウォールのカスタマイズ をご覧ください。 |
| currentSubscriptionToUpdateNotFoundInHistory | 24 | 更新が必要な元のサブスクリプションが見つかりません。 |
| pendingPurchase | 25 | このエラーは、購入状態が購入済みではなく保留中であることを示しています。詳細については、Android Developer ドキュメントの 保留中のトランザクションの処理 をご覧ください。 |
| billingServiceTimeout | 97 | このエラーは、Google Play が応答する前にリクエストが最大タイムアウトに達したことを示しています。これは、例えば Play Billing Library の呼び出しでリクエストされたアクションの実行が遅延した場合などに発生することがあります。 |
| featureNotSupported | 98 | リクエストされた機能は、現在のデバイスの Play ストアではサポートされていません。 |
| billingServiceDisconnected | 99 | この致命的なエラーは、BillingClient を介したクライアントアプリと Google Play ストアサービスとの接続が切断されたことを示しています。 |
| billingServiceUnavailable | 102 | この一時的なエラーは、Google Play Billing サービスが現在利用できないことを示しています。ほとんどの場合、クライアントデバイスと Google Play Billing サービス間のどこかでネットワーク接続に問題があることを意味します。 |
| billingUnavailable | 103 | このエラーは、購入プロセス中にユーザーの課金エラーが発生したことを示しています。発生する例としては以下が挙げられます: 1. ユーザーのデバイス上の Play ストアアプリが古い。 2. ユーザーがサポートされていない国にいる。 3. ユーザーがエンタープライズユーザーであり、エンタープライズ管理者がユーザーによる購入を無効にしている。 4. Google Play がユーザーの支払い方法に請求できない(例:クレジットカードの有効期限が切れているなど)。 5. ユーザーが Play ストアアプリにログインしていない。 |
| developerError | 105 | これは、API の不正な使用を示す致命的なエラーです。 |
| billingError | 106 | これは、Google Play 内部の問題を示す致命的なエラーです。 |
| itemAlreadyOwned | 107 | 消耗型アイテムはすでに購入済みです。 |
| itemNotOwned | 108 | このエラーは、アイテムに対してリクエストされたアクションが失敗したことを示しています。 |
カスタム StoreKit コード
| エラー | コード | 解決策 |
|---|---|---|
| noProductIDsFound | 1000 | このエラーは、ペイウォールでリクエストしたプロダクトが App Store に登録されているにもかかわらず、いずれも購入可能な状態でないことを示します。このエラーには このエラーが発生している場合は、Fix for Code-1000 |
| productRequestFailed | 1002 | 現時点では利用可能なプロダクトを取得できません。 |
| cantMakePayments | 1003 | このデバイスではアプリ内課金が許可されていません。トラブルシューティング ガイド をご覧ください。 |
| noPurchasesToRestore | 1004 | Adapty Flutter SDK 4.0.4 で非推奨となりました:restorePurchases() はこのエラーを返さなくなりました。復元するものがない場合、このメソッドは現在のプロファイルとともに正常に完了するため、その中のアクセスレベルのステータスを確認してください。それ以前の SDK バージョンでは、このエラーは Google Play が復元する購入を見つけられなかったことを示します。 |
| cantReadReceipt | 1005 | デバイスに有効なレシートがありません。サンドボックステスト中に発生することがあります。 サンドボックスでは、実際に購入を行うまで有効なレシートファイルが存在しないため、アクセスする前に必ず購入を行ってください。サンドボックステスト中は、有効な Apple サンドボックスアカウントでデバイスにサインインしていることも確認してください。 |
| productPurchaseFailed | 1006 | プロダクトの購入に失敗しました。これは基礎となる StoreKit エラーをラップしています。実際の原因については、ラップされたエラーを確認するか(またはコンソールで確認するために詳細ログを有効にする)、上記の表の StoreKit コード 0〜14 のいずれかであることが多く、特に paymentCancelled、paymentInvalid、paymentNotAllowed、invalidOfferPrice が一般的です。特定の原因を特定できない場合は、新しい サンドボックスプロファイル を試してみてください。それでも失敗する場合は、Apple サポートにお問い合わせください。 |
| refreshReceiptFailed | 1010 | このエラーはレシートが受信されなかったことを示します。StoreKit 1 にのみ適用されます。 |
| receiveRestoredTransactionsFailed | 1011 | 購入の復元に失敗しました。 |
| billingPlanUnavailable | 1060 | iOS のみ。このデバイスまたはストアフロントでは、プロダクトがリクエストされた請求プランを提供していません。12 か月コミットメント プランには iOS 26.4 以降と Xcode 26.5 以降でビルドされたアプリが必要です。SDK 4.3.0 以降が必要です。 |
カスタムネットワークコード
| エラー | コード | 解決策 |
|---|---|---|
| notActivated | 2002 | Adapty SDKが有効化されていません。 スプラッシュスクリーンや早期のUIフックが Adapty().activateの返却前にAdaptyメソッドを呼び出している場合に最もよく発生します。実機とエミュレーターではタイミングが異なるため、この症状は断続的に発生し、エミュレーターでは再現しないことがあります。他のSDK呼び出しをスケジュールする前にactivate Futureをawaitしてください。完全なシーケンスについてはFlutter SDKの呼び出し順序を参照してください。 |
| badRequest | 2003 | 不正なリクエストです。 App Storeとの連携に必要なすべての手順を完了しているか確認してください。 |
| serverError | 2004 | サーバーエラーです。 しばらく時間をおいてから再試行してください。問題が解決しない場合は、Adaptyサポートチームにお問い合わせください。 |
| networkFailed | 2005 | ユーザーのデバイスでネットワーク接続に問題が発生していることを示すエラーです。 VPNを無効にするか、モバイルデータ通信からWiFiに切り替える(またはその逆)をお試しください。 |
| decodingFailed | 2006 | レスポンスのデコードに失敗したことを示すエラーです。 コードを確認し、送信するパラメーターが有効であることを確認してください。たとえば、無効なAPIキーを使用している場合にこのエラーが発生することがあります。 |
| encodingFailed | 2009 | リクエストのエンコードに失敗したことを示すエラーです。 |
| analyticsDisabled | 3000 | オプトアウトしているため、アナリティクスイベントを処理できません。 |
| wrongParam | 3001 | 一部のパラメーターが正しくないことを示すエラーです。 Adaptyのペイウォールビルダーを使用していてこのエラーによりペイウォールが表示できない場合は、ペイウォールビルダーでShow on deviceをオンにしてください。 もう一つの原因として、ローカルのフォールバックファイルのバージョンがSDKのバージョンと一致していない可能性があります。ダッシュボードから新しいファイルをダウンロードしてください。 |
| activateOnceError | 3005 | .activateメソッドを複数回呼び出すことはできません。 |
| profileWasChanged | 3006 | 操作中にユーザープロファイルが変更されました。 Adapty().identifyがまだ実行中の間に別のメソッドが呼び出された場合に発生します。実行中の呼び出しが間もなく切り替わるプロファイルに対して処理され、SDKがそれを拒否します。ユーザーアクションの呼び出しの前に必ずidentifyをawaitしてください。Flutter SDKの呼び出し順序を参照してください。 |
| unsupportedData | 3007 | データ形式がSDKでサポートされていないことを示すエラーです。 |
| fetchTimeoutError | 3101 | フェッチ操作がタイムアウトしたことを示すエラーです。 |
| operationInProgress | 3201 | iOSのみ。UnityではOperationInProgress。同じ種類の別の操作がまだ実行中です。 前の呼び出しがまだストアメッセージを表示している場合に showStoreMessagesから返されます。Flutter、React Native、またはUnityを参照してください。完了するまで待ってから再試行してください。SDK 4.3.0以降が必要です。 |
| resolverFailure | 3202 | iOSのみ。UnityではResolverFailure。操作に必要なリソースをSDKが見つけられませんでした。 フォアグラウンドでアクティブなウィンドウシーンが存在しない場合に showStoreMessagesから返されます。アプリがフォアグラウンドにある状態で再度メソッドを呼び出してください。SDK 4.3.0以降が必要です。 |
カスタム UI とプラグインコード
| エラー | コード | 解決策 |
|---|---|---|
| jsException | 4105 | ビルダーで作成されたペイウォールまたはオンボーディングの実行中に、JavaScript から例外がスローされました。詳細ログを有効化して、根本的な JavaScript エラーを確認してください。 |
| operationInterrupted | 9000 | この操作はシステムによって中断されました。 呼び出しを再試行してください。 |
| emptyResult | 10001 | Flutter プラグインがネイティブ SDK から空の結果を受け取りました。 呼び出しを再試行し、解決しない場合はその他の問題セクションを参照してください。 |
| internalPluginError | 10002 | Flutter プラグイン内部でエラーが発生しました。 その他の問題セクションを参照してください。 |
その他の問題
まだ解決策が見つかっていない場合は、次のステップを試してみてください。
- SDKを最新バージョンにアップグレードする: 最新のSDKバージョンは安定性が高く、既知の問題の修正も含まれているため、常に最新へのアップグレードをおすすめします。
- サポートチームに連絡するか、サポートフォーラムで開発者仲間に相談する
- support@adapty.io またはチャットからサポートチームに連絡する: SDKのアップグレードが難しい場合や、アップグレードしても解決しない場合は、サポートチームにお問い合わせください。詳細ログを有効にしてログをチームと共有すると、問題をより早く解決できます。関連するコードスニペットを添付することも可能です。