Unity3D资源接入SDK
1.介绍
这个插件包基于2019.4.22f1c1版本。主要封装了对虚拟实验平台的两个数据通讯接口,可以被发布于WIN和WebGL平台。
2. 代码说明
包内有一个VRBoxJoin_Manager.cs脚本和VRBoxJoin预制体。 在使用接口调用的场景中,把VRBoxJoin预制体拖入场景。
在VRBoxJoin面板下挂载着VRBoxJoin_Manager.cs,上面有着接口调用必要的代码逻辑。
VRBoxJoin_Manager是一个单例类,外部通过引入VRBoxJoin命名空间可以直接调用VRBoxJoin_Manager的实例,调用时使用VRBoxjoin_Manager.Instance。
3. 准备参数
必要参数可以直接调用Instance赋予,单例类中提供了参数的getset。
平台不同,参数传递也有区别.
WebGL平台
uniqid,ticket:参数值会被封装到网页地址中,通过在JS脚本中截取地址字段信息。
然后再用Unity发布后的产生的index.html脚本中的unityInstance调用SendMessage()传入Unity程序中。在Unity引擎将取到的值set给VRBoxJoin_Manager实例中对应名字的参数即可。
PC平台
uniqid,ticket--VRBoxJoin_Manager会在启动时获取应用程序的CommandLine信息,开发者通过命令行输入指定格式的参数即可,下面列举一例。可对发布出的Unity应用程序创建快捷方式,在属性面板中的目标中并按照格式传入指定字段,如:D:\VRBoxDemo\VRBoxDemo.exe --ticket=ecefad38db36c97ea24a063e3ec383dc --uniqid=u6242e01186c9e
4.获取身份信息
VRBoxJoin_Manager类中提供了两个函数供开发者调用。RequestGetAccess(Action'<'string'>' response)。这个函数需要开发者在必要参数都赋予完成后才能顺利调用。 回调函数内的字符串为含有access_token的用户身份信息Json字段,参数结构参考“用户验证接口文档”。RequestAccess(string secret,string appid, string ticket, Action"<"string">" response)与上面函数没有逻辑上区别,仅为方便开发者调用。
5.上传实验数据
VRBoxJoin_Manager类中提供了一个函数供开发者调用。UploadEmpiricalData(string accessToken, string parameter, Action"<"string">" response)这个函数需要开发者将用户身份信息中的access_token字段传入,并且在parameter中传入自己的实验数据Json。同时在response中会返回消息体Json。