团队使用飞书进行项目管理,使用在线表格进行配置表的编写,而飞书也提供了在线表格操作的Api,这样我们可以直接在Unity中同步云端表格数据
首先需要进入飞书开发者后台创建应用https://open.feishu.cn/app

创建应用后记录AppId和AppSecret,在后面的api请求中会用到
在权限配置中选择需要获取的权限

然后需要发布自建应用

然后需要将自建应用添加到协作者中

Unity中使用了WebRequest获取飞书提供的api
这里我使用了RestClient库 的EditorCoroutines分支 ,支持编辑器协程
https://github.com/proyecto26/RestClient/tree/feature/editor-coroutines
拉取并导入到unity中(因为没有Release版需要自行处理拉取的文件)
首先获取token用于获取操作权限
请求Url为https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal
public string app_Id = "cli_xxxx";
public string app_secret = "qrwxxxxx";
public void GetTenantAccessToken(Action action=null)
{currentRequest = new RequestHelper{Uri = "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal",Params = new Dictionary{{nameof(app_Id), app_Id},{nameof(app_secret), app_secret}},EnableDebug = true,EditorCoroutine = true};RestClient.Post(currentRequest).Then(res =>{RestClient.ClearDefaultParams();JObject myJObject = (JObject) JsonConvert.DeserializeObject(res.Text);if (myJObject != null){tenant_access_token = myJObject["tenant_access_token"]?.ToString();action?.Invoke();}}).Catch(err => { Debug.Log(err.Message); });
}
https://open.feishu.cn/document/ukTMukTMukTM/uATMzUjLwEzM14CMxMTN/overview
需要获取表格的spreadsheetToken,sheetId 以及范围
请求url为 https://open.feishu.cn/open-apis/sheets/v2/spreadsheets/:spreadsheetToken/values/:range
例如我的云表格地址为https://fox-item.feishu.cn/sheets/shtcndxxxx?sheet=cdxxx
那么spreadsheetToken就是shtcndxxxx,sheetId 就是cdxxx
然后unity编写获取表格行列范围的代码
public void GetSheetTable(string spreadSheetToken, string sheetId, int row, int col, Action getSheet)
{var sheet = new string[row, col];currentRequest = new RequestHelper{Uri =$"https://open.feishu.cn/open-apis/sheets/v2/spreadsheets/{spreadSheetToken}/values/{sheetId}!A1:{(char) (col - 1 + 65)}{row}",Headers = new Dictionary(){{"Authorization", $"Bearer {tenant_access_token}"},},EnableDebug = true,EditorCoroutine = true};RestClient.Get(currentRequest).Then(res =>{RestClient.ClearDefaultParams();JObject myJObject = (JObject) JsonConvert.DeserializeObject(res.Text);if (myJObject != null){var values = myJObject["data"]?["valueRange"]?["values"];if (values != null){//遍历每行for (int i = 0; i < values.Count(); i++){//遍历每列for (int j = 0; j < values[i]!.Count(); j++){sheet[i, j] = values[i][j]?.ToString();}}}}getSheet?.Invoke(sheet);}).Catch(err =>{Debug.Log(err.Message);});
}
该片段返回一个二维数组,对应的是表格从1行A列到某行列的数据,可以根据需要对该数据进行解析