关于如何在Unity的空项目中使用Kin Unity SDK的逐步说明，是什么很好的解释？
答案 0 :(得分：3)
在this sample code中使用包装器，并按以下方式调用：
kinWrapper.SendPayment(1.00M, "test send", address);
kinWrapper.Balance();
//etc
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;
client 根据所使用的平台处理本机代码。 （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来执行入门。
Here is a handy python 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
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的区块链上的所有交易：https://laboratory.kin.org/index.html#explorer?resource=payments
要发送付款，请先在本地构建交易：
kinAccount.BuildTransaction(address, amount, fee, memo, BuildTransactionCallBack);
建立交易会在客户端执行several operations来授权并签名。交易建立后，使用以下回调将其发送到Kin的区块链。
void BuildTransactionCallBack(KinException ex, Transaction transaction)
{
if (ex == null)
{
kinAccount.SendTransaction(transaction, SendTransactionCallback);
}
else
{
Debug.LogError("Build Transaction Failed. " + ex);
}
}
将交易发送到Kin的区块链后，您可以监听响应，以确保交易正确进行。交易通常需要less than 10 seconds来完成。
void SendTransactionCallback(KinException ex, String transactionId)
{
if (ex == null)
{
//Success
}
else
{
Debug.LogError("Send Transaction Failed. " + ex);
}
}
注意：：对于需要等待的功能，应使用co-routines。这样可以防止您的代码在等待响应时挂起，并可以提供更好的用户体验。
您可以通过Kin基金会列入白名单，以零费用发送交易。要列入白名单，只需向Kin Developer Program注册即可。获得批准后，您可以执行额外的步骤，让客户以零费用发送交易。
在构建交易后发送零费用交易：
客户端将需要与您列入白名单的服务器联系。
您的服务器将批准/签署交易，并将其发送回客户端。
然后，客户会将批准的交易发送到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环境中使用此预先批准的服务器。 http://34.239.111.38:3000/whitelist。
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 );
}
}
批准后，您可以使用sample 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许可下找到在https://github.com/hitwill/kin-sdk-unity-tutorial上实现的代码。
您也可以选中此Developer Playbook-有关使用Kin创建的一些高级概念。
（占位符）
（占位符）
（占位符）
（占位符）