ÿÿ Flutter での゚ラヌ凊理 | Adapty ドキュメント
English äž­æ–‡TÃŒrkçeРусскОйEspañol日本語Tiếng Việt

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 コヌド

゚ラヌコヌド解決策
unknown0䞍明たたは予期しない゚ラヌが発生したこずを瀺す゚ラヌコヌドです。
再詊行するか、その他の問題セクションを参照しおください。
clientInvalid1クラむアントが詊みた操䜜を実行する暩限がないこずを瀺す゚ラヌコヌドです。
paymentCancelled2

ナヌザヌが支払いリク゚ストをキャンセルしたこずを瀺す゚ラヌコヌドです。

察応は䞍芁ですが、ビゞネスロゞックの芳点から、ナヌザヌに割匕を提瀺したり、埌でリマむンドしたりするこずができたす。

paymentInvalid3支払いパラメヌタヌのいずれかが App Store に認識されなかったこずを瀺す゚ラヌです。
paymentNotAllowed4ナヌザヌが支払いの承認を蚱可されおいないこずを瀺す゚ラヌコヌドです。
storeProductNotAvailable5リク゚ストしたプロダクトがストアで販売されおいないこずを瀺す゚ラヌコヌドです。
アプリを再むンストヌルしおみおください。
cloudServicePermissionDenied6ナヌザヌがクラりドサヌビス情報ぞのアクセスを蚱可しおいないこずを瀺す゚ラヌコヌドです。
cloudServiceNetworkConnectionFailed7デバむスがネットワヌクに接続できなかったこずを瀺す゚ラヌコヌドです。
cloudServiceRevoked8ナヌザヌがこのクラりドサヌビスの䜿甚蚱可を取り消したこずを瀺す゚ラヌコヌドです。
privacyAcknowledgementRequired9ナヌザヌがただ Apple のプラむバシヌポリシヌに同意しおいないこずを瀺す゚ラヌコヌドです。
unauthorizedRequestData10アプリが、必芁な゚ンタむトルメントを持たないプロパティを䜿甚しようずしおいるこずを瀺す゚ラヌコヌドです。
invalidOfferIdentifier11

オファヌの identifier が無効です。たずえば、該圓する識別子のオファヌが App Store に蚭定されおいない堎合や、オファヌが取り消されおいる堎合などが該圓したす。

AppStore Connect で目的のオファヌを蚭定し、有効なオファヌ識別子を枡しおいるこずを確認しおください。

invalidSignature12支払い割匕の眲名が無効であるこずを瀺す゚ラヌコヌドです。
missingOfferParams13支払い割匕のパラメヌタヌが䞍足しおいるこずを瀺す゚ラヌコヌドです。
invalidOfferPrice14App Store Connect で指定した䟡栌が無効になったこずを瀺す゚ラヌコヌドです。オファヌは垞に割匕䟡栌である必芁がありたす。

カスタム Android コヌド

゚ラヌコヌド解決策
adaptyNotInitialized20Adapty.activate メ゜ッドを䜿っお Adapty SDK を正しく蚭定する必芁がありたす。蚭定方法に぀いおは Flutter 向けの手順 をご芧ください。
productNotFound22賌入しようずしたプロダクトがストアで芋぀からないこずを瀺す゚ラヌです。
invalidJson23ペむりォヌルの JSON が無効です。Adapty ダッシュボヌドで修正しおください。修正方法に぀いおは リモヌトコンフィグによるペむりォヌルのカスタマむズ を参照しおください。
currentSubscriptionToUpdateNotFoundInHistory24曎新が必芁な元のサブスクリプションが芋぀かりたせん。
pendingPurchase25賌入状態が「賌入枈み」ではなく「保留䞭」であるこずを瀺す゚ラヌです。詳现に぀いおは Android Developer ドキュメントの 保留䞭のトランザクションの凊理 ペヌゞを参照しおください。
billingServiceTimeout97Google Play が応答する前にリク゚ストが最倧タむムアりトに達したこずを瀺す゚ラヌです。Play Billing Library の呌び出しで芁求されたアクションの実行に遅延が発生した堎合などに起こりたす。
featureNotSupported98珟圚のデバむス䞊の Play Store では、芁求された機胜がサポヌトされおいたせん。
billingServiceDisconnected99BillingClient を介したクラむアントアプリず Google Play ストアサヌビスの接続が切断されたこずを瀺す臎呜的な゚ラヌです。
billingServiceUnavailable102Google Play Billing サヌビスが珟圚利甚できないこずを瀺す䞀時的な゚ラヌです。ほずんどの堎合、クラむアントデバむスず Google Play Billing サヌビス間のどこかでネットワヌク接続の問題が発生しおいたす。
billingUnavailable103

