Unity 之 接入IOS內購程序決議
- 前言
- 需要準備
- 內購導圖
- 一,效果展示
- 二,蘋果后臺
- 2.1 注冊應用程式
- 2.2 添加應用內購買
- 2.3 測驗IAP
- 三,下載IAP包
- 3.1 下載Package
- 3.2 打開Srever配置
- 四,代碼邏輯
- 4.1 邏輯分析
- 4.2 示例原始碼
- 五,打包測驗
- 5.1 代碼配置
- 5.2 手動配置
- 六,問題匯總
- 6.1 示例日志
- 6.2 注意事項
- 6.3 參考鏈接
- 6.4 文末原始碼
前言
看完此文章你可以了解IOS內購接入全程序,可以學習到Unity從零接入內購功能,另外此博文和文末原始碼沒有涉及到掉單補單部分邏輯,
需要準備
- 一臺mac系統機器
- 蘋果開發者賬號
- Unity2019.4.x (不同版本,3步驟略有不同)
- Xcode (我的版本12.5)
內購導圖

一,效果展示

二,蘋果后臺
PS:若公司已有運營人員在后臺操作過了,可以跳過此步驟,注意測驗機上還是需要登陸沙箱賬號奧,
2.1 注冊應用程式
-
首先打開蘋果開發者官網:https://developer.apple.com/
-
點擊登陸并點“Account”,在
Apple Developer Center中,導航到相應的識別符號部分:

-
添加新的 App ID 以創建與 Apple 的基本應用程式物體,
-
注意:使用顯式應用程式 ID,通配符應用 ID (com.example.*) 不能用于使用應用內購買的應用,
-
注意:在開發者中心創建 App ID 后,即可在 iTunes Connect 中使用它,
-

- 導航到iTunes Connect并創建一個應用程式,以與游戲建立商店關系:

- 使用新創建的 App ID 作為應用的 Bundle ID:

2.2 添加應用內購買
-
選擇功能并使用加號 ("+") 按鈕添加新的應用內購買:

-
選擇產品型別:

- 指定產品識別符號,并根據要求填寫其他欄位,
- 注意:此處的“產品 ID”與游戲源代碼中使用的識別符號相同,通過AddProduct()或AddProducts()添加到Unity IAP ConfigurationBuilder實體,

2.3 測驗IAP
- 使用
iTunes Connect創建沙盒測驗器以在您的測驗設備的iTunes帳戶上使用,為此,請導航至iTunes Connect > Users and Roles,然后選擇加號 ("+") 按鈕,
PS:詳情可查看Apple的Sandbox Tester檔案,,


- Xcode專案配置
Xcode 專案中Bundle Identitifier和Team與iTunes Connect中使用的一致
PS:Unity中的包名也應該保持一致

- 在測驗設備登陸沙箱測驗賬號

三,下載IAP包
3.1 下載Package
打開Windows -> Package Manager 下載 In App Purchasing

3.2 打開Srever配置
-
打開服務視窗,在服務視窗中查找和啟用應用內購買

-
選擇專案ID(當前登錄的賬號)

-
啟用In-APP Purchasing (有的時候切換慢,需要等一會)

-
回答問題
問:這款應用主要面向13歲以下的兒童(是就勾選,不是不勾選)
-
有個報錯
我沒有解決也沒有影響,需要解決的話按照下面的提示操作一下

