Kii Cloud For Unity 介紹

官方網站的快速導覽
http://documentation.kii.com/cn/starts/

Kii Cloud 主要提供以下四種平台Kii SDK

1. Android
2. iOS
3. JavaScript
4. Unity

以Unity為例，需要下載兩個SDK即可享受強大的服務

1. UNITY Kii Analytics SDK
2. Unity Kii Cloud Storage SDK

解壓縮後，要把以下3個檔案放在Unity專案的根目錄下

1. JsonOrg.dll
2. KiiCloudStorageSDK.dll
3. KiiAnalyticsSDK.dll

之後就可以在Kii官網，點選Creat App，創造自己的App，
過程中可以選擇Server Location、還有所支援發布的平台，
最重要的是會得到一組Access Key，如下圖所示:




簡單來說，一個會員帳號可以建立多個App，每個App都會有專屬的ACCESS KEY

其中App ID以及App Key將會用在你的Unity專案之中，
讓Unity辨別是哪個App，才能連線到雲端資料庫。

接下來就要介紹Kii Cloud的主功能 

1. Managing Users (使用者管理)

Sign Up (註冊)
方案(1): 採用user+password
方案(2): phone或者email，還能搭配內建驗證功能(防止機器人)。

KiiUser.Builder builder;
builder = KiiUser.BuilderWithName("user_123456");
builder.WithEmail("user_123456@example.com");
builder.WithPhone("+819012345678");

KiiUser user = builder.Build();
user.Register("123ABC", (KiiUser registeredUser, Exception e) => {
  if (e != null)
  {
    // handle error
    return;
  }
});

Sign In (登入)
一樣可採user/password、email、phone三種方式做登入。

string username = "user_123456";
string password = "123ABC";

KiiUser.LogIn(username, password, (KiiUser user, Exception e) => {
  if (e != null)
  {
    // handle error
    return;
  }
});

string phoneNumber = "09051903944";
string country = "JP";
string password = "123456";

KiiUser.LogInWithLocalPhone(phoneNumber, password, country, (KiiUser user, Exception e) => {
  if (e != null)
  {
    // handle error
    return;
  }
});
  

KiiUser.LogIn("username", "password", (KiiUser user, Exception e) => {
  if (e != null)
  {
    // handle error
    return;
  }
  string accessToken = KiiUser.AccessToken;
  // Securely store the access token in persistent storage.
  // (assuming that your application implements this function)
  StoreToken(accessToken);
});

// Get the access token from persistent storage.
// (assuming that your application implements this function)
string storedAccessToken = GetStoredToken();

// Use the access token to sign-in again
KiiUser.LoginWithToken(storedAccessToken, (KiiUser user, Exception e) => {
  if (e != null)
  {
    // handle error
    return;
  }
});

Token可幫助使用者登入後，在其他分頁靠此令牌即可辨識身分，而不用每次都重新登入。

Passwords (密碼)
提供忘記密碼時，重新將密碼寄到認證過的Email。

string username = "user_123456";
string password = "123ABC";
KiiUser.LogIn(username, password, (KiiUser user, Exception e) => {
  if (e != null)
  {
    // handle error
    return;
  }
  KiiUser.ChangePassword("newpassword", password, (Exception e2) => {
    if (e2 != null)
    {
      // handle error
      return;
    }
  });
});

string username = "user_123456";
string email = "user_123456@example.com";
string password = "123ABC";
KiiUser user = KiiUser.BuilderWithName(username).WithEmail(email).Build();
user.Register(password, (KiiUser registeredUser, Exception e) => {
  if (e != null)
  {
    // handle error
    return;
  }
  KiiUser.ResetPassword(email, (Exception e2) => {
    if (e2 != null)
    {
      // handle error
      return;
    }
  });
});

Handle users attributes (處理使用者屬性)
提供user預設屬性
(1) Username
(2) Email address
(3) Phone number
(4) Display name
(5) Country

也提供客製化屬性 => 分數、關節資訊、所屬治療師

string username = "user_123456";
string password = "123ABC";
KiiUser user = KiiUser.LogIn(username, password);
user["age"] = 20;
user["gender"] = "male";
user["height"] = 170.5;
user["isMember"] = true;
user.Update();

int age = (int)user["age"];
string gender = (string)user["gender"];
double height = (double)user["height"];
bool isMember = (bool)user["isMember"];

Deleting Users (刪除使用者)

string username = "user_123456";
string password = "123ABC";
KiiUser user = KiiUser.LogIn(username, password);
user.Delete();

Retrieving Data from other Users (獲取其他使用者的資料)
需先到Kii的App管理畫面，點選Edit/Setting/User Managemet，
將Expose Full User Data To Others打勾，才能使用以下Code。

再透過user/password、phone、email，就可獲取其他用戶的資訊

string username = "user_123456";
KiiUser found = KiiUser.FindUserByUserName(username);
string emailAddress = "user_123456@example.com";
KiiUser found = KiiUser.FindUserByEmail(emailAddress);
string phoneNumber = "+819012345678";
KiiUser found = KiiUser.FindUserByPhone(phoneNumber);

User Browsing (瀏覽使用者)
Kii Cloud網站中的瀏覽使用者視窗提供以下服務
(1) 查詢使用者清單
(2) 新增使用者
(3) 編輯現存使用者的屬性
(4) 刪除使用者

在Kii Cloud管理視窗，Users/Console/點選一個使用者/Custom Attributes/Code
提供使用者對object自行增加Json格式的額外欄位屬性，如下圖所示:

Json格式參考網址http://www.jsoneditoronline.org/


2. Managing Groups (群組管理)



3. Managing Data (資料管理)