賌入凊理䞭にナヌザヌの課金゚ラヌが発生したこずを瀺す゚ラヌです。発生する䟋ずしおは以䞋が挙げられたす

1. ナヌザヌのデバむス䞊の Play ストアアプリが叀い。

2. ナヌザヌがサポヌトされおいない囜にいる。

3. ナヌザヌが䌁業ナヌザヌであり、䌁業管理者が賌入を無効にしおいる。

4. Google Play がナヌザヌの支払い方法に請求できないクレゞットカヌドの有効期限切れなど。

5. ナヌザヌが Play ストアアプリにログむンしおいない。

developerError105API の誀った䜿甚を瀺す臎呜的な゚ラヌです。
billingError106Google Play 自䜓の内郚的な問題を瀺す臎呜的な゚ラヌです。
itemAlreadyOwned107消耗型アむテムはすでに賌入枈みです。
itemNotOwned108アむテムに察しお芁求されたアクションが倱敗したこずを瀺す゚ラヌです。

カスタム StoreKit コヌド

゚ラヌコヌド解決策
noProductIDsFound1000

この゚ラヌは、ペむりォヌルでリク゚ストしたプロダクトがApp Storeに登録されおいるにもかかわらず、賌入できる状態にないこずを瀺したす。この゚ラヌにはInvalidProductIdentifiersの譊告が䌎う堎合がありたす。゚ラヌなしで譊告だけが衚瀺される堎合は無芖しおください。

この゚ラヌが発生しおいる堎合は、コヌド1000 noProductIDsFound ゚ラヌの修正方法セクションの手順に埓っおください。

noProductsFound1001この゚ラヌは、賌入しようずしたプロダクトがストアで利甚できないこずを瀺したす。
productRequestFailed1002珟圚、利甚可胜なプロダクトを取埗できたせん。
cantMakePayments1003このデバむスではアプリ内課金が蚱可されおいたせん。トラブルシュヌティングガむドをご芧ください。
noPurchasesToRestore1004この゚ラヌは、App Storeが埩元すべき賌入を芋぀けられなかったこずを瀺したす。
cantReadReceipt1005

デバむス䞊に有効なレシヌトがありたせん。これはサンドボックステスト䞭に発生するこずがありたす。

サンドボックスでは実際に賌入を行うたで有効なレシヌトファむルが存圚しないため、アクセスする前に必ず1回賌入しおください。たた、サンドボックステスト䞭は有効なAppleサンドボックスアカりントでデバむスにサむンむンしおいるこずを確認しおください。

productPurchaseFailed1006プロダクトの賌入に倱敗したした。この゚ラヌは内郚のStoreKit゚ラヌをラップしおいたす。ラップされた゚ラヌを確認するかたたは詳现ログを有効にしおコン゜ヌルで確認するか、実際の原因を特定しおください。ラップされた゚ラヌは通垞、䞊蚘の衚にあるStoreKitコヌド0〜14のいずれかで、特にpaymentCancelled、paymentInvalid、paymentNotAllowed、invalidOfferPriceãÿÿŒå€šã„です。原因を特定できない堎合は新しいサンドボックスプロファむルを詊しおください。それでも倱敗する堎合はAppleサポヌトにお問い合わせください。
missingOfferSigningParams1007

この゚ラヌはAdaptyのむンテグレヌションたたはオファヌに問題があるこずを瀺したす。

蚭定方法に぀いおは、App Storeむンテグレヌションの蚭定ずオファヌをご参照ください。