四,代碼邏輯
4.1 邏輯分析
-
實作
IStoreListener介面,介面提供四個回呼函式,分別是初始化成功、失敗,購買成功、失敗; -
撰寫初始化邏輯,完善初始化成功、失敗回呼介面函式;
-
撰寫呼叫購買邏輯,完善購買成功、失敗回呼介面函式;
-
實際開發中需要限制,購買按鈕只被點擊一次,
代碼結構就是這樣了,詳細解釋代碼注釋已經寫得很清楚了,這里不再贅述,
使用時將代碼掛載到場景即可進行初始化,然后創建Button監聽代碼中的OnClickPurchase方法即可打包測驗,
PS:注意需要將goodsList陣列中的key換成你后臺申請的
4.2 示例原始碼
using System;
using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.Purchasing;
/// <summary>
/// IAP管理類
/// </summary>
public class IAPManager : MonoBehaviour, IStoreListener
{
/// <summary>
/// 需要換成對應游戲后臺的key
/// </summary>
private string[] goodsList = new string[]
{
"com.czhenya.gold.1",
"com.czhenya.gold.2",
"com.czhenya.gold.3"
};
// 控制器
private IStoreController controller;
// 蘋果擴展
private IAppleExtensions appleExtensions;
// 谷歌商店擴展
private IGooglePlayStoreExtensions googlePlayStoreExtensions;
// 是否可以發起購買
private bool isCanOnClickBubBtn = false;
void Start()
{
Init();
}
/// <summary>
/// 初始化
/// </summary>
private void Init()
{
// 沒有網路,IAP會一直初始化
if (Application.internetReachability == NetworkReachability.NotReachable)
{
Debug.Log("----- 用戶沒有連接網路 IAP不可用 ------");
}
var module = StandardPurchasingModule.Instance();
ConfigurationBuilder builder = ConfigurationBuilder.Instance(module);
// builder.AddProduct("商品id1", ProductType.Consumable);
// ProductType :和后臺說明對應
// consumable:可消費的,如游戲中的金幣,用完還可以再購買,
// non-consumable:不可銷毀的,一次購買,永久生效,比如去廣告,解鎖游戲關卡,這種商品只能購買一次,
// subscription:訂閱的,這種一般用于新聞、雜志、或者app里面的月卡,可以按月或者按年收費,
for (int i = 0; i < goodsList.Length; i++)
{
builder.AddProduct(goodsList[i], ProductType.Consumable);
}
// 開始初始化
UnityPurchasing.Initialize(this, builder);
}
/// <summary>
/// 初始化成功 -- 接口函式
/// </summary>
/// <param name="controller"></param>
/// <param name="extensions"></param>
public void OnInitialized(IStoreController controller, IExtensionProvider extensions)
{
Debug.Log("【Unity IAP】初始化成功 IAP initialize success");
isCanOnClickBubBtn = true;
this.controller = controller;
// 回呼賦值
this.appleExtensions = extensions.GetExtension<IAppleExtensions>();
this.googlePlayStoreExtensions = extensions.GetExtension<IGooglePlayStoreExtensions>();
//登記 購買延遲 監聽器
appleExtensions.RegisterPurchaseDeferredListener(OnDeferred);
}
//購買延遲提示
private void OnDeferred(Product item)
{
Debug.Log("【Unity IAP】 網速慢.................");
}
/// <summary>
/// 初始化失敗回呼 -- 介面函式
/// </summary>
/// <param name="error"></param>
public void OnInitializeFailed(InitializationFailureReason error)
{
Debug.LogError("【Unity IAP】初始化失敗 OnInitializeFailed, reason:" + error.ToString());
}
/// <summary>
/// 購買失敗回呼 -- 介面函式
/// </summary>
/// <param name="i"></param>
/// <param name="p"></param>
public void OnPurchaseFailed(Product i, PurchaseFailureReason p)
{
Debug.LogError("【Unity IAP】購買失敗 OnPurchaseFailed,reason:" + p.ToString());
if (this.onPurchaseFailed != null)
{
this.onPurchaseFailed();
this.onPurchaseFailed = null;
}
}
/// <summary>
/// 購買成功回呼 -- 介面函式
/// </summary>
/// <param name="e"></param>
/// <returns></returns>
public PurchaseProcessingResult ProcessPurchase(PurchaseEventArgs e)
{
Debug.LogError("【Unity IAP】購買程序 purchase finished, apple return receipt:" + e.purchasedProduct.receipt);
if (this.onPurchaseSuccess != null)
{
this.onPurchaseSuccess(e.purchasedProduct.receipt);
this.onPurchaseSuccess = null;
}
return PurchaseProcessingResult.Complete;
}
/// <summary>
/// 支付失敗回呼
/// </summary>
private Action onPurchaseFailed;
/// <summary>
/// 支付成功回呼
/// </summary>
private Action<string> onPurchaseSuccess;
/// <summary>
/// 購買產品
/// </summary>
/// <param name="productId">產品ID</param>
/// <param name="onFailed">失敗回呼</param>
/// <param name="onSuccess">成功回呼</param>
public void PurchaseProduct(string productId, Action onFailed, Action<string> onSuccess)
{
this.onPurchaseFailed = onFailed;
this.onPurchaseSuccess = onSuccess;
if (controller != null)
{
var product = controller.products.WithID(productId);
if (product != null && product.availableToPurchase)
{
Debug.Log("【Unity IAP】開始購買");
controller.InitiatePurchase(productId);
}
else
{
Debug.LogError("【Unity IAP】失敗回呼 no product with productId:" + productId);
if (this.onPurchaseFailed != null)
{
this.onPurchaseFailed();
}
}
}
else
{
Debug.LogError("【Unity IAP】失敗回呼 controller is null,can not do purchase");
if (this.onPurchaseFailed != null)
{
this.onPurchaseFailed();
}
}
}
/// <summary>
/// 發起購買函式 -- 商城按鈕監聽
/// </summary>
/// <param name="i"></param>
public void OnClickPurchase(int i)
{
// 正式專案時需限制 -- 不允許多次點擊
Debug.Log("【Unity IAP】發起購買函式 " + Application.internetReachability);
if (Application.internetReachability == NetworkReachability.NotReachable)
{
Debug.Log("【Unity IAP】用戶沒網... ");
return;
}
PurchaseProduct(goodsList[0], OnBuyFailed, OnBuySuccess);
}
/// <summary>
/// 購買失敗回呼
/// </summary>
void OnBuyFailed()
{
Debug.Log("【Unity IAP】購買失敗回呼 OnBuyFailed...");
}
/// <summary>
/// 購買成功回呼
/// </summary>
/// <param name="str"></param>
void OnBuySuccess(string str)
{
Debug.Log("【Unity IAP】購買成功回呼 OnBuySuccess..." + str);
//會得到下面這樣一個字串
//{"Store":"AppleAppStore",
//"TransactionID":"1000000845663422",
//"Payload":"MIIT8QYJKoZIhvcNAQcCoIIT4jCCE94CAQExBBMMIIBa ... 還有N多 ..."}
}
}
五,打包測驗
代碼配置和手動配置選擇一個習慣用的方式即可,
5.1 代碼配置
由于內購需要系統庫StoreKit.framework和iAd.framework,為了不每次打包Xcode時都手動添加,所以創建打包配置代碼,(復制下面檔案,放到Editor檔案夾下)
using System.IO;
using UnityEditor;
using UnityEngine;
#if UNITY_IOS
using UnityEditor.Callbacks;
using UnityEditor.iOS.Xcode;
#endif
/// <summary>
/// 打包自動組態檔
/// </summary>
public class CZYConfigEditor
{
#if UNITY_IOS
[PostProcessBuildAttribute(100)]
public static void onPostProcessBuild(BuildTarget target, string targetPath)
{
if (target != BuildTarget.iOS)
{
return;
}
string projPath = PBXProject.GetPBXProjectPath(targetPath);
PBXProject proj = new PBXProject();
proj.ReadFromString(File.ReadAllText(projPath));
string unityTarget = proj.GetUnityFrameworkTargetGuid();
#region 系統依賴庫
proj.AddFrameworkToProject(unityTarget, "StoreKit.framework", false);
proj.AddFrameworkToProject(unityTarget, "iAd.framework", false);
#endregion
string content = proj.WriteToString();
File.WriteAllText(projPath, content);
}
#endif
}
5.2 手動配置
不寫上面代碼的話,打包出Xcode工程后,需要手動添加StoreKit.framework和iAd.framework:

