初始化 Unity IAP
了解如何初始化 Unity IAP 包、配置基本设置以及验证设置以开始处理受支持平台上的应用内购。
阅读时间6 分钟最后更新于 20 天前
使用 Unity 应用内购 (IAP) 之前，请初始化 IAP 包。
重要
如果要集成直接到消费者 (D2C) 付款提供商，有一些差异，因此请改用初始化服务以处理启动顺序。
初始化 Unity Gaming Services
调用UnityServices.InitializeAsync()Task初始化应用内购
先决条件
完成 Create a catalog in Editor（为要购买的商品创建目录）中的步骤。初始化步骤
初始化包括以下步骤：- 获取应用商店的。
StoreController - 将事件监听器附加到。
StoreController - 连接到应用商店。
- 从应用商店获取商品。
- 从应用商店获取购买。
using System.Collections.Generic;using UnityEngine.Purchasing;public class MyIAPManager{ private StoreController m_StoreController; public MyIAPManager() { // Define products var catalogProvider = new CatalogProvider(); catalogProvider.AddProduct("100_gold_coins", ProductType.Consumable, new StoreSpecificIds() { {"100_gold_coins_google", GooglePlay.Name}, {"100_gold_coins_mac", MacAppStore.Name} }); // Get StoreController m_StoreController = UnityIAPServices.StoreController(); // Add event listeners m_StoreController.OnStoreDisconnected += OnStoreDisconnected; m_StoreController.OnProductsFetch += OnProductsFetch; m_StoreController.OnProductsFetchFailed += OnProductsFetchFailed; m_StoreController.OnPurchasesFetch += OnPurchasesFetch; m_StoreController.OnPurchasesFetchFailed += OnPurchasesFetchFailed; // Connect to store m_StoreController.Connect().ContinueWith(_ => { // Fetch products from store catalogProvider.FetchProducts( list => m_StoreController.FetchProducts(list) }); } /// <summary> /// Invoked when connection is lost to the current store, or on a Connect() failure. /// </summary> /// <param name="failure">Information regarding the failure.</param> private void OnStoreDisconnected(StoreConnectionFailureDescription failure) { } /// <summary> /// Invoked with products that are successfully fetched. /// </summary> /// <param name="products">Products successfully returned from the app store.</param> private void OnProductsFetch(List<Product> products) { // Fetch purchases for successfully retrieved products m_StoreController.FetchPurchases(); } /// <summary> /// Invoked when an attempt to fetch products has failed or when a subset of products failed to be fetched. /// </summary> /// <param name="failure">Information regarding the failure.</param> private void OnProductsFetchFailed(ProductFetchFailed failure) { } /// <summary> /// Invoked when previous purchases are fetched. /// </summary> /// <param name="orders">All active pending, completed, and deferred orders for previously fetched products.</param> private void OnPurchasesFetch(Orders orders) { } /// <summary> /// Invoked when an attempt to fetch previous purchases has failed. /// </summary> /// <param name="failure">Information regarding the failure.</param> private void OnPurchasesFetchFailed(PurchasesFetchFailureDescription failure) { } /// <summary> /// Invoked when a purchase needs to be processed and fulfilled. /// </summary> /// <param name="order">The order awaiting fulfillment.</param> private void OnPurchasePending(PendingOrder order) { }}
获取 StoreController
StoreControllerStoreController将事件处理程序附加到 StoreController
要使应用商店正常运行，请将处理程序附加到这些事件：- OnStoreDisconnected
- OnProductsFetch
- OnProductsFetchFailed
- OnPurchasesFetched
- OnPurchasesFetchFailed
- OnPurchasePending
StoreController连接到应用商店
调用 StoreController.Connect 以连接到应用商店。返回的TaskOnStoreDisconnected获取商品
注意
在获取商品之前定义商品。有关说明，请参阅在 Editor 中创建目录。
OnProductsFetchedOnProductsFetchFailedFetchProductsFetchProductsFetchProductsOnPurchasePendingGetProducts
GetProductsFetchProductsFetchProductsFetchProductsGetProducts获取购买
调用StoreController.FetchPurchasesPendingOrdersConfirmedOrdersDeferredOrdersFetchPurchasesOnPurchasesFetchedOrdersOnPurchasesFetchFailedOnPurchasePending获取离线购买
某些平台库（例如 Apple StoreKit 2）会在设备上缓存授权以便离线访问，而不会缓存商品数据。虽然不建议使用此方法，但仍可以在OnProductsFetchFailedFetchPurchasesFetchPurchasestypeProductType.UnknownProductDefinition.idProductDefinition.storeSpecificId注意
这不适用于 StoreKit 1。StoreKit 1 在设备上缓存收据时，包需要获取的商品数据才能解析收据数据。如果商品获取失败， 不会返回任何购买信息。
FetchPurchasesGetPurchases
GetPurchasesFetchPurchasesFetchPurchasesGetProductsFetchProductsFetchPurchasesGetPurchases自动初始化 Codeless IAP
有关如何设置 Codeless IAP 的说明，请参阅 Set Up Codeless IAP。注意
如果也在脚本中手动初始化，则不应启用自动初始化，因为这可能会导致错误。