refreshReceiptFailed1010この゚ラヌはレシヌトが受信されなかったこずを瀺したす。StoreKit 1にのみ適甚されたす。
receiveRestoredTransactionsFailed1011賌入の埩元に倱敗したした。

カスタムネットワヌクコヌド

゚ラヌコヌド解決策
notActivated2002Adapty SDK が有効化されおいたせん。
スプラッシュスクリヌンや初期の UI フックが Adapty().activate の完了前に Adapty のメ゜ッドを呌び出しおいる堎合によく芋られたす。実機ず゚ミュレヌタヌでタむミングが異なるため、症状が断続的に発生し、゚ミュレヌタヌでは再珟しないこずがありたす。他の SDK 呌び出しをスケゞュヌルする前に activate の Future を await しおください。詳现な順序に぀いおは Flutter SDK の呌び出し順序 を参照しおください。
badRequest2003リク゚ストが䞍正です。
App Store ずの連携 に必芁なすべおの手順が完了しおいるこずを確認しおください。
serverError2004サヌバヌ゚ラヌです。
しばらく経っおから再詊行しおください。問題が解決しない堎合は、Adapty サポヌトチヌムにお問い合わせください。
networkFailed2005ナヌザヌのデバむスのネットワヌク接続に問題があるこずを瀺す゚ラヌです。
VPN を無効にするか、モバむル通信から Wi-Fi に切り替えるか、たたはその逆を詊しおください。
decodingFailed2006レスポンスのデコヌドに倱敗したこずを瀺す゚ラヌです。
コヌドを確認し、送信するパラメヌタヌが有効であるこずを確かめおください。たずえば、この゚ラヌは無効な API キヌを䜿甚しおいる堎合に発生するこずがありたす。
encodingFailed2009リク゚ストの゚ンコヌドに倱敗したこずを瀺す゚ラヌです。
analyticsDisabled3000オプトアりト しおいるため、アナリティクスむベントを凊理できたせん。
wrongParam3001䞀郚のパラメヌタヌが正しくないこずを瀺す゚ラヌです。
Adapty のペむりォヌルビルダヌを䜿甚しおいおこの゚ラヌでペむりォヌルを衚瀺できない堎合は、ペむりォヌルビルダヌの Show on device をオンにしおください。
もう䞀぀の原因ずしお、ロヌカルのフォヌルバックファむルのバヌゞョンが SDK バヌゞョンず䞀臎しおいないこずが考えられたす。ダッシュボヌドから新しいファむルをダりンロヌドしおください。
activateOnceError3005.activate メ゜ッドを耇数回呌び出すこずはできたせん。
profileWasChanged3006凊理䞭にナヌザヌプロファむルが倉曎されたした。
Adapty().identify の実行䞭に別のメ゜ッドを呌び出すず発生したす。進行䞭の呌び出しが間もなく切り替わるプロファむルに察しお凊理を行い、SDK がそれを拒吊したす。ナヌザヌ操䜜に関わる呌び出しを行う前に必ず identify を await しおください。詳しくは Flutter SDK の呌び出し順序 を参照しおください。
unsupportedData3007SDK がサポヌトしおいないデヌタ圢匏であるこずを瀺す゚ラヌです。
persistingDataError3100デヌタの保存䞭に゚ラヌが発生したした。
fetchTimeoutError3101フェッチ操䜜がタむムアりトしたこずを瀺す゚ラヌです。

その他の問題

ただ解決策が芋぀かっおいない堎合は、次のステップを詊しおみおください。

  • SDKを最新バヌゞョンにアップグレヌドする: 最新のSDKバヌゞョンは安定性が高く、既知の問題の修正も含たれおいるため、垞に最新ぞのアップグレヌドをおすすめしたす。
  • サポヌトチヌムに連絡するか、サポヌトフォヌラムで開発者仲間に盞談する
  • support@adapty.io たたはチャットからサポヌトチヌムに連絡する: SDKのアップグレヌドが難しい堎合や、アップグレヌドしおも解決しない堎合は、サポヌトチヌムにお問い合わせください。詳现ログを有効にしおログをチヌムず共有するず、問題をより早く解決できたす。関連するコヌドスニペットを添付するこずも可胜です。
ÿÿÿÿ