2017年7月17日以前移植您的View and Data 工程

熟悉Autodesk Forge的朋友可能知道Autodesk 两年前有个名为View and Data的技术，即网页模型浏览和业务拓展。使用中须要进行身份认证（获取token），上传模型，转换成网页浏览格式。以及Viewer的JavaScript包对网页格式进行渲染和加载，拓展。这几步其实后端用到几个云服务端口，形如：

• POST https://developer. api.autodesk.com/authentication/v1/authenticate

• POST https://developer. api.autodesk.com/oss/v1/buckets/

• POST https://developer. api.autodesk.com/oss/v1/buckets/:bucketKey/objects/:objectName

• POST https://developer. api.autodesk.com/viewingservice/v1/register/

在去年6月Forge 大会以后，前面的几个服务的功能已变成Forge独立的服务中的一部分：

• 身份认证（authentication）

• 数据管理（Data Management）

• 数据提取和格式转换（Model Derivitives）

例如上面的几个端口新版为：

• POST https://developer. api.autodesk.com/authentication/v1/authenticate

• POST https://developer. api.autodesk.com/oss/v2/buckets/

• POST https://developer. api.autodesk.com/oss/v2/buckets/:bucketKey/objects/:objectName

• POST https://developer.api.autodes...

能够看到数据管理和模型提取服务版本定为v2，因此常常称做v2转换过程。v2不仅是端口名字的变化，而是开发者能够单独的调用，获取对应的数据。固然，每种服务体系中的端口也更加丰富，例如身份认证（authentication）能够进行受权认证的过程，让开发者能够访问到最终客户在Autodesk 云产品上的数据存储。数据管理中，能够对原始模型进行获取，删除，转换后的模型删除，而也提供Autodesk 云产品例如Autodesk 360 的Project，Folder，Item等操做。至于数据提取，也可提取出模型的层次结构和对象属性列表等。并且v2的转换服务能够支持转换出更多格式，例如OBJ，STL，IFC，FBX等等。不只这些，v2的基础安全机构更加的完善和强壮。

同时，网页浏览和业务拓展的JavaScript库也不断升级更新，虽然其版本号体系和后端的Forge云服务不一样。而JavaScript也对v2的转换过程产生的数据进行对应的兼容工做，不断提升性能和功能。

从去年6月到如今，v1和v2是并存的状态，客户均可以用，但实际上v1更多处于维护的状态。随着绝大多数客户已经稳定的使用v2，Autodesk Forge团队决定，从今年7月17日起，中止v1的服务。也就是说前面提到的那些云服务端口将终止。而很老的JavaScript库可能也会没法访问。

有些朋友的工程是基于某个时期的样例写的，更多关注前端的应用，然后端可能仍旧用的v1端口。因此，特此通知，务必尽快移植相关工程到v2过程。移植须要作的工做很少：

1. 按帮助文档，用v2的端口替换之前的端口

2. 根据v2的参数说明，调整request和response的细节。例若有些端口的response的json结构变化了

3. 身份认证获取token，务必提供参数scope

4. 连接到较新的Forge Viewer JavaScript库。不指定版本目前默认是2.10. 指定版本，如今最高能够到2.14

5. 调试工程，排查错误

能够直接参考Forge相关的样例调整, 例如，如下博客提到的样例：
https://segmentfault.com/a/11...

如在移植过程当中遇到任何问题，请联系Autodesk Forge支持团队。