# DEMO示例

说明
由于云渲染服务需要与具体产品业务场景集成对接后,才能完整展示一个端到端的服务全过程。而与产品集成对接,需要双方进行协商和约定相关技术规范(重点是模型场景导出格式规范),然后在云渲染客户端和服务端进行一定程度的定制开发,才能使产品正常接入云渲染服务。所以现阶段,可以认为云渲染服务还没有达到由接入方完全自助完成云渲染服务集成的成熟度。

以下以BIMDeco产品成功对接云渲染服务为示例,展示产品与效果图渲染业务对接的过程。需要注意的是,该过程中产品在客户端上按双方约定的技术规范导出模型场景文件的过程,目前还不具备通用性(需要双方协商确定),因此我们从模型场景文件导出完成开始演示,这并不影响演示业务数据如何上云、渲染过程中的业务管理、渲染结果下载等核心步骤和整体流程。

体验前准备

确认有广联达用户中心注册的账号,如果没有,请前往广联达用户中心(https://account.glodon.com/login),注册一个新账号。

体验流程

step1:准备本地模拟环境
1、下载从产品中导出的模型场景文件(实际开发中,该模型场景文件由业务产品按协议导出),把文件名改为CRFiles.zip点击获取模型场景文件
2、下载云渲染客户端命令行工具,用于执行文件上传云渲染服务端;点击获取本地模拟工具
3、解压客户端命令行工具到任意的本地目录,并把模型场景文件CRFiles.zip拷贝到该命令行工具所在目录下,本地运行环境准备完成最终如下图所示。

step2:上传模型场景文件

请注意

在实际产品集成时,场景上传过程由业务产品通过交互界面操作触发,所有命令参数由产品设置和导出,不会出现本步骤中的命令行画面。

1、获得用户Token,作为访问API的用户凭证。

  • 通过调用广联达用户中心的API获得用户token,具体方法参见:广联达用户中心-获取AccessToken
  • 使用任意在线BASE64工具对用户的AppKey:AppSecret进行编码。
  • 使用API测试工具(如Talend API Tester)调用广联达用户中心API获得用户Token,结果如下图:

2、准备命令行内容。

  • 具体命令行内容参考以下字符串,建议在文本编辑器中编辑相关命令行内容 。
  • 注意命令行中的用户Token值:cn-XXXXX-XXXX-XXXX-XXXX-XXXXXX,使用上述步骤中获得的用户Token进行置换;
  • 命令行中的一些属性参数值为经验值,在实际产品中可通过交互界面调节。
UploadScene.exe -f CRFiles.zip -t cn-XXXXX-XXXX-XXXX-XXXX-XXXXXX -threadnum 32 -priority 1 -config -projectname=IMG_005-11-海景大堂;-format=1;-quality=1;-type=1;-background=3;-hasbackground=1;-weather=1;-time=15.832956;-autofillinglight=0;sunlightness=3.875;moonlightness=0.1;skylightness=0.3;shadowdistance=122562.5;shadowbias=0.5;shadowsharpen=4;whitebalance=7200.0;globalgain=1.225;bloomintensity=0.5;bloomthreshold=-0.5;lpvintensity=1.0;lpvdistance=6000.0;screenspacereflection=100.0;ambientocculusion=0.8;auxiliarylight=1.0
1

3、运行系统cmd,打开windows命令行界面,进入云渲染客户端所在目录。(必须在云渲染客户端目录运行命令行)

4、在Windows命令行界面输入上述命令,如下图所示。

5、回车执行命令,触发本地模型场景文件上传云端,会出现如下图所示的文件上传过程。

6、等待直至文件上传结束,命令行程序自动退出,如下图所示。

7、至此,模型场景文件已成功上传云端,接下来云端会自动完成任务调度,执行提交的渲染任务,完成渲染后通知用户。

step3:查看渲染进度

注意

实时查看渲染任务后台进度,不是云渲染核心流程中的必要步骤。因此我们暂时不针对demo用户,提供可视化页面查看任务。下图展示的是BIMDECO产品渲染任务管理页面,是业务产品基于云渲染服务API和自身业务需要,开发的前端页面。当业务产品集成云渲染时,可根据实际需要定制化开发相关页面风格和功能。

BIMDECO产品的渲染任务管理页面如下图所示。

step4:渲染完成后下载结果

1、方式1:渲染完成后,云渲染服务会通过邮件或者短信及时通知用户。用户收到通知后,使用邮件或者短信内容中包含的下载地址,进行结果下载,如下图所示。(本次渲染任务大概15分钟后会收到渲染完成的邮件通知)

2、方式2:如果实现了任务管理前端页面,可在页面上实时展示任务状态和下载渲染结果,如下图所示。

3、下载的渲染结果为随机文件名的.zip格式文件,解压zip文件,提取出渲染结果图片,如下图所示。

  • 在线客服

  • 意见反馈