然后正常打包進行測驗~ 即可完成開篇效果,
六,問題匯總
6.1 示例日志
-
IAP初始化成功日志:

-
購買成功回呼日志:
【Unity IAP】購買成功回呼 OnBuySuccess…{“Store”:“AppleAppStore”,“TransactionID”:“1000000866663121”,“Payload”:“MIIT8QYJKoZIhvcNAQcCo
…中間省略N多行…
jSYLAk”}
System.Action`1:Invoke(T)
IAPMgr:ProcessPurchase(PurchaseEventArgs)
UnityEngine.Purchasing.PurchasingManager:ProcessPurchaseIfNew(Product)
UnityEngine.Purchasing.JSONStore:OnPurchaseSucceeded(String, String, String)
System.Action:Invoke()
UnityEngine.Purchasing.Extension.UnityUtil:Update()
6.2 注意事項
- 真機測驗的時候,一定要退出原來的賬號(app store 登錄的賬號退出),才能用沙盒測驗賬號,
- 請務必使用真機來測驗,一切以真機為準,
- 專案的Bundle identifier需要與您申請AppID時填寫的bundleID一致,不然會無法請求到商品資訊,
- 沙盒環境測驗appStore內購流程的時候,請使用沒越獄的設備,
- 沙盒的測驗賬號和你請求商品資訊沒有關系,請求商品資訊的流程是,你在后臺配置好了內購商品,并且將其添加到了需要集成內購功能的App中,然后你請求商品,請求到商品后的流程是這樣的,蘋果系統會自動彈出登錄框讓你登錄賬號,然后根據提示操作進行購買,這里的賬號就是你配置的沙盒測驗賬號,
6.3 參考鏈接
官方檔案 Unity IAP
官方手冊 Unity IAP
6.4 文末原始碼
其實原始碼以及步驟都在上面分享過了,若還有什么不明白的,可以點擊下面鏈接下載,積分不夠的童鞋可以私信我哦~
原始碼鏈接
轉載請註明出處,本文鏈接:https://www.uj5u.com/yidong/298985.html
標籤:其他
