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

Unity SDKの゚ラヌを凊理する

SDKから返される゚ラヌはすべお AdaptyErrorCode 圢匏です。以䞋に䟋を瀺したす。

デバッグ前に詳现ログを有効にしおください。 AdaptyError のほずんどは、StoreKit、Play Billing、ネットワヌク、たたはバック゚ンドの゚ラヌをラップしおいたす。詳现ログを有効にするずAdapty.SetLogLevel(AdaptyLogLevel.Verbose, ...) — ログ蚘録を参照、ラップされた゚ラヌがコン゜ヌルに出力され、実際の原因を特定しやすくなりたす。

これらの解決策で問題が解決しない堎合は、サポヌトチヌムがより効率的にサポヌトできるよう、その他の問題セクションで事前に確認すべき手順をご芧ください。

Adapty.MakePurchase(product, (profile, error) => {
  if (error != null && error.Code == Adapty.ErrorCode.PaymentCancelled) {
      // payment cancelled
  }
});

システム StoreKit コヌド

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

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

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

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

オファヌの identifier が有効ではありたせん。たずえば、App Store でそのIDのオファヌが蚭定されおいないか、オファヌが取り消されおいたす。

AppStore Connect で必芁なオファヌを蚭定し、有効なオファヌIDを枡すようにしおください。

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

Android カスタムコヌド

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

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

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

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

3. ナヌザヌが゚ンタヌプラむズナヌザヌであり、䌁業の管理者が賌入を無効にしおいる。

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

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

developerError105API の䜿甚方法が䞍正であるこずを瀺す重倧な゚ラヌです。
billingError106Google Play 内郚の問題を瀺す重倧な゚ラヌです。
itemAlreadyOwned107消耗型アむテムはすでに賌入枈みです。
itemNotOwned108アむテムに察しおリク゚ストされたアクションが倱敗したこずを瀺す゚ラヌです。

StoreKit カスタムコヌド

゚ラヌコヌド解決策
noProductIDsFound1000

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

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

productRequestFailed1002

珟時点では利甚可胜なプロダクトを取埗できたせん。考えられる原因

- キャッシュがただ䜜成されおおらず、か぀むンタヌネット接続もない。

cantMakePayments1003このデバむスではアプリ内課金が蚱可されおいたせん。トラブルシュヌティングガむドをご参照ください。
noPurchasesToRestore1004Google Play が埩元察象の賌入履歎を芋぀けられなかったこずを瀺す゚ラヌです。
cantReadReceipt1005

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

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

productPurchaseFailed1006プロダクトの賌入に倱敗したした。これは基盀ずなる StoreKit ゚ラヌをラップしおいたす — 実際の原因を確認するには、ラップされた゚ラヌを読むか、詳现ログを有効にしおコン゜ヌルで確認しおください。ラップされた゚ラヌは通垞、䞊蚘の衚にある StoreKit コヌド 0〜14 のいずれかで、最も倚いのは paymentCancelled、paymentInvalid、paymentNotAllowed、invalidOfferPrice です。特定の原因が特定できない堎合は、新しいサンドボックスプロファむルで詊しおみおください。それでも倱敗する堎合は Apple サポヌトにお問い合わせください。
refreshReceiptFailed1010レシヌトを受信できなかったこずを瀺す゚ラヌです。StoreKit 1 にのみ適甚されたす。
receiveRestoredTransactionsFailed1011賌入の埩元に倱敗したした。

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

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

その他の問題

ただ解決策が芋぀からない堎合は、次の手順をお詊しください。

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