关于如何在Unity中的空项目中使用Kin Unity SDK的逐步说明，有什么很好的解释？
最佳答案
选项1：使用预制包装纸
在此10 minute set up code（客户端和服务器）中使用包装器，并按以下方式调用它：
kinWrapper.SendPayment(1.00M, "test send", address);
kinWrapper.Balance();
//etc
Here是有关实现包装器的详细教程。
选项2：创建自己的包装器
Kin blockchain是fork of the stellar protocol。因此，您应用程序中的操作可归结为以下内容：
在区块链上创建账户
区块链上的资金账户
汇款
您可以克隆示例实现here-或可以按照以下步骤进行基本了解。
安装
创建一个空的Unity项目，然后安装Kin Unity Plugin并按照here所述修改gradle文件。
注意：SDK仅在Android / iOS设备或模拟器上运行。 SDK不会在统一编辑器或统一远程中运行-因此您需要在仿真器或设备中编译并运行代码。
实作
创建一个空的MonoBehaviour脚本-将其命名为KinWrapper，并声明Kin命名空间：
using Kin;
您还可以通过将以下内容添加到MonoBehaviour中来启用blockchain listeners：
public class KinWrapper : MonoBehaviour, IPaymentListener, IBalanceListener
实例化
接下来声明Kin客户和Kin帐户的实例
private KinClient kinClient;
private KinAccount kinAccount;
客户端根据您使用的平台来处理本机代码。 （Android或iOS）。该帐户是您将要使用的主界面。
创建一个账户
在使用该帐户之前，您首先必须通过客户端实例化它。
kinClient = new KinClient(Kin.Environment.Test, "appId");
if (!kinClient.HasAccount())
{
kinAccount = kinClient.AddAccount();
}else{
kinAccount = kinClient.GetAccount(0);
}
上面的代码首先检查设备上是否存在本地帐户。如果不是，它将在设备上创建一个帐户，并将其作为参考返回。
注意：“创建的帐户”只是设备上生成的public key and private key。这些本地密钥使设备能够与区块链进行通信。
现在，您可以通过调用以下命令获取公钥（客户的区块链地址）：
kinAccount.GetPublicAddress();
入职/为帐户注资
由于此密钥仅在本地存在，因此您需要将其“加载”到区块链中。换句话说，需要调用一个特殊功能来在线进行资助和注册。在完成此步骤之前，该地址在区块链上被视为无效，无法接收或进行交易。这是avoid spam and unnecessary account creation恒星协议的一部分。
您可以通过调用以下功能来检查该帐户是否已注册并注资：
kinAccount.GetStatus(GetStatusCallback)
void GetStatusCallback(KinException ex, AccountStatus status)
{
if (status == AccountStatus.Created)
{
}
else
{
}
}
要在测试区块链上注册帐户并为其提供资金，您有3种选择：
选项1：您可以通过将地址粘贴到Kin's friend-bot service上来手动执行此操作。这将自动为您注册该帐户。
选项2：您可以将您的代码作为http请求通过代码调用友好机器人
https://friendbot-testnet.kininfrastructure.com/?addr=address_here
public static IEnumerator FundAccount( string publicAddress, Action<bool> onComplete = null )
{
var url = "http://friendbot-testnet.kininfrastructure.com/?addr=" + publicAddress;
var req = UnityWebRequest.Get( url );
yield return req.SendWebRequest();
if( req.isNetworkError || req.isHttpError )
{
Debug.Log( req.error );
if( onComplete != null )
onComplete( false );
}
else
{
Debug.Log( "response code: " + req.responseCode );
Debug.Log( req.downloadHandler.text );
if( onComplete != null )
onComplete( true );
}
}
选项3：您可以使用服务器端代码自己提供资金（在生产环境中必须这样做）。基本上，您的客户将需要致电您的服务器并要求加入。然后，您的服务器可以使用Kin的python SDK或node SDK来执行入职。
这是您可以用于服务器的便捷的python implementation或Node.js implementation。
从Unity调用实现很简单，如下所示：
public IEnumerator FundMe(decimal amount, Action<bool> fundCallback = null)
{
WWWForm form = new WWWForm();
form.AddField("address", kinAccount.GetPublicAddress());
form.AddField("amount", amount.ToString());
reqUrl = "http://address.to.your.server";
var req = UnityWebRequest.Post(reqUrl, form);
yield return req.SendWebRequest();
if (req.isNetworkError || req.isHttpError)
{
Debug.LogError(req.error);
fundCallback(false);
}
else
{
fundCallback(true);
}
}
注意：Kin有两个区块链。 Production和Test。测试区块链仅具有“运行货币”，您可以在不产生成本的情况下运行测试。生产区块链具有real world value Kin
调用其他功能
GetBalance（）
account.GetBalance(GetBalanceCallback);
void GetBalanceCallback(KinException ex, decimal balance)
{
if (ex == null)
{
Debug.Log( "Balance: " + balance );
}
else
{
Debug.LogError( "Get Balance Failed. " + ex );
}
}
删除帐户（）
kinClient.DeleteAccount(0);
注意：GetBalance（）需要回调，因为它正在与区块链在线通信。 DeleteAccount（）不会，因为它只是删除客户端上的私钥和公钥。一旦删除，这些密钥将无法恢复。
处理交易
事务具有以下参数：
备注：带有extra information的可选字符串。
地址：收件人的地址
金额：您发送的亲戚金额（不包括费用）
费用：您为交易支付的费用为processed by the blockchain。当前费用为100/100000 KIN。该费用可保护区块链免受垃圾邮件的侵害。
注意：费用以Kin的最小单位表示。 （夸克）。就像一美元的最小单位是一分。因此，在进行交易时，将费用设置为100（夸克）-100/100000 KIN。设置费用告诉区块链您明确同意支付交易费用。如果您将费用设置得太低，则交易将被拒绝。
您可以在以下位置查看Kin的区块链上的所有交易：
要发送付款，请先在本地构建交易：
kinAccount.BuildTransaction(address, amount, fee, memo, BuildTransactionCallBack);
建立交易会在客户端执行https://laboratory.kin.org/index.html#explorer?resource=payments来授权并签名。建立交易后，使用以下回调将其发送到Kin的区块链。
void BuildTransactionCallBack(KinException ex, Transaction transaction)
{
if (ex == null)
{
kinAccount.SendTransaction(transaction, SendTransactionCallback);
}
else
{
Debug.LogError("Build Transaction Failed. " + ex);
}
}
将交易发送到Kin的区块链后，您可以监听响应，以确保交易正确进行。事务通常需要several operations才能完成。
void SendTransactionCallback(KinException ex, String transactionId)
{
if (ex == null)
{
//Success
}
else
{
Debug.LogError("Send Transaction Failed. " + ex);
}
}
注意：您应将less than 10 seconds用于需要等待的功能。这可以防止您的代码在等待响应时挂起，并可以提供更好的用户体验。
以零费用发送交易
您可以被Kin基金会列入白名单，以零费用发送交易。要列入白名单，只需在co-routines中注册。获得批准后，您可以执行额外的步骤，让您的客户以零费用发送交易。
在构建交易后发送零费用交易：
客户需要联系您列入白名单的服务器。
您的服务器将批准/签署交易，并将其发送回客户端。
然后，客户将把这笔批准的交易发送到Kin的区块链上，并免费进行处理。
我们已经建立了交易，现在我们将其列入白名单
void BuildTransactionCallBack(KinException ex, Transaction transaction)
{
if (ex == null)
{
StartCoroutine(WhitelistTransaction(transaction, WhitelistTransactionCallback))
}
else
{
Debug.LogError("Build Transaction Failed. " + ex);
}
}
我们正在呼叫列入白名单的服务器以授权交易
IEnumerator WhitelistTransaction(Transaction transaction, Action<string, string> onComplete)
{
var postDataObj = new WhitelistPostData(transaction);
var postData = JsonUtility.ToJson(postDataObj);
var rawPostData = Encoding.UTF8.GetBytes(postData);
// UnityWebRequest does not work correclty when posting a JSON string so we use a byte[] and a hacky workaround
var req = UnityWebRequest.Post(baseURL + whitelistURL, "POST");
req.SetRequestHeader("Content-Type", "application/json");
req.uploadHandler = new UploadHandlerRaw(rawPostData);
yield return req.SendWebRequest();
if (req.isNetworkError || req.isHttpError)
{
Debug.LogError(req.error);
onComplete(null, null);
}
else
{
onComplete(req.downloadHandler.text, transaction.Id);
}
}
我们的服务器已批准交易，并发送回签名字符串。现在，我们将此签名的字符串发送到Kin的区块链
void WhitelistTransactionCallback(string whitelistTransaction, string transactionId)
{
if (whitelistTransaction != null)
{
kinAccount.SendWhitelistTransaction(transactionId, whitelistTransaction, SendTransactionCallback);
}
else
{
Debug.LogError("Whitelisting Transaction Failed. ");
}
}
和往常一样，我们等待交易是否成功
void SendTransactionCallback(KinException ex, String transactionId)
{
if (ex == null)
{
//Success
}
else
{
Debug.LogError("Send Transaction Failed. " + ex);
}
}
在服务器被批准列入白名单之前，您可以在TEST环境中使用此预先批准的服务器。 Kin Developer Program。
public static IEnumerator WhitelistTransaction( Transaction transaction, Action<string> onComplete = null )
{
var postDataObj = new WhitelistPostData( transaction );
var postData = JsonUtility.ToJson( postDataObj );
var rawPostData = Encoding.UTF8.GetBytes( postData );
// UnityWebRequest does not work correclty when posting a JSON string so we use a byte[] and a hacky workaround
var url = "http://34.239.111.38:3000/whitelist";
var req = UnityWebRequest.Post( url, "POST" );
req.SetRequestHeader( "Content-Type", "application/json" );
req.uploadHandler = new UploadHandlerRaw( rawPostData );
yield return req.SendWebRequest();
if( req.isNetworkError || req.isHttpError )
{
Debug.Log( req.error );
if( onComplete != null )
onComplete( null );
}
else
{
Debug.Log( "response code: " + req.responseCode );
Debug.Log( req.downloadHandler.text );
if( onComplete != null )
onComplete( req.downloadHandler.text );
}
}
批准后，您可以使用示例http://34.239.111.38:3000/whitelist或python implementation批准服务器上的事务。您也可以使用node.js SDK。
聆听区块链上的事件
您可以添加侦听器，以防止您的客户端过度查询区块链。只需添加以下代码
kinAccount.AddPaymentListener(this);
kinAccount.AddBalanceListener(this);
public void OnEvent(PaymentInfo data)
{
//Listening for incoming and outgoing payments
}
public void OnEvent(decimal balance)
{
//Listening for changes in client's balance
}
全部放在一起
您可以在MIT许可证下的Node.js implementation上找到实现的代码。
开发者手册
您也可以检查https://github.com/hitwill/kin-sdk-unity-tutorial-有关使用Kin创建的一些高级概念。
最佳实践
用户体验
（占位符）
服务器端安全
这是服务器端安全性上的Developer Playbook。
客户端安全
（占位符）
减少对区块链的呼叫
（占位符）
关于unity3d - 如何在Unity应用中设置和使用Kin区块链-逐步，我们在Stack Overflow上找到一个类似的问题：https://stackoverflow.com/questions/56096526/