Sview集成说明
概述
SView for HTML5 控件提供三维模型基本的浏览、基本三维对象操作、动画播放、颜色设置等功能的实现接口，可实现基本的三维模型展示功能，以便于用户个性化定制属于自己的产品。
集成准备
集成之前需要熟悉javascript、HTML语言及常用网页代码编辑软件，以便快速准确的集成相关功能界面。
若集成服务为IIS服务，则需添加部分MIME类型：
1、若控件包中含有web.config文件，那么编辑它，查看是否含有类型为".lic"和".svlx"的"mimeMap"标签，若有则跳过第二步；
2、找到IIS服务管理，添加MIME类型，".lic"与".svlx",MIME类型设置为"application/octet-stream"。
注意: SView for HTML5控件包请勿存放在含有中文的目录下。
详细集成准备如下所示:
集成环境
SView for HTML5 开发库集成需要的环境：
- 开发环境：常用前端代码编辑器
- 系统环境: macOS、Linux、windows
- 运行环境: html5的浏览器推荐使用最新版Chrome浏览器，并且电脑配置以及浏览器支持WebGL
集成说明
请按照下面步骤进行集成，也可参考H5控件包中demo1.html。
具体步骤
- 首先将demo中images、js、css、data、lang、lic、res、textures文件夹放入项目中指定位置。
- 在项目网页中引入css、js文件
<link href="css/bootstrap.css" rel="stylesheet" media="screen" >
<link href="css/common.css" rel="stylesheet">
<link href="css/zTreeStyle/zTreeStyle.css" rel="stylesheet" type="text/css">
<link href="css/meeting/grouppanel.css" rel="stylesheet">
<script src="js/Detector.js"></script>
<script src="js/CryptoJS.min.js"></script>
<script src="js/jquery-3.1.0.min.js" type="text/javascript"></script>
<script src="js/jquery.easyui.min.js" type="text/javascript"></script>
<script src="js/TweenMax.min.js" type="text/javascript"></script>
<script src="js/clipboard.min.js" type="text/javascript"></script>
<script src="js/sview/sview.min.js"></script>
<script src="js/bootstrap.min.js" type="text/javascript"></script>
<script src="js/fingerprint2.js" type="text/javascript"></script>
<link href="css/sweetalert/alert.css" rel="stylesheet" type="text/css">
<link href="css/sweetalert/theme.css" rel="stylesheet" type="text/css">
<script src="js/sweetalert/alert.js" type="text/javascript"></script>
<script src="js/bootstrap-contextmenu.js"></script>//右键菜单
<script src="js/zTree/jquery.ztree.core-3.5.js"></script>
<script src="js/zTree/jquery.ztree.excheck-3.5.js"></script>
<script src="js/zTree/jquery.ztree.exedit-3.5.js"></script>
<script src="js/jszip/jszip.min.js"></script>
<script src="js/jszip/jszip-utils.min.js"></script>
<script src="js/html2canvas.js"></script>
<script src="js/nipplejs.min.js"></script>
<script src="js/colpick.js"></script>
<link href="css/colpick.css" rel="stylesheet" type="text/css">
<link href="images/logo.png" rel="shortcut icon" type="text/x-icon">
<script src="js/bootstrap-slider.js" type="text/javascript"></script>
<link href="css/bootstrap-slider.css" rel="stylesheet" type="text/css">
<link href="css/loading-style.css" rel="stylesheet" type="text/css">
<link href="css/sweetalert/sweetalert.css" rel="stylesheet" type="text/css">
<script src="js/sweetalert/sweetalert.js" type="text/javascript"></script>
<script src="js/im/tim-js.js" type="text/javascript"></script>
<script src="js/im/cos-js-sdk-v5.min.js" type="text/javascript"></script>
<script src="js/im/trtc.js" type="text/javascript"></script>
- 在文档就绪函数中执行sview默认对象的初始化，如下代码所示：
if (!Detector.webgl) {
Detector.addGetWebGLMessage();
}
var sview0 = null;
$(function() {
//将H5集成在其他服务器时需配置基础路径，该路径指向H5控件包
sviewBaseUrl = "/h5/";
var option = {
isOpenCrot: false,
animationStatus: true,
usem2: false, //为了限制右键菜单混乱而使用的标志符
isOpenJoystick: false,
walkingMode: false,
usePMI: true,
pmiServer: "http://service.sv3d.cn/service/system",
decryptoFile: false, // 配置加密文件密钥
};
//第一个参数为可视化浏览所需的div标签的id
//第二个参数为定义的参数变量
sview0 = initSView("sview0",option);
//initSView之后需将基础路径设置到sview中
sview0.SetSViewBaseUrl(sviewBaseUrl);
//若不需开启在线视图等在线功能，则不需要配置
sview0.setParameter("ServerViewUrl", "http://service.sv3d.cn");
//若不需开启在线视图等在线功能，则不需要配置
sview0.setParameter("SViewAPIUrl", "http://service.sv3d.cn");
//协同会议服务器地址，若不使用协同会议功能，则不需要配置
//协同会议功能集成需要用到文档服务以及协同会议服务
sview0.setParameter("timServerUrl", "http://service.sv3d.cn");
//若不需开启在线视图等在线功能，则不需要配置
sview0.setParameter("userId", "123");
//未开启在线视图等在线功能时，该值可设置为空字符串
sview0.setParameter("fileId", "5e06569b-2b1f-4d5d-bd2f-ccdce4c6d536");
sview0.setParameter("user", "游客");
sview0.setParameter("userFileId", "");
sview0.setParameter("uniqueId", "123");
try {
//打开多个文件
//参数1多个svlx文件路径的集合。
//中文时需增加服务端utf-8路径配置。
//var ret = sview0.open(["models/24-09-01.u3d.svlx","models/24-09-01.u3d.svlx"]);
//若开启多线程下载配置，则打开路径需传递绝对路径，例如打开mongoose服务后ip地址+端口号为http://127.0.0.1:8080,模型存放路径为控件包中models文件夹，则打开路径需修改为：
//var ret = sview0.open(["http://127.0.0.1:8080/models/24-09-01.u3d.svlx","http://127.0.0.1:8080/models/24-09-01.u3d.svlx"]);
//打开一个svlx文件
//参数1 svlx文件路径。
//参数2 svlx文件是否是本地文件
//中文时需增加服务端utf-8路径配置。
//var ret = sview0.open("models/24-09-01.u3d.svlx",true);
//若打开分散文件并开启多线程下载配置时，需将打开路径设置为绝对路径，例如打开mongoose服务后ip地址+端口号为http://127.0.0.1:8080,模型存放路径为控件包中models文件夹，则打开路径需修改为：
//var ret = sview0.open("http://127.0.0.1:8080/models/24-09-01.u3d.svlx",true);
//打开多个svlx文件,并有模型对应的唯一标识
//参数1 svlx文件路径集合。
//参数2 模型对应的唯一标识的集合,与路径一一对应
//中文时需增加服务端utf-8路径配置。
//var ret = sview0.open(["models/24-09-01.u3d.svlx","models/24-09-01.u3d.svlx"],["uuid1","uuid2"]);
//若开启多线程下载配置，则打开路径需传递绝对路径，例如打开mongoose服务后ip地址+端口号为http://127.0.0.1:8080,模型存放路径为控件包中models文件夹，则打开路径需修改为：
//var ret = sview0.open(["http://127.0.0.1:8080/models/24-09-01.u3d.svlx","http://127.0.0.1:8080/models/24-09-01.u3d.svlx"],["uuid1","uuid2"]);
//打开一个或多个本地jsvl或者obj文件
//参数1 jsvl或者obj模型路径,数组格式。
//参数2 顶级模型名称
//参数3 压缩包内模型格式
//中文时需增加服务端utf-8路径配置,jsvl或者obj格式需要添加至压缩包内进行打开多个模型需添加至多个压缩包内。
//var ret = sview0.open(["models/24-09-01.u3d.zip","models/24-09-01.u3d.zip"],"topAssemblyName","obj/jsvl");
//打开一个jsvl或者obj文件
//参数1 jsvl或者obj模型路径。
//参数2 是否是本地文件
//参数3 压缩包内的文件名,可能与压缩包名称不一致
//参数4 压缩包内文件格式
//中文时需增加服务端utf-8路径配置,jsvl或者obj格式需要添加至压缩包内进行打开。
//var ret = sview0.open("models/24-09-01.u3d.zip",true,"24-09-01.u3d","obj/jsvl");
if(!(ret==""||ret==undefined))
{
alert(ret);
}
} catch (e) {
alert("无法正常打开，请检查原始模型是否正确或联系客服人员！");
$("#jdzw").css("width", "100%");
$("#jdz").html("无法正常打开，请检查原始模型是否正确或联系客服人员！");
}
});
- 若内网环境，需对控件包中js/sview/loadFile.js进行编辑，将parseHTML方法中设置fileId部分屏蔽，如下代码所示：
//if(a.innerHTML==="children's bed.svlx"){
//fileJSON["fileId"] = "4b9861c4-2e4b-4abe-b5cf-11b82bf744f5";
//}else if(a.innerHTML==="flight engine.svlx"){
//fileJSON["fileId"] = "e48952d2-f0d1-422d-8ed2-b7e9aba94913";
//}else if(a.innerHTML==="girl.svlx"){
//fileJSON["fileId"] = "c52ec143-b34c-4001-8be8-91ebc5833135";
//}else if(a.innerHTML==="jian-10.svlx"){
//fileJSON["fileId"] = "22dd4184-e2aa-498b-b854-d752cbf13343";
//}else if(a.innerHTML==="reducer.svlx"){
//fileJSON["fileId"] = "71390e7d-916e-4a04-ad25-c0ac059e2e90";
//}else if(a.innerHTML==="ring.svlx"){
//fileJSON["fileId"] = "d440f14e-821b-4e65-ab4a-1f349d9bd124";
//}else if(a.innerHTML==="workshop.svlx"){
//fileJSON["fileId"] = "fce0f9c8-9a18-4c0a-bd9e-515378b0afa7";
//}else{
fileJSON["fileId"] = "";
//}
- 若打开分散文件，需将所有分散文件存放在同一目录下，打开主装配件即可，同时打开分散文件或者多文件打开时，需将模型选择界面代码(index.html)做一下调整，将请求文件夹时路径修改为绝对路径，如下代码所示：
$(document).ready(function () {
filePathList.push({"path":"./models/","name":"models"});
//需修改为绝对路径，例如打开mongoose服务后ip地址+端口号为http://127.0.0.1:8080,则修改为
//filePathList.push({"path":"http://127.0.0.1:8080/models/","name":"models"});
requestFloder("./models/");
//需修改为绝对路径，例如打开mongoose服务后ip地址+端口号为http://127.0.0.1:8080,则修改为
//requestFloder("http://127.0.0.1:8080/models/");
if (window.ActiveXObject || "ActiveXObject" in window) {
$("#upload").removeClass("hide");
} else {
$("#upload").removeClass("hide");
}
});
- 根据api文档中接口所示，用js或jquery进行所需功能的调用即可。
Demo使用说明
- 找到mongoose-free-6.5.exe，运行此软件，开启web测试服务，并在谷歌浏览器访问服务地址。
- 点击模型名称，进入模型预览页面。
- 打开其他模型：
将模型复制到H5包中models文件夹，刷新web测试服务页；
点击模型名称，进入模型预览页面。 - iframe标签嵌套使用说明，在web测试服务页面地址栏原地址后添加"/iframe_used.html",回车进入iframe_used.html。
本文来自博客园，作者：zwbsoft，转载请注明原文链接：https://www.cnblogs.com/zwbsoft/p/16275750.html
电话微信：13514280351
