XỠlý lỗi trong Unity SDK
Má»i lá»—i được SDK trả vá» Ä‘á»u là AdaptyErrorCode. DÆ°á»›i đây là má»™t và dụ:
Báºt verbose logs trÆ°á»›c khi debug. Hầu hết các AdaptyError Ä‘á»u bao gồm lá»—i gốc từ StoreKit, Play Billing, mạng, hoặc backend. Khi báºt verbose logs (Adapty.SetLogLevel(AdaptyLogLevel.Verbose, ...) — xem Logging), lá»—i gốc đó sẽ được in ra console, thÆ°á»ng cho biết nguyên nhân thá»±c sá»±.
Nếu các giải pháp nà y không khắc phục được vấn đỠcủa bạn, hãy xem Các vấn đỠkhác để biết các bước cần thực hiện trước khi liên hệ hỗ trợ, giúp chúng tôi hỗ trợ bạn hiệu quả hơn.
Adapty.MakePurchase(product, (profile, error) => {
if (error != null && error.Code == Adapty.ErrorCode.PaymentCancelled) {
// payment cancelled
}
});Mã lỗi StoreKit hệ thống
| Lỗi | Mã | Giải pháp |
|---|---|---|
| unknown | 0 | Mã lỗi nà y cho biết đã xảy ra lỗi không xác định hoặc không mong đợi. ThỠlại hoặc xem phần Các vấn đỠkhác. |
| clientInvalid | 1 | Mã lỗi nà y cho biết client không được phép thực hiện hà nh động đang cố gắng. |
| paymentCancelled | 2 | Mã lá»—i nà y cho biết ngÆ°á»i dùng đã hủy yêu cầu thanh toán. Không cần thá»±c hiện hà nh Ä‘á»™ng nà o, nhÆ°ng vá» mặt logic nghiệp vụ, bạn có thể Ä‘á» xuất Æ°u đãi cho ngÆ°á»i dùng hoặc nhắc nhở há» sau. |
| paymentInvalid | 3 | Lá»—i nà y cho biết má»™t trong các tham số thanh toán không được App Store nháºn dạng. |
| paymentNotAllowed | 4 | Mã lá»—i nà y cho biết ngÆ°á»i dùng không được phép xác thá»±c thanh toán. |
| storeProductNotAvailable | 5 | Mã lá»—i nà y cho biết sản phẩm được yêu cầu không có sẵn trong cá»a hà ng. Thá» cà i lại ứng dụng. |
| cloudServicePermissionDenied | 6 | Mã lá»—i nà y cho biết ngÆ°á»i dùng chÆ°a cho phép truy cáºp thông tin dịch vụ Cloud. |
| cloudServiceNetworkConnectionFailed | 7 | Mã lỗi nà y cho biết thiết bị không thể kết nối mạng. |
| cloudServiceRevoked | 8 | Mã lá»—i nà y cho biết ngÆ°á»i dùng đã thu hồi quyá»n sá» dụng dịch vụ cloud nà y. |
| privacyAcknowledgementRequired | 9 | Mã lá»—i nà y cho biết ngÆ°á»i dùng chÆ°a xác nháºn chÃnh sách quyá»n riêng tÆ° của Apple. |
| unauthorizedRequestData | 10 | Mã lá»—i nà y cho biết ứng dụng Ä‘ang cố sá» dụng má»™t thuá»™c tÃnh mà nó không có quyá»n truy cáºp cần thiết. |
| invalidOfferIdentifier | 11 |
Hãy đảm bảo bạn đã thiết láºp các Æ°u đãi mong muốn trong AppStore Connect và truyá»n và o má»™t offer identifier hợp lệ. |
| invalidSignature | 12 | Mã lỗi nà y cho biết chữ ký trong payment discount không hợp lệ. |
| missingOfferParams | 13 | Mã lỗi nà y cho biết thiếu các tham số trong payment discount. |
| invalidOfferPrice | 14 | Mã lỗi nà y cho biết giá bạn đã chỉ định trong App Store Connect không còn hợp lệ nữa. Các ưu đãi luôn phải thể hiện mức giá giảm. |
Mã lỗi Android tùy chỉnh
| Lỗi | Mã | Giải pháp |
|---|---|---|
| adaptyNotInitialized | 20 | Bạn cần cấu hình đúng Adapty SDK bằng phương thức Adapty.activate. Tìm hiểu cách thực hiện cho Unity. |
| productNotFound | 22 | Lá»—i nà y cho biết sản phẩm được yêu cầu mua không có sẵn trong cá»a hà ng. |
| invalidJson | 23 | JSON của paywall không hợp lệ. Hãy sá»a trong Adapty Dashboard. Tham khảo phần Tùy chỉnh paywall vá»›i remote config để biết cách khắc phục. |
| currentSubscriptionToUpdateNotFoundInHistory | 24 | Không tìm thấy gói đăng ký gốc cần gia hạn. |
| pendingPurchase | 25 | Lỗi nà y cho biết trạng thái giao dịch mua đang ở trạng thái chỠxỠlý thay vì đã mua. Tham khảo trang Handling pending transactions trong tà i liệu Android Developer để biết thêm chi tiết. |
| billingServiceTimeout | 97 | Lá»—i nà y cho biết yêu cầu đã đạt đến thá»i gian chá» tối Ä‘a trÆ°á»›c khi Google Play có thể phản hồi. Nguyên nhân có thể là do cháºm trá»… trong việc thá»±c thi hà nh Ä‘á»™ng được yêu cầu bởi lệnh gá»i Play Billing Library. |
| featureNotSupported | 98 | TÃnh năng được yêu cầu không được há»— trợ bởi Play Store trên thiết bị hiện tại. |
| billingServiceDisconnected | 99 | Lá»—i nghiêm trá»ng nà y cho biết kết nối của ứng dụng client tá»›i dịch vụ Google Play Store qua BillingClient đã bị ngắt. |
| billingServiceUnavailable | 102 | Lá»—i tạm thá»i nà y cho biết dịch vụ Google Play Billing hiện không khả dụng. Trong hầu hết các trÆ°á»ng hợp, Ä‘iá»u nà y có nghÄ©a là có sá»± cố kết nối mạng ở đâu đó giữa thiết bị client và dịch vụ Google Play Billing. |
| billingUnavailable | 103 | Lá»—i nà y cho biết đã xảy ra lá»—i thanh toán của ngÆ°á»i dùng trong quá trình mua. Các và dụ khi Ä‘iá»u nà y có thể xảy ra bao gồm: 1. Ứng dụng Play Store trên thiết bị của ngÆ°á»i dùng đã lá»—i thá»i. 2. NgÆ°á»i dùng ở quốc gia không được há»— trợ. 3. NgÆ°á»i dùng là ngÆ°á»i dùng doanh nghiệp và quản trị viên doanh nghiệp của hỠđã tắt chức năng mua hà ng. 4. Google Play không thể tÃnh phà phÆ°Æ¡ng thức thanh toán của ngÆ°á»i dùng. Và dụ: thẻ tÃn dụng của ngÆ°á»i dùng có thể đã hết hạn. 5. NgÆ°á»i dùng chÆ°a đăng nháºp và o ứng dụng Play Store. |
| developerError | 105 | Äây là lá»—i nghiêm trá»ng cho biết bạn Ä‘ang sá» dụng API không đúng cách. |
| billingError | 106 | Äây là lá»—i nghiêm trá»ng cho biết có vấn Ä‘á» ná»™i bá»™ vá»›i chÃnh Google Play. |
| itemAlreadyOwned | 107 | Sản phẩm consumable nà y đã được mua. |
| itemNotOwned | 108 | Lỗi nà y cho biết hà nh động được yêu cầu trên mục đã thất bại vì |
Mã lỗi StoreKit tùy chỉnh
| Lỗi | Mã | Giải pháp |
|---|---|---|
| noProductIDsFound | 1000 | Lỗi nà y cho biết không có sản phẩm nà o bạn yêu cầu trên paywall có thể mua được trong App Store, dù chúng đã được liệt kê ở đó. Lỗi nà y đôi khi xuất hiện kèm theo cảnh báo Nếu bạn gặp lỗi nà y, hãy là m theo các bước trong phần Khắc phục lỗi Code-1000 |
| productRequestFailed | 1002 | Không thể tải danh sách sản phẩm khả dụng và o lúc nà y. Lý do có thể là : - ChÆ°a có cache nà o được tạo và đồng thá»i không có kết nối internet. |
| cantMakePayments | 1003 | In-app purchase không được phép trên thiết bị nà y. Xem hướng dẫn khắc phục. |
| noPurchasesToRestore | 1004 | Lỗi nà y cho biết Google Play không tìm thấy giao dịch mua để khôi phục. |
| cantReadReceipt | 1005 | Không có receipt hợp lệ nà o trên thiết bị. Äiá»u nà y có thể xảy ra khi kiểm thá» trong sandbox. Không cần thá»±c hiện hà nh Ä‘á»™ng nà o, nhÆ°ng vá» mặt logic nghiệp vụ, bạn có thể Ä‘á» xuất Æ°u đãi cho ngÆ°á»i dùng hoặc nhắc nhở há» sau. |
| productPurchaseFailed | 1006 | Giao dịch mua sản phẩm thất bại. Lá»—i nà y bao gồm lá»—i gốc từ StoreKit — hãy Ä‘á»c lá»—i được bao gồm (hoặc báºt verbose logs để xem trong console) để biết nguyên nhân thá»±c sá»±. Lá»—i được bao gồm thÆ°á»ng là má»™t trong các mã StoreKit 0–14 trong bảng trên — phổ biến nhất là paymentCancelled, paymentInvalid, paymentNotAllowed, hoặc invalidOfferPrice. Nếu bạn không thể xác định nguyên nhân cụ thể, hãy thá» vá»›i sandbox profile má»›i; nếu vẫn thất bại, hãy liên hệ há»— trợ Apple. |
| refreshReceiptFailed | 1010 | Lá»—i nà y cho biết receipt không được nháºn. Chỉ áp dụng cho StoreKit 1. |
| receiveRestoredTransactionsFailed | 1011 | Khôi phục giao dịch mua thất bại. |
Mã lỗi mạng tùy chỉnh
| Lỗi | Mã | Giải pháp |
|---|---|---|
| notActivated | 2002 | Adapty SDK chÆ°a được kÃch hoạt. ThÆ°á»ng gặp nhất khi mà n hình splash hoặc má»™t script hook sá»›m gá»i các phÆ°Æ¡ng thức Adapty trÆ°á»›c khi Adapty.Activate hoà n tất. Triệu chứng nà y không ổn định và có thể không tái hiện trong editor vì thá»i gian trên thiết bị thá»±c khác nhau. Hãy chá» callback hoà n thà nh của Activate trÆ°á»›c khi láºp lịch bất kỳ lệnh gá»i SDK nà o khác. Xem Thứ tá»± gá»i trong Unity SDK để biết trình tá»± đầy đủ. |
| badRequest | 2003 | Yêu cầu không hợp lệ. Äảm bảo bạn đã hoà n thà nh tất cả các bÆ°á»›c cần thiết để tÃch hợp vá»›i App Store. |
| serverError | 2004 | Lá»—i máy chủ. Thá» lại sau má»™t khoảng thá»i gian. Nếu vấn Ä‘á» vẫn chÆ°a được giải quyết, hãy liên hệ Ä‘á»™i há»— trợ Adapty. |
| networkFailed | 2005 | Lá»—i nà y cho biết có sá»± cố kết nối mạng trên thiết bị của ngÆ°á»i dùng ÿÿ . Thá» tắt VPN hoặc chuyển từ mạng di Ä‘á»™ng sang WiFi hoặc ngược lại. |
| decodingFailed | 2006 | Lá»—i nà y cho biết quá trình giải mã response thất bại. Kiểm tra lại code và đảm bảo rằng các tham số bạn gá»i Ä‘á»u hợp lệ. Và dụ, lá»—i nà y có thể cho thấy bạn Ä‘ang sá» dụng API key không hợp lệ. |
| encodingFailed | 2009 | Lỗi nà y cho biết quá trình mã hóa request thất bại. |
| missingURL | 2010 | URL được yêu cầu là nil. |
| analyticsDisabled | 3000 | Chúng tôi không thể xá» lý các sá»± kiện analytics vì bạn đã tắt tÃnh năng nà y. |
| wrongParam | 3001 | Lá»—i nà y cho biết má»™t số tham số của bạn không chÃnh xác. Nếu bạn Ä‘ang sá» dụng Adapty paywall builder và không thể hiển thị paywall vì lá»—i nà y, hãy báºt Show on device trong paywall builder. Nguyên nhân khác có thể là phiên bản file fallback cục bá»™ không khá»›p vá»›i phiên bản SDK. Hãy tải xuống file má»›i trong dashboard. |
| activateOnceError | 3005 | Không thể gá»i phÆ°Æ¡ng thức .activate nhiá»u hÆ¡n má»™t lần. |
| profileWasChanged | 3006 | Hồ sÆ¡ ngÆ°á»i dùng đã bị thay đổi trong quá trình thá»±c hiện thao tác. Äiá»u nà y xảy ra khi má»™t phÆ°Æ¡ng thức được gá»i trong khi Adapty.Identify vẫn Ä‘ang chạy — lệnh gá»i Ä‘ang chạy đó sẽ tác Ä‘á»™ng lên má»™t hồ sÆ¡ sắp bị thay thế và SDK từ chối nó. Hãy chá» callback hoà n thà nh của Identify trÆ°á»›c bất kỳ lệnh gá»i nà o liên quan đến hà nh Ä‘á»™ng của ngÆ°á»i dùng. Xem Thứ tá»± gá»i trong Unity SDK. |
| unsupportedData | 3007 | Lỗi nà y cho biết định dạng dữ liệu không được SDK hỗ trợ. |
| persistingDataError | 3100 | Äã xảy ra lá»—i khi lÆ°u dữ liệu. |
| fetchTimeoutError | 3101 | Lá»—i nà y cho biết thao tác tải dữ liệu đã hết thá»i gian chá». |
Các vấn đỠkhác
Nếu bạn vẫn chưa tìm được giải pháp, các bước tiếp theo có thể là :
- Nâng cấp SDK lên phiên bản má»›i nhất: Chúng tôi luôn khuyến nghị nâng cấp lên phiên bản SDK má»›i nhất vì chúng ổn định hÆ¡n và bao gồm các bản sá»a lá»—i đã biết.
- Liên hệ Ä‘á»™i há»— trợ hoặc nháºn trợ giúp từ cá»™ng đồng nhà phát triển tại diá»…n Ä‘Ã n há»— trợ.
- Liên hệ Ä‘á»™i há»— trợ qua support@adapty.io hoặc qua chat: Nếu bạn chÆ°a sẵn sà ng nâng cấp SDK hoặc nâng cấp không giải quyết được vấn Ä‘á», hãy liên hệ Ä‘á»™i há»— trợ của chúng tôi. LÆ°u ý rằng vấn Ä‘á» của bạn sẽ được giải quyết nhanh hÆ¡n nếu bạn báºt verbose logging và chia sẻ logs vá»›i Ä‘á»™i ngÅ©. Bạn cÅ©ng có thể Ä‘Ãnh kèm các Ä‘oạn code liên quan.